import { Stream } from 'stream'; import { CreateTeamMembershipProps } from './entities/team-membership'; import { CreateTeamProps } from './entities/team'; import { CreateOrganizationInvitationProps } from './entities/organization-invitation'; import { MakeRequest, QueryOptions } from './common-types'; import { CreateAppDefinitionProps } from './entities/app-definition'; import { CreateAppSigningSecretProps } from './entities/app-signing-secret'; import { CreateAppDetailsProps } from './entities/app-details'; /** * @private */ export declare type ContentfulOrganizationAPI = ReturnType; /** * Creates API object with methods to access the Organization API * @param {MakeRequest} makeRequest - function to make requests via an adapter * @return {ContentfulOrganizationAPI} * @private */ export default function createOrganizationApi(makeRequest: MakeRequest): { /** * Gets a User * @return Promise for a User * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('') * .then((organization) => organization.getUser('id')) * .then((user) => console.log(user)) * .catch(console.error) * ``` */ getUser(id: string): Promise; /** * Gets a collection of Users in organization * @param query - Object with search parameters. Check the JS SDK tutorial and the REST API reference for more details. * @return Promise a collection of Users in organization * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('') * .then((organization) => organization.getUsers()) * .then((user) => console.log(user)) * .catch(console.error) * ``` */ getUsers(query?: QueryOptions): Promise>; /** * Gets an Organization Membership * @param id - Organization Membership ID * @return Promise for an Organization Membership * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('organization_id') * .then((organization) => organization.getOrganizationMembership('organizationMembership_id')) * .then((organizationMembership) => console.log(organizationMembership)) * .catch(console.error) * ``` */ getOrganizationMembership(id: string): Promise; /** * Gets a collection of Organization Memberships * @param query - Object with search parameters. Check the JS SDK tutorial and the REST API reference for more details. * @return Promise for a collection of Organization Memberships * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('organization_id') * .then((organization) => organization.getOrganizationMemberships({'limit': 100})) // you can add more queries as 'key': 'value' * .then((response) => console.log(response.items)) * .catch(console.error) * ``` */ getOrganizationMemberships(query?: QueryOptions): Promise>; /** * Creates a Team * @param data representation of the Team to be created * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('') * .then((org) => org.createTeam({ * name: 'new team', * description: 'new team description' * })) * .then((team) => console.log(team)) * .catch(console.error) * ``` */ createTeam(data: CreateTeamProps): Promise; /** * Gets an Team * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('orgId') * .then((organization) => organization.getTeam('teamId')) * .then((team) => console.log(team)) * .catch(console.error) * ``` */ getTeam(teamId: string): Promise; /** * Gets all Teams in an organization * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('orgId') * .then((organization) => organization.getTeams()) * .then((teams) => console.log(teams)) * .catch(console.error) * ``` */ getTeams(query?: QueryOptions): Promise>; /** * Creates a Team membership * @param teamId - Id of the team the membership will be created in * @param data - Object representation of the Team Membership to be created * @return Promise for the newly created TeamMembership * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('organizationId') * .then((org) => org.createTeamMembership('teamId', { * admin: true, * organizationMembershipId: 'organizationMembershipId' * })) * .then((teamMembership) => console.log(teamMembership)) * .catch(console.error) * ``` */ createTeamMembership(teamId: string, data: CreateTeamMembershipProps): Promise; /** * Gets an Team Membership from the team with given teamId * @return Promise for an Team Membership * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('organizationId') * .then((organization) => organization.getTeamMembership('teamId', 'teamMembership_id')) * .then((teamMembership) => console.log(teamMembership)) * .catch(console.error) * ``` */ getTeamMembership(teamId: string, teamMembershipId: string): Promise; /** * Get all Team Memberships. If teamID is provided in the optional config object, it will return all Team Memberships in that team. By default, returns all team memberships for the organization. * @return Promise for a Team Membership Collection * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('organizationId') * .then((organization) => organization.getTeamMemberships('teamId')) * .then((teamMemberships) => console.log(teamMemberships)) * .catch(console.error) * ``` */ getTeamMemberships(opts?: { teamId?: string; query?: QueryOptions; }): Promise>; /** * Get all Team Space Memberships. If teamID is provided in the optional config object, it will return all Team Space Memberships in that team. By default, returns all team space memberships across all teams in the organization. * @return Promise for a Team Space Membership Collection * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('organizationId') * .then((organization) => organization.getTeamSpaceMemberships('teamId')) * .then((teamSpaceMemberships) => console.log(teamSpaceMemberships)) * .catch(console.error) * ``` */ getTeamSpaceMemberships(opts?: { teamId?: string; query?: QueryOptions; }): Promise>; /** * Get a Team Space Membership with given teamSpaceMembershipId * @return Promise for a Team Space Membership * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('organizationId') * .then((organization) => organization.getTeamSpaceMembership('teamSpaceMembershipId')) * .then((teamSpaceMembership) => console.log(teamSpaceMembership)) * .catch(console.error)] * ``` */ getTeamSpaceMembership(teamSpaceMembershipId: string): Promise; /** * Gets an Space Membership in Organization * @param id - Organiztion Space Membership ID * @return Promise for a Space Membership in an organization * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('organization_id') * .then((organization) => organization.getOrganizationSpaceMembership('organizationSpaceMembership_id')) * .then((organizationMembership) => console.log(organizationMembership)) * .catch(console.error) * ``` */ getOrganizationSpaceMembership(id: string): Promise; /** * Gets a collection Space Memberships in organization * @param query - Object with search parameters. Check the JS SDK tutorial and the REST API reference for more details. * @return Promise for a Space Membership collection across all spaces in the organization * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('organization_id') * .then((organization) => organization.getOrganizationSpaceMemberships()) // you can add queries like 'limit': 100 * .then((response) => console.log(response.items)) * .catch(console.error) * ``` */ getOrganizationSpaceMemberships(query?: QueryOptions): Promise>; /** * Gets an Invitation in Organization * @return Promise for a OrganizationInvitation in an organization * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('') * .then((organization) => organization.getOrganizationInvitation('invitation_id')) * .then((invitation) => console.log(invitation)) * .catch(console.error) * ``` */ getOrganizationInvitation(invitationId: string): Promise; /** * Create an Invitation in Organization * @return Promise for a OrganizationInvitation in an organization * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('') * .then((organization) => organization.createOrganizationInvitation({ * email: 'user.email@example.com' * firstName: 'User First Name' * lastName: 'User Last Name' * role: 'developer' * }) * .catch(console.error) * ``` */ createOrganizationInvitation(data: CreateOrganizationInvitationProps): Promise; /** * Creates an app definition * @param Object representation of the App Definition to be created * @return Promise for the newly created AppDefinition * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('') * .then((org) => org.createAppDefinition({ * name: 'Example app', * locations: [{ location: 'app-config' }], * src: "http://my-app-host.com/my-app" * })) * .then((appDefinition) => console.log(appDefinition)) * .catch(console.error) * ``` */ createAppDefinition(data: CreateAppDefinitionProps): Promise; /** * Gets all app definitions * @return Promise for a collection of App Definitions * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('') * .then((org) => org.getAppDefinitions()) * .then((response) => console.log(response.items)) * .catch(console.error) * ``` */ getAppDefinitions(query?: QueryOptions): Promise>; /** * Gets an app definition * @return Promise for an App Definition * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('') * .then((org) => org.getAppDefinition('')) * .then((appDefinition) => console.log(appDefinition)) * .catch(console.error) * ``` */ getAppDefinition(id: string): Promise; /** * Gets an app upload * @return Promise for an App Upload * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('') * .then((org) => org.getAppUpload('')) * .then((appUpload) => console.log(appUpload)) * .catch(console.error) * ``` */ getAppUpload(appUploadId: string): Promise; /** * Creates an app upload * @return Promise for an App Upload * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('') * .then((org) => org.createAppUpload('some_zip_file')) * .then((appUpload) => console.log(appUpload)) * .catch(console.error) * ``` */ createAppUpload(file: string | ArrayBuffer | Stream): Promise; /** * Creates or updates an app signing secret * @return Promise for an App SigningSecret * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('') * .then((org) => org.upsertAppSigningSecret('app_definition_id', { value: 'tsren3s1....wn1e' })) * .then((appSigningSecret) => console.log(appSigningSecret)) * .catch(console.error) * ``` */ upsertAppSigningSecret(appDefinitionId: string, data: CreateAppSigningSecretProps): Promise; /** * Gets an app signing secret * @return Promise for an App SigningSecret * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('') * .then((org) => org.getAppSigningSecret('app_definition_id')) * .then((appSigningSecret) => console.log(appSigningSecret)) * .catch(console.error) * ``` */ getAppSigningSecret(appDefinitionId: string): Promise; /** * Deletes an app signing secret * @return Promise for the deletion. It contains no data, but the Promise error case should be handled. * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('') * .then((org) => org.deleteAppSigningSecret('app_definition_id')) * .then((result) => console.log(result)) * .catch(console.error) * ``` */ deleteAppSigningSecret(appDefinitionId: string): Promise; /** * Creates or updates an app details entity * @return Promise for an App Details * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('') * .then((org) => org.upsertAppDetails('app_definition_id', * { icon: { value: 'base_64_image', type: 'base64' }} * )) * .then((appDetails) => console.log(appDetails)) * .catch(console.error) * ``` */ upsertAppDetails(appDefinitionId: string, data: CreateAppDetailsProps): Promise; /** * Gets an app details entity * @return Promise for an App Details * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('') * .then((org) => org.getAppDetails('app_definition_id')) * .then((appDetails) => console.log(appDetails)) * .catch(console.error) * ``` */ getAppDetails(appDefinitionId: string): Promise; /** * Deletes an app details entity. * @return Promise for the deletion. It contains no data, but the Promise error case should be handled. * @example ```javascript * const contentful = require('contentful-management') * const client = contentful.createClient({ * accessToken: '' * }) * * client.getOrganization('') * .then((org) => org.deleteAppDetails('app_definition_id')) * .then((result) => console.log(result)) * .catch(console.error) * ``` */ deleteAppDetails(appDefinitionId: string): Promise; };