assembly-kit 0.0.1

package/dist/bridge-ui/use-secondary-cta.mjs

@@ -0,0 +1,34 @@
+import { AssemblyBridge } from "@assembly-js/app-bridge";
+import { useEffect } from "react";
+//#region src/bridge-ui/use-secondary-cta.ts
+/**
+* Registers a secondary CTA button in the Assembly dashboard header.
+*
+* Uses `AssemblyBridge.header.setSecondaryCta()` to set the button and
+* automatically clears it on unmount or page unload.
+*
+* @param cta - Label, icon, and click handler for the secondary CTA.
+* @param show - Whether the CTA is visible. Defaults to true.
+*/
+const useSecondaryCta = (cta, show = true) => {
+	useEffect(() => {
+		if (show) AssemblyBridge.header.setSecondaryCta(cta);
+		else AssemblyBridge.header.setSecondaryCta(null);
+		return () => {
+			AssemblyBridge.header.setSecondaryCta(null);
+		};
+	}, [cta, show]);
+	useEffect(() => {
+		const handleUnload = () => {
+			AssemblyBridge.header.setSecondaryCta(null);
+		};
+		addEventListener("beforeunload", handleUnload);
+		return () => {
+			removeEventListener("beforeunload", handleUnload);
+		};
+	}, []);
+};
+//#endregion
+export { useSecondaryCta };
+
+//# sourceMappingURL=use-secondary-cta.mjs.map

package/dist/bridge-ui/use-secondary-cta.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-secondary-cta.mjs","names":[],"sources":["../../src/bridge-ui/use-secondary-cta.ts"],"sourcesContent":["import { AssemblyBridge } from \"@assembly-js/app-bridge\";\nimport type { CtaConfig } from \"@assembly-js/app-bridge\";\nimport { useEffect } from \"react\";\n\n/**\n * Registers a secondary CTA button in the Assembly dashboard header.\n *\n * Uses `AssemblyBridge.header.setSecondaryCta()` to set the button and\n * automatically clears it on unmount or page unload.\n *\n * @param cta - Label, icon, and click handler for the secondary CTA.\n * @param show - Whether the CTA is visible. Defaults to true.\n */\nexport const useSecondaryCta = (cta: CtaConfig, show = true): void => {\n  useEffect(() => {\n    if (show) {\n      AssemblyBridge.header.setSecondaryCta(cta);\n    } else {\n      AssemblyBridge.header.setSecondaryCta(null);\n    }\n\n    return () => {\n      AssemblyBridge.header.setSecondaryCta(null);\n    };\n  }, [cta, show]);\n\n  useEffect(() => {\n    const handleUnload = (): void => {\n      AssemblyBridge.header.setSecondaryCta(null);\n    };\n\n    addEventListener(\"beforeunload\", handleUnload);\n\n    return () => {\n      removeEventListener(\"beforeunload\", handleUnload);\n    };\n  }, []);\n};\n"],"mappings":";;;;;;;;;;;;AAaA,MAAa,mBAAmB,KAAgB,OAAO,SAAe;AACpE,iBAAgB;AACd,MAAI,KACF,gBAAe,OAAO,gBAAgB,IAAI;MAE1C,gBAAe,OAAO,gBAAgB,KAAK;AAG7C,eAAa;AACX,kBAAe,OAAO,gBAAgB,KAAK;;IAE5C,CAAC,KAAK,KAAK,CAAC;AAEf,iBAAgB;EACd,MAAM,qBAA2B;AAC/B,kBAAe,OAAO,gBAAgB,KAAK;;AAG7C,mBAAiB,gBAAgB,aAAa;AAE9C,eAAa;AACX,uBAAoB,gBAAgB,aAAa;;IAElD,EAAE,CAAC"}

package/dist/client/index.d.mts

@@ -0,0 +1,108 @@
+import { AppConnectionsResource } from "../lib/modules/app-connections/resource.mjs";
+import { AppInstallsResource } from "../lib/modules/app-installs/resource.mjs";
+import { ClientsResource } from "../lib/modules/clients/resource.mjs";
+import { CompaniesResource } from "../lib/modules/companies/resource.mjs";
+import { ContractTemplatesResource } from "../lib/modules/contract-templates/resource.mjs";
+import { ContractsResource } from "../lib/modules/contracts/resource.mjs";
+import { CustomFieldOptionsResource } from "../lib/modules/custom-field-options/resource.mjs";
+import { CustomFieldsResource } from "../lib/modules/custom-fields/resource.mjs";
+import { EventsResource } from "../lib/modules/events/resource.mjs";
+import { FileChannelsResource } from "../lib/modules/file-channels/resource.mjs";
+import { FilesResource } from "../lib/modules/files/resource.mjs";
+import { FormResponsesResource } from "../lib/modules/form-responses/resource.mjs";
+import { FormsResource } from "../lib/modules/forms/resource.mjs";
+import { InternalUsersResource } from "../lib/modules/internal-users/resource.mjs";
+import { InvoiceTemplatesResource } from "../lib/modules/invoice-templates/resource.mjs";
+import { InvoicesResource } from "../lib/modules/invoices/resource.mjs";
+import { MessageChannelsResource } from "../lib/modules/message-channels/resource.mjs";
+import { MessagesResource } from "../lib/modules/messages/resource.mjs";
+import { NotesResource } from "../lib/modules/notes/resource.mjs";
+import { NotificationsResource } from "../lib/modules/notifications/resource.mjs";
+import { PaymentsResource } from "../lib/modules/payments/resource.mjs";
+import { PricesResource } from "../lib/modules/prices/resource.mjs";
+import { ProductsResource } from "../lib/modules/products/resource.mjs";
+import { SubscriptionTemplatesResource } from "../lib/modules/subscription-templates/resource.mjs";
+import { SubscriptionsResource } from "../lib/modules/subscriptions/resource.mjs";
+import { TaskTemplatesResource } from "../lib/modules/task-templates/resource.mjs";
+import { TasksResource } from "../lib/modules/tasks/resource.mjs";
+import { WorkspaceResource } from "../lib/modules/workspace/resource.mjs";
+import { AssemblyToken, ClientTokenPayload, InternalUserTokenPayload } from "../token/assembly-token.mjs";
+import { AssemblyKitOptions } from "./options.mjs";
+
+//#region src/client/index.d.ts
+/**
+ * Create a new `AssemblyKit` instance. Each call produces an independent client
+ * with its own HTTP transport, rate limiter, and credentials — safe for
+ * multi-workspace and serverless usage.
+ *
+ * Pass an optional `TClientCustomFields` (and optional `TCompanyCustomFields`)
+ * generic to type the `customFields` shape returned from
+ * `kit.clients.*` and `kit.companies.*` endpoints.
+ *
+ * @example
+ * ```ts
+ * // Untyped customFields (default)
+ * const kit = createAssemblyKit({ apiKey, workspaceId });
+ *
+ * // Typed customFields — applies to both clients and companies
+ * const kit = createAssemblyKit<{ roles: string[] }>({ apiKey, workspaceId });
+ * const c = await kit.clients.retrieve("id"); // c.customFields: { roles: string[] } | null | undefined
+ *
+ * // Different shapes per resource
+ * const kit = createAssemblyKit<
+ *   { roles: string[] },
+ *   { industry: string }
+ * >({ apiKey, workspaceId });
+ * ```
+ */
+declare function createAssemblyKit<TClientCustomFields extends Record<string, unknown> = Record<string, unknown>, TCompanyCustomFields extends Record<string, unknown> = TClientCustomFields>(options: AssemblyKitOptions): AssemblyKit<TClientCustomFields, TCompanyCustomFields>;
+/**
+ * Assembly SDK client with typed resource namespaces and Zod response validation.
+ *
+ * Each instance has its own `ky`-based HTTP transport with independent
+ * rate limiting, retry, and auth headers. No shared singletons.
+ *
+ * Generic parameters:
+ * - `TClientCustomFields` — shape of `customFields` on Client responses
+ * - `TCompanyCustomFields` — shape of `customFields` on Company responses (defaults to `TClientCustomFields`)
+ */
+declare class AssemblyKit<TClientCustomFields extends Record<string, unknown> = Record<string, unknown>, TCompanyCustomFields extends Record<string, unknown> = TClientCustomFields> {
+  /** The decrypted AssemblyToken instance, or undefined when no token was provided. */
+  readonly token: AssemblyToken | undefined;
+  readonly appConnections: AppConnectionsResource;
+  readonly appInstalls: AppInstallsResource;
+  readonly clients: ClientsResource<TClientCustomFields>;
+  readonly companies: CompaniesResource<TCompanyCustomFields>;
+  readonly contractTemplates: ContractTemplatesResource;
+  readonly contracts: ContractsResource;
+  readonly customFieldOptions: CustomFieldOptionsResource;
+  readonly customFields: CustomFieldsResource;
+  readonly events: EventsResource;
+  readonly fileChannels: FileChannelsResource;
+  readonly files: FilesResource;
+  readonly formResponses: FormResponsesResource;
+  readonly forms: FormsResource;
+  readonly internalUsers: InternalUsersResource;
+  readonly invoiceTemplates: InvoiceTemplatesResource;
+  readonly invoices: InvoicesResource;
+  readonly messageChannels: MessageChannelsResource;
+  readonly messages: MessagesResource;
+  readonly notes: NotesResource;
+  readonly notifications: NotificationsResource;
+  readonly payments: PaymentsResource;
+  readonly prices: PricesResource;
+  readonly products: ProductsResource;
+  readonly subscriptionTemplates: SubscriptionTemplatesResource;
+  readonly subscriptions: SubscriptionsResource;
+  readonly taskTemplates: TaskTemplatesResource;
+  readonly tasks: TasksResource;
+  readonly workspace: WorkspaceResource;
+  constructor(options: AssemblyKitOptions);
+  /** Assert that a token was provided and belongs to a client user. */
+  ensureIsClient(): ClientTokenPayload;
+  /** Assert that a token was provided and belongs to an internal user. */
+  ensureIsInternalUser(): InternalUserTokenPayload;
+}
+//#endregion
+export { AssemblyKit, type AssemblyKitOptions, createAssemblyKit };
+//# sourceMappingURL=index.d.mts.map

package/dist/client/index.mjs

@@ -0,0 +1,168 @@
+import { AssemblyNoTokenError } from "../errors/no-token.mjs";
+import { AppConnectionsResource } from "../lib/modules/app-connections/resource.mjs";
+import { AppInstallsResource } from "../lib/modules/app-installs/resource.mjs";
+import { ClientsResource } from "../lib/modules/clients/resource.mjs";
+import { CompaniesResource } from "../lib/modules/companies/resource.mjs";
+import { ContractTemplatesResource } from "../lib/modules/contract-templates/resource.mjs";
+import { ContractsResource } from "../lib/modules/contracts/resource.mjs";
+import { CustomFieldOptionsResource } from "../lib/modules/custom-field-options/resource.mjs";
+import { CustomFieldsResource } from "../lib/modules/custom-fields/resource.mjs";
+import { EventsResource } from "../lib/modules/events/resource.mjs";
+import { FileChannelsResource } from "../lib/modules/file-channels/resource.mjs";
+import { FilesResource } from "../lib/modules/files/resource.mjs";
+import { FormResponsesResource } from "../lib/modules/form-responses/resource.mjs";
+import { FormsResource } from "../lib/modules/forms/resource.mjs";
+import { InternalUsersResource } from "../lib/modules/internal-users/resource.mjs";
+import { InvoiceTemplatesResource } from "../lib/modules/invoice-templates/resource.mjs";
+import { InvoicesResource } from "../lib/modules/invoices/resource.mjs";
+import { MessageChannelsResource } from "../lib/modules/message-channels/resource.mjs";
+import { MessagesResource } from "../lib/modules/messages/resource.mjs";
+import { NotesResource } from "../lib/modules/notes/resource.mjs";
+import { NotificationsResource } from "../lib/modules/notifications/resource.mjs";
+import { PaymentsResource } from "../lib/modules/payments/resource.mjs";
+import { PricesResource } from "../lib/modules/prices/resource.mjs";
+import { ProductsResource } from "../lib/modules/products/resource.mjs";
+import { SubscriptionTemplatesResource } from "../lib/modules/subscription-templates/resource.mjs";
+import { SubscriptionsResource } from "../lib/modules/subscriptions/resource.mjs";
+import { TaskTemplatesResource } from "../lib/modules/task-templates/resource.mjs";
+import { TasksResource } from "../lib/modules/tasks/resource.mjs";
+import { WorkspaceResource } from "../lib/modules/workspace/resource.mjs";
+import { AssemblyToken } from "../token/assembly-token.mjs";
+import { createTransport } from "../transport/http.mjs";
+import { SDK_VERSION } from "../version.mjs";
+import { KitMode } from "../constants/kit-mode.mjs";
+//#region src/client/index.ts
+/**
+* Create a new `AssemblyKit` instance. Each call produces an independent client
+* with its own HTTP transport, rate limiter, and credentials — safe for
+* multi-workspace and serverless usage.
+*
+* Pass an optional `TClientCustomFields` (and optional `TCompanyCustomFields`)
+* generic to type the `customFields` shape returned from
+* `kit.clients.*` and `kit.companies.*` endpoints.
+*
+* @example
+* ```ts
+* // Untyped customFields (default)
+* const kit = createAssemblyKit({ apiKey, workspaceId });
+*
+* // Typed customFields — applies to both clients and companies
+* const kit = createAssemblyKit<{ roles: string[] }>({ apiKey, workspaceId });
+* const c = await kit.clients.retrieve("id"); // c.customFields: { roles: string[] } | null | undefined
+*
+* // Different shapes per resource
+* const kit = createAssemblyKit<
+*   { roles: string[] },
+*   { industry: string }
+* >({ apiKey, workspaceId });
+* ```
+*/
+function createAssemblyKit(options) {
+	return new AssemblyKit(options);
+}
+/**
+* Assembly SDK client with typed resource namespaces and Zod response validation.
+*
+* Each instance has its own `ky`-based HTTP transport with independent
+* rate limiting, retry, and auth headers. No shared singletons.
+*
+* Generic parameters:
+* - `TClientCustomFields` — shape of `customFields` on Client responses
+* - `TCompanyCustomFields` — shape of `customFields` on Company responses (defaults to `TClientCustomFields`)
+*/
+var AssemblyKit = class {
+	/** The decrypted AssemblyToken instance, or undefined when no token was provided. */
+	token;
+	appConnections;
+	appInstalls;
+	clients;
+	companies;
+	contractTemplates;
+	contracts;
+	customFieldOptions;
+	customFields;
+	events;
+	fileChannels;
+	files;
+	formResponses;
+	forms;
+	internalUsers;
+	invoiceTemplates;
+	invoices;
+	messageChannels;
+	messages;
+	notes;
+	notifications;
+	payments;
+	prices;
+	products;
+	subscriptionTemplates;
+	subscriptions;
+	taskTemplates;
+	tasks;
+	workspace;
+	constructor(options) {
+		if ((options.kitMode ?? KitMode.Local) === KitMode.Marketplace && !options.token && !options.workspaceId) throw new AssemblyNoTokenError({ message: "Marketplace mode requires either `token` or `workspaceId`." });
+		this.token = options.token ? new AssemblyToken({
+			token: options.token,
+			apiKey: options.apiKey
+		}) : void 0;
+		let compoundKey;
+		if (this.token) compoundKey = this.token.buildCompoundKey({ apiKey: options.apiKey });
+		else if (options.workspaceId) compoundKey = `${options.workspaceId}/${options.apiKey}`;
+		else compoundKey = options.apiKey;
+		const ctx = {
+			transport: createTransport({
+				baseUrl: options.baseUrl,
+				compoundKey,
+				fetch: options.fetch,
+				requestsPerSecond: options.requestsPerSecond,
+				retryCount: options.retryCount,
+				sdkVersion: SDK_VERSION
+			}),
+			validateResponses: options.validateResponses ?? true
+		};
+		this.appConnections = new AppConnectionsResource(ctx);
+		this.appInstalls = new AppInstallsResource(ctx);
+		this.clients = new ClientsResource(ctx);
+		this.companies = new CompaniesResource(ctx);
+		this.contractTemplates = new ContractTemplatesResource(ctx);
+		this.contracts = new ContractsResource(ctx);
+		this.customFieldOptions = new CustomFieldOptionsResource(ctx);
+		this.customFields = new CustomFieldsResource(ctx);
+		this.events = new EventsResource(ctx);
+		this.fileChannels = new FileChannelsResource(ctx);
+		this.files = new FilesResource(ctx);
+		this.formResponses = new FormResponsesResource(ctx);
+		this.forms = new FormsResource(ctx);
+		this.internalUsers = new InternalUsersResource(ctx);
+		this.invoiceTemplates = new InvoiceTemplatesResource(ctx);
+		this.invoices = new InvoicesResource(ctx);
+		this.messageChannels = new MessageChannelsResource(ctx);
+		this.messages = new MessagesResource(ctx);
+		this.notes = new NotesResource(ctx);
+		this.notifications = new NotificationsResource(ctx);
+		this.payments = new PaymentsResource(ctx);
+		this.prices = new PricesResource(ctx);
+		this.products = new ProductsResource(ctx);
+		this.subscriptionTemplates = new SubscriptionTemplatesResource(ctx);
+		this.subscriptions = new SubscriptionsResource(ctx);
+		this.taskTemplates = new TaskTemplatesResource(ctx);
+		this.tasks = new TasksResource(ctx);
+		this.workspace = new WorkspaceResource(ctx);
+	}
+	/** Assert that a token was provided and belongs to a client user. */
+	ensureIsClient() {
+		if (!this.token) throw new AssemblyNoTokenError();
+		return this.token.ensureIsClient();
+	}
+	/** Assert that a token was provided and belongs to an internal user. */
+	ensureIsInternalUser() {
+		if (!this.token) throw new AssemblyNoTokenError();
+		return this.token.ensureIsInternalUser();
+	}
+};
+//#endregion
+export { AssemblyKit, createAssemblyKit };
+
+//# sourceMappingURL=index.mjs.map

package/dist/client/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/client/index.ts"],"sourcesContent":["import { AssemblyNoTokenError } from \"src/errors/no-token\";\nimport { AppConnectionsResource } from \"src/lib/modules/app-connections/resource\";\nimport { AppInstallsResource } from \"src/lib/modules/app-installs/resource\";\nimport { ClientsResource } from \"src/lib/modules/clients/resource\";\nimport { CompaniesResource } from \"src/lib/modules/companies/resource\";\nimport { ContractTemplatesResource } from \"src/lib/modules/contract-templates/resource\";\nimport { ContractsResource } from \"src/lib/modules/contracts/resource\";\nimport { CustomFieldOptionsResource } from \"src/lib/modules/custom-field-options/resource\";\nimport { CustomFieldsResource } from \"src/lib/modules/custom-fields/resource\";\nimport { EventsResource } from \"src/lib/modules/events/resource\";\nimport { FileChannelsResource } from \"src/lib/modules/file-channels/resource\";\nimport { FilesResource } from \"src/lib/modules/files/resource\";\nimport { FormResponsesResource } from \"src/lib/modules/form-responses/resource\";\nimport { FormsResource } from \"src/lib/modules/forms/resource\";\nimport { InternalUsersResource } from \"src/lib/modules/internal-users/resource\";\nimport { InvoiceTemplatesResource } from \"src/lib/modules/invoice-templates/resource\";\nimport { InvoicesResource } from \"src/lib/modules/invoices/resource\";\nimport { MessageChannelsResource } from \"src/lib/modules/message-channels/resource\";\nimport { MessagesResource } from \"src/lib/modules/messages/resource\";\nimport { NotesResource } from \"src/lib/modules/notes/resource\";\nimport { NotificationsResource } from \"src/lib/modules/notifications/resource\";\nimport { PaymentsResource } from \"src/lib/modules/payments/resource\";\nimport { PricesResource } from \"src/lib/modules/prices/resource\";\nimport { ProductsResource } from \"src/lib/modules/products/resource\";\nimport { SubscriptionTemplatesResource } from \"src/lib/modules/subscription-templates/resource\";\nimport { SubscriptionsResource } from \"src/lib/modules/subscriptions/resource\";\nimport { TaskTemplatesResource } from \"src/lib/modules/task-templates/resource\";\nimport { TasksResource } from \"src/lib/modules/tasks/resource\";\nimport { WorkspaceResource } from \"src/lib/modules/workspace/resource\";\nimport {\n  AssemblyToken,\n  type ClientTokenPayload,\n  type InternalUserTokenPayload,\n} from \"src/token/assembly-token\";\nimport { createTransport } from \"src/transport/http\";\nimport { SDK_VERSION } from \"src/version\";\n\nimport { KitMode } from \"src/constants/kit-mode\";\n\nimport type { AssemblyKitOptions } from \"./options\";\n\nexport type { AssemblyKitOptions } from \"./options\";\n\n/**\n * Create a new `AssemblyKit` instance. Each call produces an independent client\n * with its own HTTP transport, rate limiter, and credentials — safe for\n * multi-workspace and serverless usage.\n *\n * Pass an optional `TClientCustomFields` (and optional `TCompanyCustomFields`)\n * generic to type the `customFields` shape returned from\n * `kit.clients.*` and `kit.companies.*` endpoints.\n *\n * @example\n * ```ts\n * // Untyped customFields (default)\n * const kit = createAssemblyKit({ apiKey, workspaceId });\n *\n * // Typed customFields — applies to both clients and companies\n * const kit = createAssemblyKit<{ roles: string[] }>({ apiKey, workspaceId });\n * const c = await kit.clients.retrieve(\"id\"); // c.customFields: { roles: string[] } | null | undefined\n *\n * // Different shapes per resource\n * const kit = createAssemblyKit<\n *   { roles: string[] },\n *   { industry: string }\n * >({ apiKey, workspaceId });\n * ```\n */\nexport function createAssemblyKit<\n  TClientCustomFields extends Record<string, unknown> = Record<string, unknown>,\n  TCompanyCustomFields extends Record<string, unknown> = TClientCustomFields,\n>(options: AssemblyKitOptions): AssemblyKit<TClientCustomFields, TCompanyCustomFields> {\n  return new AssemblyKit<TClientCustomFields, TCompanyCustomFields>(options);\n}\n\n/**\n * Assembly SDK client with typed resource namespaces and Zod response validation.\n *\n * Each instance has its own `ky`-based HTTP transport with independent\n * rate limiting, retry, and auth headers. No shared singletons.\n *\n * Generic parameters:\n * - `TClientCustomFields` — shape of `customFields` on Client responses\n * - `TCompanyCustomFields` — shape of `customFields` on Company responses (defaults to `TClientCustomFields`)\n */\nexport class AssemblyKit<\n  TClientCustomFields extends Record<string, unknown> = Record<string, unknown>,\n  TCompanyCustomFields extends Record<string, unknown> = TClientCustomFields,\n> {\n  /** The decrypted AssemblyToken instance, or undefined when no token was provided. */\n  readonly token: AssemblyToken | undefined;\n  readonly appConnections: AppConnectionsResource;\n  readonly appInstalls: AppInstallsResource;\n  readonly clients: ClientsResource<TClientCustomFields>;\n  readonly companies: CompaniesResource<TCompanyCustomFields>;\n  readonly contractTemplates: ContractTemplatesResource;\n  readonly contracts: ContractsResource;\n  readonly customFieldOptions: CustomFieldOptionsResource;\n  readonly customFields: CustomFieldsResource;\n  readonly events: EventsResource;\n  readonly fileChannels: FileChannelsResource;\n  readonly files: FilesResource;\n  readonly formResponses: FormResponsesResource;\n  readonly forms: FormsResource;\n  readonly internalUsers: InternalUsersResource;\n  readonly invoiceTemplates: InvoiceTemplatesResource;\n  readonly invoices: InvoicesResource;\n  readonly messageChannels: MessageChannelsResource;\n  readonly messages: MessagesResource;\n  readonly notes: NotesResource;\n  readonly notifications: NotificationsResource;\n  readonly payments: PaymentsResource;\n  readonly prices: PricesResource;\n  readonly products: ProductsResource;\n  readonly subscriptionTemplates: SubscriptionTemplatesResource;\n  readonly subscriptions: SubscriptionsResource;\n  readonly taskTemplates: TaskTemplatesResource;\n  readonly tasks: TasksResource;\n  readonly workspace: WorkspaceResource;\n\n  constructor(options: AssemblyKitOptions) {\n    const mode: KitMode = options.kitMode ?? KitMode.Local;\n\n    if (mode === KitMode.Marketplace && !options.token && !options.workspaceId) {\n      throw new AssemblyNoTokenError({\n        message: \"Marketplace mode requires either `token` or `workspaceId`.\",\n      });\n    }\n\n    this.token = options.token\n      ? new AssemblyToken({ token: options.token, apiKey: options.apiKey })\n      : undefined;\n\n    let compoundKey: string;\n    if (this.token) {\n      compoundKey = this.token.buildCompoundKey({ apiKey: options.apiKey });\n    } else if (options.workspaceId) {\n      compoundKey = `${options.workspaceId}/${options.apiKey}`;\n    } else {\n      compoundKey = options.apiKey;\n    }\n\n    const transport = createTransport({\n      baseUrl: options.baseUrl,\n      compoundKey,\n      fetch: options.fetch,\n      requestsPerSecond: options.requestsPerSecond,\n      retryCount: options.retryCount,\n      sdkVersion: SDK_VERSION,\n    });\n\n    const validate: boolean = options.validateResponses ?? true;\n    const ctx = { transport, validateResponses: validate };\n\n    this.appConnections = new AppConnectionsResource(ctx);\n    this.appInstalls = new AppInstallsResource(ctx);\n    this.clients = new ClientsResource<TClientCustomFields>(ctx);\n    this.companies = new CompaniesResource<TCompanyCustomFields>(ctx);\n    this.contractTemplates = new ContractTemplatesResource(ctx);\n    this.contracts = new ContractsResource(ctx);\n    this.customFieldOptions = new CustomFieldOptionsResource(ctx);\n    this.customFields = new CustomFieldsResource(ctx);\n    this.events = new EventsResource(ctx);\n    this.fileChannels = new FileChannelsResource(ctx);\n    this.files = new FilesResource(ctx);\n    this.formResponses = new FormResponsesResource(ctx);\n    this.forms = new FormsResource(ctx);\n    this.internalUsers = new InternalUsersResource(ctx);\n    this.invoiceTemplates = new InvoiceTemplatesResource(ctx);\n    this.invoices = new InvoicesResource(ctx);\n    this.messageChannels = new MessageChannelsResource(ctx);\n    this.messages = new MessagesResource(ctx);\n    this.notes = new NotesResource(ctx);\n    this.notifications = new NotificationsResource(ctx);\n    this.payments = new PaymentsResource(ctx);\n    this.prices = new PricesResource(ctx);\n    this.products = new ProductsResource(ctx);\n    this.subscriptionTemplates = new SubscriptionTemplatesResource(ctx);\n    this.subscriptions = new SubscriptionsResource(ctx);\n    this.taskTemplates = new TaskTemplatesResource(ctx);\n    this.tasks = new TasksResource(ctx);\n    this.workspace = new WorkspaceResource(ctx);\n  }\n\n  /** Assert that a token was provided and belongs to a client user. */\n  ensureIsClient(): ClientTokenPayload {\n    if (!this.token) throw new AssemblyNoTokenError();\n    return this.token.ensureIsClient();\n  }\n\n  /** Assert that a token was provided and belongs to an internal user. */\n  ensureIsInternalUser(): InternalUserTokenPayload {\n    if (!this.token) throw new AssemblyNoTokenError();\n    return this.token.ensureIsInternalUser();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoEA,SAAgB,kBAGd,SAAqF;AACrF,QAAO,IAAI,YAAuD,QAAQ;;;;;;;;;;;;AAa5E,IAAa,cAAb,MAGE;;CAEA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA,YAAY,SAA6B;AAGvC,OAFsB,QAAQ,WAAW,QAAQ,WAEpC,QAAQ,eAAe,CAAC,QAAQ,SAAS,CAAC,QAAQ,YAC7D,OAAM,IAAI,qBAAqB,EAC7B,SAAS,8DACV,CAAC;AAGJ,OAAK,QAAQ,QAAQ,QACjB,IAAI,cAAc;GAAE,OAAO,QAAQ;GAAO,QAAQ,QAAQ;GAAQ,CAAC,GACnE,KAAA;EAEJ,IAAI;AACJ,MAAI,KAAK,MACP,eAAc,KAAK,MAAM,iBAAiB,EAAE,QAAQ,QAAQ,QAAQ,CAAC;WAC5D,QAAQ,YACjB,eAAc,GAAG,QAAQ,YAAY,GAAG,QAAQ;MAEhD,eAAc,QAAQ;EAaxB,MAAM,MAAM;GAAE,WAVI,gBAAgB;IAChC,SAAS,QAAQ;IACjB;IACA,OAAO,QAAQ;IACf,mBAAmB,QAAQ;IAC3B,YAAY,QAAQ;IACpB,YAAY;IACb,CAGsB;GAAE,mBADC,QAAQ,qBAAqB;GACD;AAEtD,OAAK,iBAAiB,IAAI,uBAAuB,IAAI;AACrD,OAAK,cAAc,IAAI,oBAAoB,IAAI;AAC/C,OAAK,UAAU,IAAI,gBAAqC,IAAI;AAC5D,OAAK,YAAY,IAAI,kBAAwC,IAAI;AACjE,OAAK,oBAAoB,IAAI,0BAA0B,IAAI;AAC3D,OAAK,YAAY,IAAI,kBAAkB,IAAI;AAC3C,OAAK,qBAAqB,IAAI,2BAA2B,IAAI;AAC7D,OAAK,eAAe,IAAI,qBAAqB,IAAI;AACjD,OAAK,SAAS,IAAI,eAAe,IAAI;AACrC,OAAK,eAAe,IAAI,qBAAqB,IAAI;AACjD,OAAK,QAAQ,IAAI,cAAc,IAAI;AACnC,OAAK,gBAAgB,IAAI,sBAAsB,IAAI;AACnD,OAAK,QAAQ,IAAI,cAAc,IAAI;AACnC,OAAK,gBAAgB,IAAI,sBAAsB,IAAI;AACnD,OAAK,mBAAmB,IAAI,yBAAyB,IAAI;AACzD,OAAK,WAAW,IAAI,iBAAiB,IAAI;AACzC,OAAK,kBAAkB,IAAI,wBAAwB,IAAI;AACvD,OAAK,WAAW,IAAI,iBAAiB,IAAI;AACzC,OAAK,QAAQ,IAAI,cAAc,IAAI;AACnC,OAAK,gBAAgB,IAAI,sBAAsB,IAAI;AACnD,OAAK,WAAW,IAAI,iBAAiB,IAAI;AACzC,OAAK,SAAS,IAAI,eAAe,IAAI;AACrC,OAAK,WAAW,IAAI,iBAAiB,IAAI;AACzC,OAAK,wBAAwB,IAAI,8BAA8B,IAAI;AACnE,OAAK,gBAAgB,IAAI,sBAAsB,IAAI;AACnD,OAAK,gBAAgB,IAAI,sBAAsB,IAAI;AACnD,OAAK,QAAQ,IAAI,cAAc,IAAI;AACnC,OAAK,YAAY,IAAI,kBAAkB,IAAI;;;CAI7C,iBAAqC;AACnC,MAAI,CAAC,KAAK,MAAO,OAAM,IAAI,sBAAsB;AACjD,SAAO,KAAK,MAAM,gBAAgB;;;CAIpC,uBAAiD;AAC/C,MAAI,CAAC,KAAK,MAAO,OAAM,IAAI,sBAAsB;AACjD,SAAO,KAAK,MAAM,sBAAsB"}

package/dist/client/options.d.mts

@@ -0,0 +1,40 @@
+import { KitMode } from "../constants/kit-mode.mjs";
+
+//#region src/client/options.d.ts
+/**
+ * Options for `createAssemblyKit()`.
+ *
+ * - `kitMode: "local"` (default) → only `apiKey` required. `workspaceId` and `token` are optional.
+ * - `kitMode: "marketplace"` → either `token` or `workspaceId` must be provided.
+ * - When `token` is provided, compound key is built from the decrypted token payload.
+ * - When only `workspaceId` is provided, compound key is `workspaceId/apiKey`.
+ * - When neither is provided (local mode), compound key is just `apiKey`.
+ */
+interface AssemblyKitOptions {
+  /** Assembly API key. */
+  apiKey: string;
+  /** Encrypted token from Assembly. */
+  token?: string;
+  /** Workspace ID. Optional — used to build compound key when token is not provided. */
+  workspaceId?: string;
+  /**
+   * App mode.
+   * - `"local"` — only `apiKey` required. `workspaceId` and `token` optional.
+   * - `"marketplace"` — either `token` or `workspaceId` required.
+   * @default "local"
+   */
+  kitMode?: KitMode;
+  /** When true, API responses are validated through Zod schemas. @default true */
+  validateResponses?: boolean;
+  /** Base URL for all API requests. @default "https://api.assembly.com" */
+  baseUrl?: string;
+  /** Number of retry attempts for retryable errors. @default 2 */
+  retryCount?: number;
+  /** Maximum requests per second for the rate limiter. @default 20 */
+  requestsPerSecond?: number;
+  /** Injectable fetch function for testing. Defaults to global fetch. */
+  fetch?: typeof globalThis.fetch;
+}
+//#endregion
+export { AssemblyKitOptions };
+//# sourceMappingURL=options.d.mts.map

package/dist/constants/kit-mode.d.mts

@@ -0,0 +1,15 @@
+//#region src/constants/kit-mode.d.ts
+/**
+ * App mode for `createAssemblyKit()`.
+ *
+ * - `"local"` — regular custom apps built for specific workspaces. `workspaceId` is required, `token` is optional.
+ * - `"marketplace"` — marketplace apps installable by any consumer. Either `token` or `workspaceId` is required.
+ */
+declare const KitMode: {
+  readonly Local: "local";
+  readonly Marketplace: "marketplace";
+};
+type KitMode = (typeof KitMode)[keyof typeof KitMode];
+//#endregion
+export { KitMode };
+//# sourceMappingURL=kit-mode.d.mts.map

package/dist/constants/kit-mode.mjs

@@ -0,0 +1,15 @@
+//#region src/constants/kit-mode.ts
+/**
+* App mode for `createAssemblyKit()`.
+*
+* - `"local"` — regular custom apps built for specific workspaces. `workspaceId` is required, `token` is optional.
+* - `"marketplace"` — marketplace apps installable by any consumer. Either `token` or `workspaceId` is required.
+*/
+const KitMode = {
+	Local: "local",
+	Marketplace: "marketplace"
+};
+//#endregion
+export { KitMode };
+
+//# sourceMappingURL=kit-mode.mjs.map

package/dist/constants/kit-mode.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"kit-mode.mjs","names":[],"sources":["../../src/constants/kit-mode.ts"],"sourcesContent":["/**\n * App mode for `createAssemblyKit()`.\n *\n * - `\"local\"` — regular custom apps built for specific workspaces. `workspaceId` is required, `token` is optional.\n * - `\"marketplace\"` — marketplace apps installable by any consumer. Either `token` or `workspaceId` is required.\n */\nexport const KitMode = {\n  Local: \"local\",\n  Marketplace: \"marketplace\",\n} as const;\n\nexport type KitMode = (typeof KitMode)[keyof typeof KitMode];\n"],"mappings":";;;;;;;AAMA,MAAa,UAAU;CACrB,OAAO;CACP,aAAa;CACd"}

package/dist/errors/base.d.mts

@@ -0,0 +1,29 @@
+//#region src/errors/base.d.ts
+interface AssemblyErrorOptions {
+  /**
+   * Override the default message for this error class.
+   * Each subclass provides a sensible default, so this is rarely needed.
+   */
+  message?: string;
+  /** The original error that caused this one, forwarded to native Error.cause. */
+  cause?: unknown;
+  /** Arbitrary extra context (e.g. raw response body) for debugging. */
+  details?: unknown;
+}
+interface AssemblyBaseErrorInit extends AssemblyErrorOptions {
+  message: string;
+  statusCode: number;
+}
+declare class AssemblyError extends Error {
+  readonly statusCode: number;
+  readonly details?: unknown;
+  constructor({
+    message,
+    statusCode,
+    cause,
+    details
+  }: AssemblyBaseErrorInit);
+}
+//#endregion
+export { AssemblyError, AssemblyErrorOptions };
+//# sourceMappingURL=base.d.mts.map

package/dist/errors/base.mjs

@@ -0,0 +1,16 @@
+//#region src/errors/base.ts
+var AssemblyError = class extends Error {
+	statusCode;
+	details;
+	constructor({ message, statusCode, cause, details }) {
+		super(message, { cause });
+		this.name = "AssemblyError";
+		this.statusCode = statusCode;
+		this.details = details;
+		Object.setPrototypeOf(this, new.target.prototype);
+	}
+};
+//#endregion
+export { AssemblyError };
+
+//# sourceMappingURL=base.mjs.map

package/dist/errors/base.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.mjs","names":[],"sources":["../../src/errors/base.ts"],"sourcesContent":["export interface AssemblyErrorOptions {\n  /**\n   * Override the default message for this error class.\n   * Each subclass provides a sensible default, so this is rarely needed.\n   */\n  message?: string;\n  /** The original error that caused this one, forwarded to native Error.cause. */\n  cause?: unknown;\n  /** Arbitrary extra context (e.g. raw response body) for debugging. */\n  details?: unknown;\n}\n\ninterface AssemblyBaseErrorInit extends AssemblyErrorOptions {\n  message: string;\n  statusCode: number;\n}\n\nexport class AssemblyError extends Error {\n  readonly statusCode: number;\n  readonly details?: unknown;\n\n  constructor({ message, statusCode, cause, details }: AssemblyBaseErrorInit) {\n    super(message, { cause });\n    this.name = \"AssemblyError\";\n    this.statusCode = statusCode;\n    this.details = details;\n    // Maintains proper prototype chain in environments that transpile to ES5\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n"],"mappings":";AAiBA,IAAa,gBAAb,cAAmC,MAAM;CACvC;CACA;CAEA,YAAY,EAAE,SAAS,YAAY,OAAO,WAAkC;AAC1E,QAAM,SAAS,EAAE,OAAO,CAAC;AACzB,OAAK,OAAO;AACZ,OAAK,aAAa;AAClB,OAAK,UAAU;AAEf,SAAO,eAAe,MAAM,IAAI,OAAO,UAAU"}

package/dist/errors/connection.d.mts

@@ -0,0 +1,12 @@
+import { AssemblyError, AssemblyErrorOptions } from "./base.mjs";
+
+//#region src/errors/connection.d.ts
+declare class AssemblyConnectionError extends AssemblyError {
+  constructor({
+    message,
+    ...rest
+  }?: AssemblyErrorOptions);
+}
+//#endregion
+export { AssemblyConnectionError };
+//# sourceMappingURL=connection.d.mts.map

package/dist/errors/connection.mjs

@@ -0,0 +1,16 @@
+import { AssemblyError } from "./base.mjs";
+//#region src/errors/connection.ts
+var AssemblyConnectionError = class extends AssemblyError {
+	constructor({ message, ...rest } = {}) {
+		super({
+			message: message ?? "A network error occurred while connecting to the Assembly API",
+			statusCode: 503,
+			...rest
+		});
+		this.name = "AssemblyConnectionError";
+	}
+};
+//#endregion
+export { AssemblyConnectionError };
+
+//# sourceMappingURL=connection.mjs.map

package/dist/errors/connection.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.mjs","names":[],"sources":["../../src/errors/connection.ts"],"sourcesContent":["import type { AssemblyErrorOptions } from \"src/errors/base\";\nimport { AssemblyError } from \"src/errors/base\";\n\nexport class AssemblyConnectionError extends AssemblyError {\n  constructor({ message, ...rest }: AssemblyErrorOptions = {}) {\n    super({\n      message: message ?? \"A network error occurred while connecting to the Assembly API\",\n      statusCode: 503,\n      ...rest,\n    });\n    this.name = \"AssemblyConnectionError\";\n  }\n}\n"],"mappings":";;AAGA,IAAa,0BAAb,cAA6C,cAAc;CACzD,YAAY,EAAE,SAAS,GAAG,SAA+B,EAAE,EAAE;AAC3D,QAAM;GACJ,SAAS,WAAW;GACpB,YAAY;GACZ,GAAG;GACJ,CAAC;AACF,OAAK,OAAO"}

package/dist/errors/forbidden.d.mts

@@ -0,0 +1,12 @@
+import { AssemblyError, AssemblyErrorOptions } from "./base.mjs";
+
+//#region src/errors/forbidden.d.ts
+declare class AssemblyForbiddenError extends AssemblyError {
+  constructor({
+    message,
+    ...rest
+  }?: AssemblyErrorOptions);
+}
+//#endregion
+export { AssemblyForbiddenError };
+//# sourceMappingURL=forbidden.d.mts.map

package/dist/errors/forbidden.mjs

@@ -0,0 +1,16 @@
+import { AssemblyError } from "./base.mjs";
+//#region src/errors/forbidden.ts
+var AssemblyForbiddenError = class extends AssemblyError {
+	constructor({ message, ...rest } = {}) {
+		super({
+			message: message ?? "Forbidden: the API key lacks permission to perform this action",
+			statusCode: 403,
+			...rest
+		});
+		this.name = "AssemblyForbiddenError";
+	}
+};
+//#endregion
+export { AssemblyForbiddenError };
+
+//# sourceMappingURL=forbidden.mjs.map

package/dist/errors/forbidden.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"forbidden.mjs","names":[],"sources":["../../src/errors/forbidden.ts"],"sourcesContent":["import { AssemblyError } from \"src/errors/base\";\nimport type { AssemblyErrorOptions } from \"src/errors/base\";\n\nexport class AssemblyForbiddenError extends AssemblyError {\n  constructor({ message, ...rest }: AssemblyErrorOptions = {}) {\n    super({\n      message: message ?? \"Forbidden: the API key lacks permission to perform this action\",\n      statusCode: 403,\n      ...rest,\n    });\n    this.name = \"AssemblyForbiddenError\";\n  }\n}\n"],"mappings":";;AAGA,IAAa,yBAAb,cAA4C,cAAc;CACxD,YAAY,EAAE,SAAS,GAAG,SAA+B,EAAE,EAAE;AAC3D,QAAM;GACJ,SAAS,WAAW;GACpB,YAAY;GACZ,GAAG;GACJ,CAAC;AACF,OAAK,OAAO"}

package/dist/errors/index.d.mts

@@ -0,0 +1,13 @@
+import { AssemblyError, AssemblyErrorOptions } from "./base.mjs";
+import { AssemblyConnectionError } from "./connection.mjs";
+import { AssemblyForbiddenError } from "./forbidden.mjs";
+import { AssemblyInvalidTokenError } from "./invalid-token.mjs";
+import { AssemblyMissingApiKeyError } from "./missing-api-key.mjs";
+import { AssemblyNoTokenError } from "./no-token.mjs";
+import { AssemblyNotFoundError } from "./not-found.mjs";
+import { AssemblyRateLimitError, AssemblyRateLimitErrorOptions } from "./rate-limit.mjs";
+import { AssemblyResponseParseError, AssemblyResponseParseErrorOptions } from "./response-parse.mjs";
+import { AssemblyServerError } from "./server.mjs";
+import { AssemblyUnauthorizedError } from "./unauthorized.mjs";
+import { AssemblyValidationError } from "./validation.mjs";
+export { AssemblyConnectionError, AssemblyError, type AssemblyErrorOptions, AssemblyForbiddenError, AssemblyInvalidTokenError, AssemblyMissingApiKeyError, AssemblyNoTokenError, AssemblyNotFoundError, AssemblyRateLimitError, type AssemblyRateLimitErrorOptions, AssemblyResponseParseError, type AssemblyResponseParseErrorOptions, AssemblyServerError, AssemblyUnauthorizedError, AssemblyValidationError };

package/dist/errors/index.mjs

@@ -0,0 +1,13 @@
+import { AssemblyError } from "./base.mjs";
+import { AssemblyNoTokenError } from "./no-token.mjs";
+import { AssemblyResponseParseError } from "./response-parse.mjs";
+import { AssemblyInvalidTokenError } from "./invalid-token.mjs";
+import { AssemblyUnauthorizedError } from "./unauthorized.mjs";
+import { AssemblyConnectionError } from "./connection.mjs";
+import { AssemblyForbiddenError } from "./forbidden.mjs";
+import { AssemblyNotFoundError } from "./not-found.mjs";
+import { AssemblyRateLimitError } from "./rate-limit.mjs";
+import { AssemblyServerError } from "./server.mjs";
+import { AssemblyValidationError } from "./validation.mjs";
+import { AssemblyMissingApiKeyError } from "./missing-api-key.mjs";
+export { AssemblyConnectionError, AssemblyError, AssemblyForbiddenError, AssemblyInvalidTokenError, AssemblyMissingApiKeyError, AssemblyNoTokenError, AssemblyNotFoundError, AssemblyRateLimitError, AssemblyResponseParseError, AssemblyServerError, AssemblyUnauthorizedError, AssemblyValidationError };

package/dist/errors/invalid-token.d.mts

@@ -0,0 +1,12 @@
+import { AssemblyError, AssemblyErrorOptions } from "./base.mjs";
+
+//#region src/errors/invalid-token.d.ts
+declare class AssemblyInvalidTokenError extends AssemblyError {
+  constructor({
+    message,
+    ...rest
+  }?: AssemblyErrorOptions);
+}
+//#endregion
+export { AssemblyInvalidTokenError };
+//# sourceMappingURL=invalid-token.d.mts.map

package/dist/errors/invalid-token.mjs

@@ -0,0 +1,16 @@
+import { AssemblyError } from "./base.mjs";
+//#region src/errors/invalid-token.ts
+var AssemblyInvalidTokenError = class extends AssemblyError {
+	constructor({ message, ...rest } = {}) {
+		super({
+			message: message ?? "The provided token could not be decrypted or has an invalid payload",
+			statusCode: 401,
+			...rest
+		});
+		this.name = "AssemblyInvalidTokenError";
+	}
+};
+//#endregion
+export { AssemblyInvalidTokenError };
+
+//# sourceMappingURL=invalid-token.mjs.map

package/dist/errors/invalid-token.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalid-token.mjs","names":[],"sources":["../../src/errors/invalid-token.ts"],"sourcesContent":["import { AssemblyError } from \"src/errors/base\";\nimport type { AssemblyErrorOptions } from \"src/errors/base\";\n\nexport class AssemblyInvalidTokenError extends AssemblyError {\n  constructor({ message, ...rest }: AssemblyErrorOptions = {}) {\n    super({\n      message: message ?? \"The provided token could not be decrypted or has an invalid payload\",\n      statusCode: 401,\n      ...rest,\n    });\n    this.name = \"AssemblyInvalidTokenError\";\n  }\n}\n"],"mappings":";;AAGA,IAAa,4BAAb,cAA+C,cAAc;CAC3D,YAAY,EAAE,SAAS,GAAG,SAA+B,EAAE,EAAE;AAC3D,QAAM;GACJ,SAAS,WAAW;GACpB,YAAY;GACZ,GAAG;GACJ,CAAC;AACF,OAAK,OAAO"}

package/dist/errors/missing-api-key.d.mts

@@ -0,0 +1,12 @@
+import { AssemblyError, AssemblyErrorOptions } from "./base.mjs";
+
+//#region src/errors/missing-api-key.d.ts
+declare class AssemblyMissingApiKeyError extends AssemblyError {
+  constructor({
+    message,
+    ...rest
+  }?: AssemblyErrorOptions);
+}
+//#endregion
+export { AssemblyMissingApiKeyError };
+//# sourceMappingURL=missing-api-key.d.mts.map

package/dist/errors/missing-api-key.mjs

@@ -0,0 +1,16 @@
+import { AssemblyError } from "./base.mjs";
+//#region src/errors/missing-api-key.ts
+var AssemblyMissingApiKeyError = class extends AssemblyError {
+	constructor({ message, ...rest } = {}) {
+		super({
+			message: message ?? "Assembly API key is missing or empty",
+			statusCode: 400,
+			...rest
+		});
+		this.name = "AssemblyMissingApiKeyError";
+	}
+};
+//#endregion
+export { AssemblyMissingApiKeyError };
+
+//# sourceMappingURL=missing-api-key.mjs.map