@transcend-io/sdk 0.0.0

package/dist/index.d.mts

@@ -0,0 +1,256 @@
+import { Logger } from "@transcend-io/utils";
+import { GraphQLClient, RequestDocument, Variables } from "graphql-request";
+import { Got } from "got";
+import { DefaultConsentOption, IdentifierType, PreferenceStoreAuthLevel, PreferenceTopicType, RequestAction, SombraStandardScope } from "@transcend-io/privacy-types";
+import { UserPrivacySignalEnum } from "@transcend-io/airgap.js-types";
+
+//#region src/api/buildTranscendGraphQLClient.d.ts
+/**
+ * Create a GraphQL client
+ *
+ * @param transcendUrl - Transcend API URL
+ * @param headers - Request headers to include in each request
+ * @param version - Optional version string to include in request headers
+ * @returns GraphQL client
+ */
+declare function buildTranscendGraphQLClientGeneric(transcendUrl: string, headers: Record<string, string>, version?: string): GraphQLClient;
+/**
+ * Create a GraphQL client capable of submitting requests with an API key
+ *
+ * @param transcendUrl - Transcend API URL
+ * @param auth - API key to authenticate to API
+ * @param version - Optional version string to include in request headers
+ * @returns GraphQL client
+ */
+declare function buildTranscendGraphQLClient(transcendUrl: string, auth: string, version?: string): GraphQLClient;
+//#endregion
+//#region src/api/makeGraphQLRequest.d.ts
+/**
+ * Make a GraphQL request with retries
+ *
+ * @param client - GraphQL client
+ * @param document - GraphQL document
+ * @param options - Options including logger, variables, headers, and retry config
+ * @returns Response
+ */
+declare function makeGraphQLRequest<T, V extends Variables = Variables>(client: GraphQLClient, document: RequestDocument, options: {
+  /** GraphQL variables */variables?: V; /** Logger for retry/error messages */
+  logger: Logger; /** Additional request headers */
+  requestHeaders?: Record<string, string> | string[][] | Headers; /** Max number of retry attempts (default 4) */
+  maxRetries?: number;
+}): Promise<T>;
+//#endregion
+//#region src/api/createSombraGotInstance.d.ts
+/**
+ * Instantiate an instance of got that is capable of making requests
+ * to a sombra gateway.
+ *
+ * @param transcendUrl - URL of Transcend API
+ * @param transcendApiKey - Transcend API key
+ * @param options - Additional options
+ * @returns The instance of got that is capable of making requests to the customer ingress
+ */
+declare function createSombraGotInstance(transcendUrl: string, transcendApiKey: string, options: {
+  /** Logger instance */logger: Logger; /** Sombra API key */
+  sombraApiKey?: string; /** Override Sombra URL (replaces process.env.SOMBRA_URL lookup) */
+  sombraUrl?: string;
+}): Promise<Got>;
+//#endregion
+//#region src/data-inventory/fetchAllIdentifiers.d.ts
+interface Identifier {
+  /** ID of identifier */
+  id: string;
+  /** Name of identifier */
+  name: string;
+  /** The type of identifier */
+  type: IdentifierType;
+  /** Regular expression */
+  regex: string;
+  /** The set of options that the identifier supports */
+  selectOptions: string[];
+  /** Whether identifier is enabled on privacy center */
+  privacyCenterVisibility: RequestAction[];
+  /** Enabled data subjects that are exposed this identifier on the privacy center */
+  dataSubjects: {
+    type: string;
+  }[];
+  /** Whether identifier is a required field in privacy center form */
+  isRequiredInForm: boolean;
+  /** Identifier placeholder text */
+  placeholder: string;
+  /** Display title for identifier */
+  displayTitle: {
+    defaultMessage: string;
+  };
+  /** Display description for identifier */
+  displayDescription: {
+    defaultMessage: string;
+  };
+  /** Display order */
+  displayOrder: number;
+  /** Does this identifier uniquely identify a consent record */
+  isUniqueOnPreferenceStore: boolean;
+}
+/**
+ * Fetch all identifiers in the organization
+ *
+ * @param client - GraphQL client
+ * @param options - Options
+ * @returns All identifiers in the organization
+ */
+declare function fetchAllIdentifiers(client: GraphQLClient, options: {
+  logger: Logger;
+}): Promise<Identifier[]>;
+//#endregion
+//#region src/preference-management/fetchAllPurposes.d.ts
+interface Purpose {
+  /** ID of purpose */
+  id: string;
+  /** Name of purpose */
+  name: string;
+  /** Description of purpose */
+  description: string;
+  /** Default consent status */
+  defaultConsent: DefaultConsentOption;
+  /** Slug of purpose */
+  trackingType: string;
+  /** Whether the purpose is configurable */
+  configurable: boolean;
+  /** Whether the purpose is essential */
+  essential: boolean;
+  /** Whether to show the purpose in the consent manager */
+  showInConsentManager: boolean;
+  /** Whether the purpose is active */
+  isActive: boolean;
+  /** Display order of the purpose */
+  displayOrder: number;
+  /** Opt-out signals for the purpose */
+  optOutSignals: UserPrivacySignalEnum[];
+  /** Whether the purpose is deleted */
+  deletedAt?: string;
+  /** Authorization level required for the purpose */
+  authLevel: PreferenceStoreAuthLevel;
+  /** Whether to show the purpose in the privacy center */
+  showInPrivacyCenter: boolean;
+  /** Title of the purpose */
+  title: string;
+}
+/**
+ * Fetch all purposes in the organization
+ *
+ * @param client - GraphQL client
+ * @param options - Options
+ * @returns All purposes in the organization
+ */
+declare function fetchAllPurposes(client: GraphQLClient, options: {
+  /** Logger instance */logger: Logger; /** Whether to include deleted purposes */
+  includeDeleted?: boolean;
+}): Promise<Purpose[]>;
+//#endregion
+//#region src/preference-management/fetchAllPreferenceTopics.d.ts
+interface PreferenceTopic {
+  /** ID of preference topic */
+  id: string;
+  /** Slug of preference topic */
+  slug: string;
+  /** Title of topic */
+  title: {
+    id: string; /** Default message */
+    defaultMessage: string;
+  };
+  /** Whether to show in privacy center */
+  showInPrivacyCenter: boolean;
+  /** Description to display in privacy center */
+  displayDescription: {
+    id: string; /** Default message */
+    defaultMessage: string;
+  };
+  /** Type of preference topic */
+  type: PreferenceTopicType;
+  /** Default configuration */
+  defaultConfiguration: string;
+  /** Option values */
+  preferenceOptionValues: {
+    /** Slug of value */slug: string; /** Title of value */
+    title: {
+      id: string; /** Default message */
+      defaultMessage: string;
+    };
+  }[];
+  /** Related purpose */
+  purpose: {
+    trackingType: string;
+  };
+}
+/**
+ * Fetch all preference topics in the organization
+ *
+ * @param client - GraphQL client
+ * @param options - Options
+ * @returns All preference topics in the organization
+ */
+declare function fetchAllPreferenceTopics(client: GraphQLClient, options: {
+  /** Logger instance */logger: Logger;
+}): Promise<PreferenceTopic[]>;
+//#endregion
+//#region src/preference-management/fetchAllPurposesAndPreferences.d.ts
+interface PurposeWithPreferences extends Purpose {
+  /** Topics */
+  topics: PreferenceTopic[];
+}
+/**
+ * Fetch all purposes and preferences
+ *
+ * @param client - GraphQL client
+ * @param options - Options
+ * @returns List of purposes with their preference topics
+ */
+declare function fetchAllPurposesAndPreferences(client: GraphQLClient, options: {
+  logger: Logger;
+}): Promise<PurposeWithPreferences[]>;
+//#endregion
+//#region src/preference-management/createPreferenceAccessTokens.d.ts
+interface PreferenceAccessTokenInput {
+  /** Slug of data subject to authenticate as */
+  subjectType: string;
+  /** Scopes to grant */
+  scopes: SombraStandardScope[];
+  /** Expiration time in seconds */
+  expiresIn?: number;
+  /** Email address of user */
+  email: string;
+  /** Core identifier for the user */
+  coreIdentifier?: string;
+}
+interface PreferenceAccessTokenInputWithIndex extends PreferenceAccessTokenInput {
+  /** Index of the input record */
+  index?: number;
+}
+/**
+ * Create preference access tokens for the given identifiers.
+ *
+ * @see https://docs.transcend.io/docs/articles/preference-management/access-links
+ * @param client - GraphQL client
+ * @param options - Options
+ * @returns list of access tokens/input identifiers
+ */
+declare function createPreferenceAccessTokens(client: GraphQLClient, options: {
+  /** Records to create tokens for */records: PreferenceAccessTokenInputWithIndex[]; /** Logger instance */
+  logger: Logger; /** Optional progress emitter */
+  emitProgress?: (progress: number) => void; /** Number of concurrent requests to make (default: 10) */
+  concurrency?: number;
+}): Promise<{
+  /** Identifier for the record */input: PreferenceAccessTokenInputWithIndex; /** Access token */
+  accessToken: string;
+}[]>;
+//#endregion
+//#region src/index.d.ts
+interface MonorepoPackageDefinition {
+  directory: string;
+  displayName: string;
+  packageName: string;
+}
+declare function createMonorepoPackageDefinition(name: string, directory: string): MonorepoPackageDefinition;
+//#endregion
+export { Identifier, MonorepoPackageDefinition, PreferenceAccessTokenInput, PreferenceAccessTokenInputWithIndex, PreferenceTopic, Purpose, PurposeWithPreferences, buildTranscendGraphQLClient, buildTranscendGraphQLClientGeneric, createMonorepoPackageDefinition, createPreferenceAccessTokens, createSombraGotInstance, fetchAllIdentifiers, fetchAllPreferenceTopics, fetchAllPurposes, fetchAllPurposesAndPreferences, makeGraphQLRequest };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/api/buildTranscendGraphQLClient.ts","../src/api/makeGraphQLRequest.ts","../src/api/createSombraGotInstance.ts","../src/data-inventory/fetchAllIdentifiers.ts","../src/preference-management/fetchAllPurposes.ts","../src/preference-management/fetchAllPreferenceTopics.ts","../src/preference-management/fetchAllPurposesAndPreferences.ts","../src/preference-management/createPreferenceAccessTokens.ts","../src/index.ts"],"mappings":";;;;;;;;;;;;;AAUA;;iBAAgB,kCAAA,CACd,YAAA,UACA,OAAA,EAAS,MAAA,kBACT,OAAA,YACC,aAAA;;;;;;;;;iBAiBa,2BAAA,CACd,YAAA,UACA,IAAA,UACA,OAAA,YACC,aAAA;;;;;;;;AAzBH;;;iBCWsB,kBAAA,cAAgC,SAAA,GAAY,SAAA,CAAA,CAChE,MAAA,EAAQ,aAAA,EACR,QAAA,EAAU,eAAA,EACV,OAAA;EDbA,wBCeE,SAAA,GAAY,CAAA,EDdd;ECgBE,MAAA,EAAQ,MAAA,EDdT;ECgBC,cAAA,GAAiB,MAAA,gCAAsC,OAAA,EDhB3C;ECkBZ,UAAA;AAAA,IAED,OAAA,CAAQ,CAAA;;;;;;;;ADxBX;;;;iBEMsB,uBAAA,CACpB,YAAA,UACA,eAAA,UACA,OAAA;EFPS,sBESP,MAAA,EAAQ,MAAA,EFRV;EEUE,YAAA,WFTY;EEWZ,SAAA;AAAA,IAED,OAAA,CAAQ,GAAA;;;UCpBM,UAAA;;EAEf,EAAA;;EAEA,IAAA;EHDgD;EGGhD,IAAA,EAAM,cAAA;EHCQ;EGCd,KAAA;EHHS;EGKT,aAAA;EHJA;EGMA,uBAAA,EAAyB,aAAA;EHLX;EGOd,YAAA;IAA6C,IAAA;EAAA;;EAE7C,gBAAA;EHSA;EGPA,WAAA;EHSA;EGPA,YAAA;IAAuC,cAAA;EAAA;;EAEvC,kBAAA;IAAqC,cAAA;EAAA;EFRC;EEUtC,YAAA;EFVoD;EEYpD,yBAAA;AAAA;;;;;;;;iBAYoB,mBAAA,CACpB,MAAA,EAAQ,aAAA,EACR,OAAA;EAAkC,MAAA,EAAQ,MAAA;AAAA,IACzC,OAAA,CAAQ,UAAA;;;UCxCM,OAAA;;EAEf,EAAA;EJAc;EIEd,IAAA;;EAEA,WAAA;EJHA;EIKA,cAAA,EAAgB,oBAAA;EJJhB;EIMA,YAAA;EJJC;EIMD,YAAA;EJNc;EIQd,SAAA;EJSyC;EIPzC,oBAAA;EJWc;EITd,QAAA;EJOA;EILA,YAAA;EJOC;EILD,aAAA,EAAe,qBAAA;EJKD;EIHd,SAAA;;EAEA,SAAA,EAAW,wBAAA;EHbS;EGepB,mBAAA;EHfsC;EGiBtC,KAAA;AAAA;;;;;;;;iBAYoB,gBAAA,CACpB,MAAA,EAAQ,aAAA,EACR,OAAA;EHlBQ,sBGoBN,MAAA,EAAQ,MAAA,EHjC6B;EGmCrC,cAAA;AAAA,IAED,OAAA,CAAQ,OAAA;;;UCnDM,eAAA;;EAEf,EAAA;;EAEA,IAAA;ELDgD;EKGhD,KAAA;IAAmB,EAAA,ULCL;IKDwC,cAAA;EAAA;ELDtD;EKGA,mBAAA;ELDC;EKGD,kBAAA;IAAgC,EAAA,ULHlB;IKGqD,cAAA;EAAA;;EAEnE,IAAA,EAAM,mBAAA;ELaN;EKXA,oBAAA;ELaA;EKXA,sBAAA;ILYc,oBKVZ,IAAA;IAEA,KAAA;MAAmB,EAAA;MAAmC,cAAA;IAAA;EAAA;EJNJ;EISpD,OAAA;IAAuB,YAAA;EAAA;AAAA;;;;;;;;iBAYH,wBAAA,CACpB,MAAA,EAAQ,aAAA,EACR,OAAA;EJvB0C,sBIyBxC,MAAA,EAAQ,MAAA;AAAA,IAET,OAAA,CAAQ,eAAA;;;UC1CM,sBAAA,SAA+B,OAAA;;EAE9C,MAAA,EAAQ,eAAA;AAAA;;;;;;;;iBAUY,8BAAA,CACpB,MAAA,EAAQ,aAAA,EACR,OAAA;EAAkC,MAAA,EAAQ,MAAA;AAAA,IACzC,OAAA,CAAQ,sBAAA;;;UCbM,0BAAA;;EAEf,WAAA;;EAEA,MAAA,EAAQ,mBAAA;EPFwC;EOIhD,SAAA;EPAc;EOEd,KAAA;EPJS;EOMT,cAAA;AAAA;AAAA,UAGe,mCAAA,SAA4C,0BAAA;EPP7C;EOSd,KAAA;AAAA;;;;;;;;;iBAyCoB,4BAAA,CACpB,MAAA,EAAQ,aAAA,EACR,OAAA;qCAEE,OAAA,EAAS,mCAAA;EAET,MAAA,EAAQ,MAAA,ENjD4B;EMmDpC,YAAA,IAAgB,QAAA,mBNnDkC;EMqDlD,WAAA;AAAA,IAED,OAAA;ENrDS,gCMwDR,KAAA,EAAO,mCAAA,ENnDC;EMqDR,WAAA;AAAA;;;UC/Ea,yBAAA;EACf,SAAA;EACA,WAAA;EACA,WAAA;AAAA;AAAA,iBAGc,+BAAA,CACd,IAAA,UACA,SAAA,WACC,yBAAA"}

package/dist/index.mjs

@@ -0,0 +1,377 @@
+import { describePackageName, map, sleepPromise } from "@transcend-io/utils";
+import { GraphQLClient, gql } from "graphql-request";
+import got from "got";
+import { parse } from "graphql";
+import { chunk } from "lodash-es";
+//#region src/api/buildTranscendGraphQLClient.ts
+/**
+* Create a GraphQL client
+*
+* @param transcendUrl - Transcend API URL
+* @param headers - Request headers to include in each request
+* @param version - Optional version string to include in request headers
+* @returns GraphQL client
+*/
+function buildTranscendGraphQLClientGeneric(transcendUrl, headers, version) {
+	return new GraphQLClient(`${transcendUrl}/graphql`, { headers: {
+		...headers,
+		...version ? { version } : {}
+	} });
+}
+/**
+* Create a GraphQL client capable of submitting requests with an API key
+*
+* @param transcendUrl - Transcend API URL
+* @param auth - API key to authenticate to API
+* @param version - Optional version string to include in request headers
+* @returns GraphQL client
+*/
+function buildTranscendGraphQLClient(transcendUrl, auth, version) {
+	return buildTranscendGraphQLClientGeneric(transcendUrl, { Authorization: `Bearer ${auth}` }, version);
+}
+//#endregion
+//#region src/api/makeGraphQLRequest.ts
+const DEFAULT_MAX_RETRIES = 4;
+const KNOWN_ERRORS = [
+	"syntax error",
+	"got invalid value",
+	"Client error",
+	"cannot affect row a second time",
+	"GRAPHQL_VALIDATION_FAILED"
+];
+/**
+* Make a GraphQL request with retries
+*
+* @param client - GraphQL client
+* @param document - GraphQL document
+* @param options - Options including logger, variables, headers, and retry config
+* @returns Response
+*/
+async function makeGraphQLRequest(client, document, options) {
+	const { variables, logger, requestHeaders, maxRetries = DEFAULT_MAX_RETRIES } = options;
+	let retryCount = 0;
+	while (true) try {
+		return await client.request(document, variables, requestHeaders);
+	} catch (err) {
+		if (err.message?.includes("API key is invalid")) throw new Error("API key is invalid. Please ensure that the key provided has the proper scope and is not expired, and that the transcendUrl corresponds to the correct backend for your organization.");
+		if (KNOWN_ERRORS.some((msg) => err.message?.includes(msg))) throw err;
+		if (err.message?.startsWith("Client error: Too many requests")) {
+			const rateLimitResetAt = err.response?.headers?.get("x-ratelimit-reset");
+			const sleepTime = rateLimitResetAt ? new Date(rateLimitResetAt).getTime() - (/* @__PURE__ */ new Date()).getTime() + 100 : 1e3 * 10;
+			logger.warn(`DETECTED RATE LIMIT: ${err.message}. Sleeping for ${sleepTime}ms`);
+			await sleepPromise(sleepTime);
+		}
+		if (retryCount >= maxRetries) throw err;
+		retryCount += 1;
+		logger.warn(`Retrying failed request (${retryCount} / ${maxRetries}): ${err.message}`);
+	}
+}
+//#endregion
+//#region src/api/gqls/organization.ts
+const ORGANIZATION = parse(gql`
+  query TranscendCliOrganization {
+    organization {
+      sombra {
+        customerUrl
+      }
+    }
+  }
+`);
+//#endregion
+//#region src/api/createSombraGotInstance.ts
+/**
+* Instantiate an instance of got that is capable of making requests
+* to a sombra gateway.
+*
+* @param transcendUrl - URL of Transcend API
+* @param transcendApiKey - Transcend API key
+* @param options - Additional options
+* @returns The instance of got that is capable of making requests to the customer ingress
+*/
+async function createSombraGotInstance(transcendUrl, transcendApiKey, options) {
+	const { logger, sombraApiKey, sombraUrl } = options;
+	const { organization } = await makeGraphQLRequest(buildTranscendGraphQLClient(transcendUrl, transcendApiKey), ORGANIZATION, { logger });
+	const { customerUrl } = organization.sombra;
+	const sombraToUse = sombraUrl || customerUrl;
+	if (!sombraUrl && ["https://sombra-reverse-tunnel.transcend.io", "https://sombra-reverse-tunnel.us.transcend.io"].includes(customerUrl)) throw new Error("It looks like your Sombra customer ingress URL has not been set up. Please follow the instructions here to configure networking for Sombra: https://docs.transcend.io/docs/articles/sombra/deploying/customizing-sombra/networking");
+	logger.info(`Using sombra: ${sombraToUse}`);
+	return got.extend({
+		prefixUrl: sombraToUse,
+		headers: {
+			Authorization: `Bearer ${transcendApiKey}`,
+			...sombraApiKey ? { "X-Sombra-Authorization": `Bearer ${sombraApiKey}` } : {}
+		}
+	});
+}
+//#endregion
+//#region src/data-inventory/gqls/identifier.ts
+const IDENTIFIERS = parse(gql`
+  query TranscendCliIdentifiers($first: Int!, $offset: Int!) {
+    identifiers(
+      first: $first
+      offset: $offset
+      useMaster: false
+      orderBy: [{ field: createdAt, direction: ASC }, { field: name, direction: ASC }]
+    ) {
+      nodes {
+        id
+        name
+        type
+        regex
+        selectOptions
+        privacyCenterVisibility
+        dataSubjects {
+          type
+        }
+        isRequiredInForm
+        placeholder
+        displayTitle {
+          defaultMessage
+        }
+        displayDescription {
+          defaultMessage
+        }
+        displayOrder
+        isUniqueOnPreferenceStore
+      }
+    }
+  }
+`);
+//#endregion
+//#region src/data-inventory/fetchAllIdentifiers.ts
+const PAGE_SIZE$2 = 20;
+/**
+* Fetch all identifiers in the organization
+*
+* @param client - GraphQL client
+* @param options - Options
+* @returns All identifiers in the organization
+*/
+async function fetchAllIdentifiers(client, options) {
+	const { logger } = options;
+	const identifiers = [];
+	let offset = 0;
+	let shouldContinue = false;
+	do {
+		const { identifiers: { nodes } } = await makeGraphQLRequest(client, IDENTIFIERS, {
+			logger,
+			variables: {
+				first: PAGE_SIZE$2,
+				offset
+			}
+		});
+		identifiers.push(...nodes);
+		offset += PAGE_SIZE$2;
+		shouldContinue = nodes.length === PAGE_SIZE$2;
+	} while (shouldContinue);
+	return identifiers.sort((a, b) => a.name.localeCompare(b.name));
+}
+//#endregion
+//#region src/preference-management/gqls/purpose.ts
+const PURPOSES = parse(gql`
+  query TranscendCliPurposes(
+    $first: Int!
+    $offset: Int!
+    $filterBy: TrackingPurposeFiltersInput
+    $input: TrackingPurposeInput!
+  ) {
+    purposes(first: $first, offset: $offset, filterBy: $filterBy, input: $input) {
+      nodes {
+        id
+        name
+        description
+        defaultConsent
+        trackingType
+        configurable
+        essential
+        showInConsentManager
+        isActive
+        displayOrder
+        optOutSignals
+        deletedAt
+        authLevel
+        showInPrivacyCenter
+        title
+      }
+    }
+  }
+`);
+//#endregion
+//#region src/preference-management/fetchAllPurposes.ts
+const PAGE_SIZE$1 = 20;
+/**
+* Fetch all purposes in the organization
+*
+* @param client - GraphQL client
+* @param options - Options
+* @returns All purposes in the organization
+*/
+async function fetchAllPurposes(client, options) {
+	const { logger, includeDeleted = false } = options;
+	const purposes = [];
+	let offset = 0;
+	let shouldContinue = false;
+	do {
+		const { purposes: { nodes } } = await makeGraphQLRequest(client, PURPOSES, {
+			logger,
+			variables: {
+				first: PAGE_SIZE$1,
+				offset,
+				input: { includeDeleted }
+			}
+		});
+		purposes.push(...nodes);
+		offset += PAGE_SIZE$1;
+		shouldContinue = nodes.length === PAGE_SIZE$1;
+	} while (shouldContinue);
+	return purposes.sort((a, b) => a.trackingType.localeCompare(b.trackingType));
+}
+//#endregion
+//#region src/preference-management/gqls/preferenceTopic.ts
+const PREFERENCE_TOPICS = parse(gql`
+  query TranscendCliPreferenceTopics(
+    $first: Int!
+    $offset: Int!
+    $filterBy: PreferenceTopicFilterInput
+  ) {
+    preferenceTopics(first: $first, offset: $offset, filterBy: $filterBy) {
+      nodes {
+        id
+        slug
+        type
+        title {
+          id
+          defaultMessage
+        }
+        showInPrivacyCenter
+        displayDescription {
+          id
+          defaultMessage
+        }
+        defaultConfiguration
+        preferenceOptionValues {
+          slug
+          title {
+            id
+            defaultMessage
+          }
+        }
+        purpose {
+          trackingType
+        }
+      }
+    }
+  }
+`);
+//#endregion
+//#region src/preference-management/fetchAllPreferenceTopics.ts
+const PAGE_SIZE = 20;
+/**
+* Fetch all preference topics in the organization
+*
+* @param client - GraphQL client
+* @param options - Options
+* @returns All preference topics in the organization
+*/
+async function fetchAllPreferenceTopics(client, options) {
+	const { logger } = options;
+	const preferenceTopics = [];
+	let offset = 0;
+	let shouldContinue = false;
+	do {
+		const { preferenceTopics: { nodes } } = await makeGraphQLRequest(client, PREFERENCE_TOPICS, {
+			logger,
+			variables: {
+				first: PAGE_SIZE,
+				offset
+			}
+		});
+		preferenceTopics.push(...nodes);
+		offset += PAGE_SIZE;
+		shouldContinue = nodes.length === PAGE_SIZE;
+	} while (shouldContinue);
+	return preferenceTopics.sort((a, b) => `${a.slug}:${a.purpose.trackingType}`.localeCompare(`${b.slug}:${b.purpose.trackingType}`));
+}
+//#endregion
+//#region src/preference-management/fetchAllPurposesAndPreferences.ts
+/**
+* Fetch all purposes and preferences
+*
+* @param client - GraphQL client
+* @param options - Options
+* @returns List of purposes with their preference topics
+*/
+async function fetchAllPurposesAndPreferences(client, options) {
+	const [purposes, topics] = await Promise.all([fetchAllPurposes(client, options), fetchAllPreferenceTopics(client, options)]);
+	return purposes.map((purpose) => ({
+		...purpose,
+		topics: topics.filter((topic) => topic.purpose.trackingType === purpose.trackingType)
+	}));
+}
+//#endregion
+//#region src/preference-management/gqls/preferenceAccessTokens.ts
+const CREATE_PREFERENCE_ACCESS_TOKENS = parse(gql`
+  mutation TranscendCliCreatePreferenceAccessTokens($input: CreatePrivacyCenterAccessTokensInput!) {
+    createPrivacyCenterAccessTokens(input: $input) {
+      nodes {
+        token
+      }
+    }
+  }
+`);
+//#endregion
+//#region src/preference-management/createPreferenceAccessTokens.ts
+const MAX_BATCH_SIZE = 50;
+/**
+* Create preference access tokens for a single page of identifiers.
+*
+* @param client - GraphQL client
+* @param records - Inputs to sign
+* @param logger - Logger
+* @returns list of access tokens
+*/
+async function createPreferenceAccessTokensPage(client, records, logger) {
+	const { createPrivacyCenterAccessTokens: { nodes } } = await makeGraphQLRequest(client, CREATE_PREFERENCE_ACCESS_TOKENS, {
+		logger,
+		variables: { input: { records } }
+	});
+	return nodes.map((node) => node.token);
+}
+/**
+* Create preference access tokens for the given identifiers.
+*
+* @see https://docs.transcend.io/docs/articles/preference-management/access-links
+* @param client - GraphQL client
+* @param options - Options
+* @returns list of access tokens/input identifiers
+*/
+async function createPreferenceAccessTokens(client, options) {
+	const { records, logger, emitProgress, concurrency = 10 } = options;
+	let completed = 0;
+	emitProgress?.(0);
+	const results = [];
+	await map(chunk(records, MAX_BATCH_SIZE), async (chunkedRecords) => {
+		const mappedResults = (await createPreferenceAccessTokensPage(client, chunkedRecords.map(({ index, ...rest }) => rest), logger)).map((token, idx) => ({
+			input: chunkedRecords[idx],
+			accessToken: token
+		}));
+		results.push(...mappedResults);
+		completed += chunkedRecords.length;
+		emitProgress?.(completed);
+	}, { concurrency });
+	return results;
+}
+//#endregion
+//#region src/index.ts
+function createMonorepoPackageDefinition(name, directory) {
+	const packageNameParts = describePackageName(name);
+	return {
+		directory,
+		displayName: packageNameParts.displayName,
+		packageName: `@transcend-io/${packageNameParts.slug}`
+	};
+}
+//#endregion
+export { buildTranscendGraphQLClient, buildTranscendGraphQLClientGeneric, createMonorepoPackageDefinition, createPreferenceAccessTokens, createSombraGotInstance, fetchAllIdentifiers, fetchAllPreferenceTopics, fetchAllPurposes, fetchAllPurposesAndPreferences, makeGraphQLRequest };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["PAGE_SIZE","PAGE_SIZE"],"sources":["../src/api/buildTranscendGraphQLClient.ts","../src/api/makeGraphQLRequest.ts","../src/api/gqls/organization.ts","../src/api/createSombraGotInstance.ts","../src/data-inventory/gqls/identifier.ts","../src/data-inventory/fetchAllIdentifiers.ts","../src/preference-management/gqls/purpose.ts","../src/preference-management/fetchAllPurposes.ts","../src/preference-management/gqls/preferenceTopic.ts","../src/preference-management/fetchAllPreferenceTopics.ts","../src/preference-management/fetchAllPurposesAndPreferences.ts","../src/preference-management/gqls/preferenceAccessTokens.ts","../src/preference-management/createPreferenceAccessTokens.ts","../src/index.ts"],"sourcesContent":["import { GraphQLClient } from 'graphql-request';\n\n/**\n * Create a GraphQL client\n *\n * @param transcendUrl - Transcend API URL\n * @param headers - Request headers to include in each request\n * @param version - Optional version string to include in request headers\n * @returns GraphQL client\n */\nexport function buildTranscendGraphQLClientGeneric(\n  transcendUrl: string,\n  headers: Record<string, string>,\n  version?: string,\n): GraphQLClient {\n  return new GraphQLClient(`${transcendUrl}/graphql`, {\n    headers: {\n      ...headers,\n      ...(version ? { version } : {}),\n    },\n  });\n}\n\n/**\n * Create a GraphQL client capable of submitting requests with an API key\n *\n * @param transcendUrl - Transcend API URL\n * @param auth - API key to authenticate to API\n * @param version - Optional version string to include in request headers\n * @returns GraphQL client\n */\nexport function buildTranscendGraphQLClient(\n  transcendUrl: string,\n  auth: string,\n  version?: string,\n): GraphQLClient {\n  return buildTranscendGraphQLClientGeneric(\n    transcendUrl,\n    { Authorization: `Bearer ${auth}` },\n    version,\n  );\n}\n","import { sleepPromise, type Logger } from '@transcend-io/utils';\nimport type { GraphQLClient, RequestDocument, Variables } from 'graphql-request';\n\nconst DEFAULT_MAX_RETRIES = 4;\n\nconst KNOWN_ERRORS = [\n  'syntax error',\n  'got invalid value',\n  'Client error',\n  'cannot affect row a second time',\n  'GRAPHQL_VALIDATION_FAILED',\n];\n\n/**\n * Make a GraphQL request with retries\n *\n * @param client - GraphQL client\n * @param document - GraphQL document\n * @param options - Options including logger, variables, headers, and retry config\n * @returns Response\n */\nexport async function makeGraphQLRequest<T, V extends Variables = Variables>(\n  client: GraphQLClient,\n  document: RequestDocument,\n  options: {\n    /** GraphQL variables */\n    variables?: V;\n    /** Logger for retry/error messages */\n    logger: Logger;\n    /** Additional request headers */\n    requestHeaders?: Record<string, string> | string[][] | Headers;\n    /** Max number of retry attempts (default 4) */\n    maxRetries?: number;\n  },\n): Promise<T> {\n  const { variables, logger, requestHeaders, maxRetries = DEFAULT_MAX_RETRIES } = options;\n\n  let retryCount = 0;\n  // eslint-disable-next-line no-constant-condition\n  while (true) {\n    try {\n      const result = await client.request(document, variables, requestHeaders);\n      return result as T;\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } catch (err: any) {\n      if (err.message?.includes('API key is invalid')) {\n        throw new Error(\n          'API key is invalid. ' +\n            'Please ensure that the key provided has the proper scope and is not expired, ' +\n            'and that the transcendUrl corresponds to the correct backend for your organization.',\n        );\n      }\n\n      if (KNOWN_ERRORS.some((msg) => err.message?.includes(msg))) {\n        throw err;\n      }\n\n      if (err.message?.startsWith('Client error: Too many requests')) {\n        const rateLimitResetAt = err.response?.headers?.get('x-ratelimit-reset');\n        const sleepTime = rateLimitResetAt\n          ? new Date(rateLimitResetAt).getTime() - new Date().getTime() + 100\n          : 1000 * 10;\n        logger.warn(`DETECTED RATE LIMIT: ${err.message}. Sleeping for ${sleepTime}ms`);\n        await sleepPromise(sleepTime);\n      }\n\n      if (retryCount >= maxRetries) {\n        throw err;\n      }\n      retryCount += 1;\n      logger.warn(`Retrying failed request (${retryCount} / ${maxRetries}): ${err.message}`);\n    }\n  }\n}\n","import { parse, type DocumentNode } from 'graphql';\nimport { gql } from 'graphql-request';\n\nexport const ORGANIZATION: DocumentNode = parse(gql`\n  query TranscendCliOrganization {\n    organization {\n      sombra {\n        customerUrl\n      }\n    }\n  }\n`);\n","import type { Logger } from '@transcend-io/utils';\nimport got, { type Got } from 'got';\n\nimport { buildTranscendGraphQLClient } from './buildTranscendGraphQLClient.js';\nimport { ORGANIZATION } from './gqls/organization.js';\nimport { makeGraphQLRequest } from './makeGraphQLRequest.js';\n\n/**\n * Instantiate an instance of got that is capable of making requests\n * to a sombra gateway.\n *\n * @param transcendUrl - URL of Transcend API\n * @param transcendApiKey - Transcend API key\n * @param options - Additional options\n * @returns The instance of got that is capable of making requests to the customer ingress\n */\nexport async function createSombraGotInstance(\n  transcendUrl: string,\n  transcendApiKey: string,\n  options: {\n    /** Logger instance */\n    logger: Logger;\n    /** Sombra API key */\n    sombraApiKey?: string;\n    /** Override Sombra URL (replaces process.env.SOMBRA_URL lookup) */\n    sombraUrl?: string;\n  },\n): Promise<Got> {\n  const { logger, sombraApiKey, sombraUrl } = options;\n\n  const client = buildTranscendGraphQLClient(transcendUrl, transcendApiKey);\n  const { organization } = await makeGraphQLRequest<{\n    /** Organization */\n    organization: {\n      /** Primary Sombra */\n      sombra: {\n        /** URL */\n        customerUrl: string;\n      };\n    };\n  }>(client, ORGANIZATION, { logger });\n\n  const { customerUrl } = organization.sombra;\n  const sombraToUse = sombraUrl || customerUrl;\n\n  if (\n    !sombraUrl &&\n    [\n      'https://sombra-reverse-tunnel.transcend.io',\n      'https://sombra-reverse-tunnel.us.transcend.io',\n    ].includes(customerUrl)\n  ) {\n    throw new Error(\n      'It looks like your Sombra customer ingress URL has not been set up. ' +\n        'Please follow the instructions here to configure networking for Sombra: ' +\n        'https://docs.transcend.io/docs/articles/sombra/deploying/customizing-sombra/networking',\n    );\n  }\n  logger.info(`Using sombra: ${sombraToUse}`);\n\n  return got.extend({\n    prefixUrl: sombraToUse,\n    headers: {\n      Authorization: `Bearer ${transcendApiKey}`,\n      ...(sombraApiKey ? { 'X-Sombra-Authorization': `Bearer ${sombraApiKey}` } : {}),\n    },\n  });\n}\n","import { parse, type DocumentNode } from 'graphql';\nimport { gql } from 'graphql-request';\n\nexport const IDENTIFIERS: DocumentNode = parse(gql`\n  query TranscendCliIdentifiers($first: Int!, $offset: Int!) {\n    identifiers(\n      first: $first\n      offset: $offset\n      useMaster: false\n      orderBy: [{ field: createdAt, direction: ASC }, { field: name, direction: ASC }]\n    ) {\n      nodes {\n        id\n        name\n        type\n        regex\n        selectOptions\n        privacyCenterVisibility\n        dataSubjects {\n          type\n        }\n        isRequiredInForm\n        placeholder\n        displayTitle {\n          defaultMessage\n        }\n        displayDescription {\n          defaultMessage\n        }\n        displayOrder\n        isUniqueOnPreferenceStore\n      }\n    }\n  }\n`);\n","import { IdentifierType, RequestAction } from '@transcend-io/privacy-types';\nimport type { Logger } from '@transcend-io/utils';\nimport type { GraphQLClient } from 'graphql-request';\n\nimport { makeGraphQLRequest } from '../api/makeGraphQLRequest.js';\nimport { IDENTIFIERS } from './gqls/identifier.js';\n\nexport interface Identifier {\n  /** ID of identifier */\n  id: string;\n  /** Name of identifier */\n  name: string;\n  /** The type of identifier */\n  type: IdentifierType;\n  /** Regular expression */\n  regex: string;\n  /** The set of options that the identifier supports */\n  selectOptions: string[];\n  /** Whether identifier is enabled on privacy center */\n  privacyCenterVisibility: RequestAction[];\n  /** Enabled data subjects that are exposed this identifier on the privacy center */\n  dataSubjects: { /** type of data subjects */ type: string }[];\n  /** Whether identifier is a required field in privacy center form */\n  isRequiredInForm: boolean;\n  /** Identifier placeholder text */\n  placeholder: string;\n  /** Display title for identifier */\n  displayTitle: { /** Default message */ defaultMessage: string };\n  /** Display description for identifier */\n  displayDescription: { /** Default */ defaultMessage: string };\n  /** Display order */\n  displayOrder: number;\n  /** Does this identifier uniquely identify a consent record */\n  isUniqueOnPreferenceStore: boolean;\n}\n\nconst PAGE_SIZE = 20;\n\n/**\n * Fetch all identifiers in the organization\n *\n * @param client - GraphQL client\n * @param options - Options\n * @returns All identifiers in the organization\n */\nexport async function fetchAllIdentifiers(\n  client: GraphQLClient,\n  options: { /** Logger instance */ logger: Logger },\n): Promise<Identifier[]> {\n  const { logger } = options;\n  const identifiers: Identifier[] = [];\n  let offset = 0;\n\n  let shouldContinue = false;\n  do {\n    const {\n      identifiers: { nodes },\n    } = await makeGraphQLRequest<{\n      /** Identifiers */\n      identifiers: { /** List */ nodes: Identifier[] };\n    }>(client, IDENTIFIERS, {\n      logger,\n      variables: { first: PAGE_SIZE, offset },\n    });\n    identifiers.push(...nodes);\n    offset += PAGE_SIZE;\n    shouldContinue = nodes.length === PAGE_SIZE;\n  } while (shouldContinue);\n\n  return identifiers.sort((a, b) => a.name.localeCompare(b.name));\n}\n","import { parse, type DocumentNode } from 'graphql';\nimport { gql } from 'graphql-request';\n\nexport const PURPOSES: DocumentNode = parse(gql`\n  query TranscendCliPurposes(\n    $first: Int!\n    $offset: Int!\n    $filterBy: TrackingPurposeFiltersInput\n    $input: TrackingPurposeInput!\n  ) {\n    purposes(first: $first, offset: $offset, filterBy: $filterBy, input: $input) {\n      nodes {\n        id\n        name\n        description\n        defaultConsent\n        trackingType\n        configurable\n        essential\n        showInConsentManager\n        isActive\n        displayOrder\n        optOutSignals\n        deletedAt\n        authLevel\n        showInPrivacyCenter\n        title\n      }\n    }\n  }\n`);\n","import { UserPrivacySignalEnum } from '@transcend-io/airgap.js-types';\nimport { DefaultConsentOption, PreferenceStoreAuthLevel } from '@transcend-io/privacy-types';\nimport type { Logger } from '@transcend-io/utils';\nimport type { GraphQLClient } from 'graphql-request';\n\nimport { makeGraphQLRequest } from '../api/makeGraphQLRequest.js';\nimport { PURPOSES } from './gqls/purpose.js';\n\nexport interface Purpose {\n  /** ID of purpose */\n  id: string;\n  /** Name of purpose */\n  name: string;\n  /** Description of purpose */\n  description: string;\n  /** Default consent status */\n  defaultConsent: DefaultConsentOption;\n  /** Slug of purpose */\n  trackingType: string;\n  /** Whether the purpose is configurable */\n  configurable: boolean;\n  /** Whether the purpose is essential */\n  essential: boolean;\n  /** Whether to show the purpose in the consent manager */\n  showInConsentManager: boolean;\n  /** Whether the purpose is active */\n  isActive: boolean;\n  /** Display order of the purpose */\n  displayOrder: number;\n  /** Opt-out signals for the purpose */\n  optOutSignals: UserPrivacySignalEnum[];\n  /** Whether the purpose is deleted */\n  deletedAt?: string;\n  /** Authorization level required for the purpose */\n  authLevel: PreferenceStoreAuthLevel;\n  /** Whether to show the purpose in the privacy center */\n  showInPrivacyCenter: boolean;\n  /** Title of the purpose */\n  title: string;\n}\n\nconst PAGE_SIZE = 20;\n\n/**\n * Fetch all purposes in the organization\n *\n * @param client - GraphQL client\n * @param options - Options\n * @returns All purposes in the organization\n */\nexport async function fetchAllPurposes(\n  client: GraphQLClient,\n  options: {\n    /** Logger instance */\n    logger: Logger;\n    /** Whether to include deleted purposes */\n    includeDeleted?: boolean;\n  },\n): Promise<Purpose[]> {\n  const { logger, includeDeleted = false } = options;\n  const purposes: Purpose[] = [];\n  let offset = 0;\n\n  let shouldContinue = false;\n  do {\n    const {\n      purposes: { nodes },\n    } = await makeGraphQLRequest<{\n      /** Purposes */\n      purposes: { /** List */ nodes: Purpose[] };\n    }>(client, PURPOSES, {\n      logger,\n      variables: { first: PAGE_SIZE, offset, input: { includeDeleted } },\n    });\n    purposes.push(...nodes);\n    offset += PAGE_SIZE;\n    shouldContinue = nodes.length === PAGE_SIZE;\n  } while (shouldContinue);\n\n  return purposes.sort((a, b) => a.trackingType.localeCompare(b.trackingType));\n}\n","import { parse, type DocumentNode } from 'graphql';\nimport { gql } from 'graphql-request';\n\nexport const PREFERENCE_TOPICS: DocumentNode = parse(gql`\n  query TranscendCliPreferenceTopics(\n    $first: Int!\n    $offset: Int!\n    $filterBy: PreferenceTopicFilterInput\n  ) {\n    preferenceTopics(first: $first, offset: $offset, filterBy: $filterBy) {\n      nodes {\n        id\n        slug\n        type\n        title {\n          id\n          defaultMessage\n        }\n        showInPrivacyCenter\n        displayDescription {\n          id\n          defaultMessage\n        }\n        defaultConfiguration\n        preferenceOptionValues {\n          slug\n          title {\n            id\n            defaultMessage\n          }\n        }\n        purpose {\n          trackingType\n        }\n      }\n    }\n  }\n`);\n","import { PreferenceTopicType } from '@transcend-io/privacy-types';\nimport type { Logger } from '@transcend-io/utils';\nimport type { GraphQLClient } from 'graphql-request';\n\nimport { makeGraphQLRequest } from '../api/makeGraphQLRequest.js';\nimport { PREFERENCE_TOPICS } from './gqls/preferenceTopic.js';\n\nexport interface PreferenceTopic {\n  /** ID of preference topic */\n  id: string;\n  /** Slug of preference topic */\n  slug: string;\n  /** Title of topic */\n  title: { /** ID */ id: string; /** Default message */ defaultMessage: string };\n  /** Whether to show in privacy center */\n  showInPrivacyCenter: boolean;\n  /** Description to display in privacy center */\n  displayDescription: { /** ID */ id: string; /** Default message */ defaultMessage: string };\n  /** Type of preference topic */\n  type: PreferenceTopicType;\n  /** Default configuration */\n  defaultConfiguration: string;\n  /** Option values */\n  preferenceOptionValues: {\n    /** Slug of value */\n    slug: string;\n    /** Title of value */\n    title: { /** ID */ id: string; /** Default message */ defaultMessage: string };\n  }[];\n  /** Related purpose */\n  purpose: { /** Slug */ trackingType: string };\n}\n\nconst PAGE_SIZE = 20;\n\n/**\n * Fetch all preference topics in the organization\n *\n * @param client - GraphQL client\n * @param options - Options\n * @returns All preference topics in the organization\n */\nexport async function fetchAllPreferenceTopics(\n  client: GraphQLClient,\n  options: {\n    /** Logger instance */\n    logger: Logger;\n  },\n): Promise<PreferenceTopic[]> {\n  const { logger } = options;\n  const preferenceTopics: PreferenceTopic[] = [];\n  let offset = 0;\n\n  let shouldContinue = false;\n  do {\n    const {\n      preferenceTopics: { nodes },\n    } = await makeGraphQLRequest<{\n      /** Preference topics */\n      preferenceTopics: { /** List */ nodes: PreferenceTopic[] };\n    }>(client, PREFERENCE_TOPICS, {\n      logger,\n      variables: { first: PAGE_SIZE, offset },\n    });\n    preferenceTopics.push(...nodes);\n    offset += PAGE_SIZE;\n    shouldContinue = nodes.length === PAGE_SIZE;\n  } while (shouldContinue);\n\n  return preferenceTopics.sort((a, b) =>\n    `${a.slug}:${a.purpose.trackingType}`.localeCompare(`${b.slug}:${b.purpose.trackingType}`),\n  );\n}\n","import type { Logger } from '@transcend-io/utils';\nimport type { GraphQLClient } from 'graphql-request';\n\nimport { type PreferenceTopic, fetchAllPreferenceTopics } from './fetchAllPreferenceTopics.js';\nimport { type Purpose, fetchAllPurposes } from './fetchAllPurposes.js';\n\nexport interface PurposeWithPreferences extends Purpose {\n  /** Topics */\n  topics: PreferenceTopic[];\n}\n\n/**\n * Fetch all purposes and preferences\n *\n * @param client - GraphQL client\n * @param options - Options\n * @returns List of purposes with their preference topics\n */\nexport async function fetchAllPurposesAndPreferences(\n  client: GraphQLClient,\n  options: { /** Logger instance */ logger: Logger },\n): Promise<PurposeWithPreferences[]> {\n  const [purposes, topics] = await Promise.all([\n    fetchAllPurposes(client, options),\n    fetchAllPreferenceTopics(client, options),\n  ]);\n\n  return purposes.map((purpose) => ({\n    ...purpose,\n    topics: topics.filter((topic) => topic.purpose.trackingType === purpose.trackingType),\n  }));\n}\n","import { parse, type DocumentNode } from 'graphql';\nimport { gql } from 'graphql-request';\n\nexport const CREATE_PREFERENCE_ACCESS_TOKENS: DocumentNode = parse(gql`\n  mutation TranscendCliCreatePreferenceAccessTokens($input: CreatePrivacyCenterAccessTokensInput!) {\n    createPrivacyCenterAccessTokens(input: $input) {\n      nodes {\n        token\n      }\n    }\n  }\n`);\n","import type { SombraStandardScope } from '@transcend-io/privacy-types';\nimport { map, type Logger } from '@transcend-io/utils';\nimport type { GraphQLClient } from 'graphql-request';\nimport { chunk } from 'lodash-es';\n\nimport { makeGraphQLRequest } from '../api/makeGraphQLRequest.js';\nimport { CREATE_PREFERENCE_ACCESS_TOKENS } from './gqls/preferenceAccessTokens.js';\n\nexport interface PreferenceAccessTokenInput {\n  /** Slug of data subject to authenticate as */\n  subjectType: string;\n  /** Scopes to grant */\n  scopes: SombraStandardScope[];\n  /** Expiration time in seconds */\n  expiresIn?: number;\n  /** Email address of user */\n  email: string;\n  /** Core identifier for the user */\n  coreIdentifier?: string;\n}\n\nexport interface PreferenceAccessTokenInputWithIndex extends PreferenceAccessTokenInput {\n  /** Index of the input record */\n  index?: number;\n}\n\nconst MAX_BATCH_SIZE = 50;\n\n/**\n * Create preference access tokens for a single page of identifiers.\n *\n * @param client - GraphQL client\n * @param records - Inputs to sign\n * @param logger - Logger\n * @returns list of access tokens\n */\nasync function createPreferenceAccessTokensPage(\n  client: GraphQLClient,\n  records: PreferenceAccessTokenInput[],\n  logger: Logger,\n): Promise<string[]> {\n  const {\n    createPrivacyCenterAccessTokens: { nodes },\n  } = await makeGraphQLRequest<{\n    /** createPrivacyCenterAccessTokens mutation */\n    createPrivacyCenterAccessTokens: {\n      /** Nodes */\n      nodes: { /** Token */ token: string }[];\n    };\n  }>(client, CREATE_PREFERENCE_ACCESS_TOKENS, {\n    logger,\n    variables: { input: { records } },\n  });\n  return nodes.map((node) => node.token);\n}\n\n/**\n * Create preference access tokens for the given identifiers.\n *\n * @see https://docs.transcend.io/docs/articles/preference-management/access-links\n * @param client - GraphQL client\n * @param options - Options\n * @returns list of access tokens/input identifiers\n */\nexport async function createPreferenceAccessTokens(\n  client: GraphQLClient,\n  options: {\n    /** Records to create tokens for */\n    records: PreferenceAccessTokenInputWithIndex[];\n    /** Logger instance */\n    logger: Logger;\n    /** Optional progress emitter */\n    emitProgress?: (progress: number) => void;\n    /** Number of concurrent requests to make (default: 10) */\n    concurrency?: number;\n  },\n): Promise<\n  {\n    /** Identifier for the record */\n    input: PreferenceAccessTokenInputWithIndex;\n    /** Access token */\n    accessToken: string;\n  }[]\n> {\n  const { records, logger, emitProgress, concurrency = 10 } = options;\n\n  let completed = 0;\n  emitProgress?.(0);\n\n  const results: {\n    /** Identifier for the record */\n    input: PreferenceAccessTokenInput;\n    /** Access token */\n    accessToken: string;\n  }[] = [];\n\n  await map(\n    chunk(records, MAX_BATCH_SIZE),\n    async (chunkedRecords) => {\n      const tokens = await createPreferenceAccessTokensPage(\n        client,\n        // eslint-disable-next-line @typescript-eslint/no-unused-vars\n        chunkedRecords.map(({ index, ...rest }) => rest),\n        logger,\n      );\n      const mappedResults = tokens.map((token, idx) => ({\n        input: chunkedRecords[idx]!,\n        accessToken: token,\n      }));\n      results.push(...mappedResults);\n      completed += chunkedRecords.length;\n      emitProgress?.(completed);\n    },\n    { concurrency },\n  );\n\n  return results;\n}\n","import { describePackageName } from '@transcend-io/utils';\n\nexport interface MonorepoPackageDefinition {\n  directory: string;\n  displayName: string;\n  packageName: string;\n}\n\nexport function createMonorepoPackageDefinition(\n  name: string,\n  directory: string,\n): MonorepoPackageDefinition {\n  const packageNameParts = describePackageName(name);\n\n  return {\n    directory,\n    displayName: packageNameParts.displayName,\n    packageName: `@transcend-io/${packageNameParts.slug}`,\n  };\n}\n\nexport * from './api/index.js';\nexport * from './data-inventory/index.js';\nexport * from './preference-management/index.js';\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@transcend-io/sdk",
+  "version": "0.0.0",
+  "description": "Transcend SDK — shared GraphQL/REST API clients and preference management utilities.",
+  "license": "Apache-2.0",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "@transcend-io/source": "./src/index.ts",
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "check-exports": "attw --pack . --ignore-rules cjs-resolves-to-esm"
+  },
+  "dependencies": {
+    "@transcend-io/airgap.js-types": "^12.16.0",
+    "@transcend-io/privacy-types": "workspace:*",
+    "@transcend-io/utils": "workspace:*",
+    "got": "^11.8.5",
+    "graphql": "^16.6.0",
+    "graphql-request": "^5.0.0",
+    "lodash-es": "^4.17.21"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "catalog:",
+    "@types/lodash-es": "^4.17.12",
+    "@types/node": "catalog:",
+    "tsdown": "catalog:",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  }
+}