@dossier-wiki/cloud-sdk 0.1.0 → 0.2.0-staging.3dda5e6

package/dist/esm/http.js

@@ -0,0 +1,71 @@
+import { DossiersAPIError } from './error.js';
+/** @internal Shared HTTP transport layer injected into every resource class. */
+export class DossiersHttp {
+    constructor(apiKey, baseUrl, fetchImpl) {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl;
+        this.fetchImpl = fetchImpl;
+    }
+    async request(method, path, opts = {}) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        if (opts.query) {
+            for (const [key, value] of Object.entries(opts.query)) {
+                if (value === undefined || value === null)
+                    continue;
+                if (Array.isArray(value)) {
+                    for (const v of value)
+                        url.searchParams.append(key, String(v));
+                }
+                else if (typeof value === 'object') {
+                    url.searchParams.append(key, JSON.stringify(value));
+                }
+                else {
+                    url.searchParams.append(key, String(value));
+                }
+            }
+        }
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            Accept: 'application/json',
+        };
+        let body;
+        if (opts.body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+            body = JSON.stringify(opts.body);
+        }
+        const response = await this.fetchImpl(url.toString(), { method, headers, body });
+        const raw = await response.text();
+        const parsed = raw.length > 0 ? safeJsonParse(raw) : undefined;
+        if (!response.ok) {
+            const message = (parsed && typeof parsed === 'object' && 'message' in parsed
+                ? String(parsed.message)
+                : null) ?? `Dossiers API ${method} ${path} failed: ${response.status}`;
+            throw new DossiersAPIError(response.status, message, parsed ?? raw);
+        }
+        return parsed;
+    }
+    /**
+     * Opens a raw HTTP connection without parsing the response body.
+     * Used for SSE streams and binary file downloads.
+     */
+    stream(path, accept, init) {
+        return this.fetchImpl(`${this.baseUrl}${path}`, {
+            ...init,
+            method: 'GET',
+            headers: {
+                ...(init?.headers ?? {}),
+                Authorization: `Bearer ${this.apiKey}`,
+                Accept: accept,
+            },
+        });
+    }
+}
+function safeJsonParse(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return raw;
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/esm/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.js

@@ -0,0 +1,19 @@
+// API types
+export * from './api.js';
+// Webhook event types & enums
+export * from './types.js';
+// Core service
+export { DossiersAPIService, DossiersAPIError, DOSSIERS_API_BASE_URL } from './service.js';
+// Webhook router
+export { DossiersWebhookRouter } from './webhooks.js';
+// Resource classes (for consumers who want to type method parameters/returns)
+export { AmlResource } from './resources/aml.js';
+export { DocumentsResource } from './resources/documents.js';
+export { FormTemplatesResource } from './resources/form-templates.js';
+export { MediaResource } from './resources/media.js';
+export { KycResource, KycSessionsResource, KycWorkflowsResource } from './resources/kyc/index.js';
+// Customer-facing KYC session client
+export { DossiersKycSession } from './session.js';
+// Zod schemas for runtime validation
+export * as schemas from './schemas/index.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,YAAY;AACZ,cAAc,UAAU,CAAC;AAEzB,8BAA8B;AAC9B,cAAc,YAAY,CAAC;AAE3B,eAAe;AACf,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAG3F,iBAAiB;AACjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAGtD,8EAA8E;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAElG,qCAAqC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD,qCAAqC;AACrC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC"}

package/dist/esm/resources/aml.js

@@ -0,0 +1,84 @@
+/**
+ * AML (Anti-Money Laundering) screening and due-diligence methods.
+ *
+ * Access via `service.aml`.
+ *
+ * @example
+ * ```ts
+ * const hits = await service.aml.searchSanctions({ fullName: 'Jane Smith' });
+ * console.log(hits.totalHits);
+ * ```
+ */
+export class AmlResource {
+    /** @internal */
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Search global sanctions lists (OFAC, UN, FCDO, DFAT, CASL, INTERPOL) for
+     * individuals or entities matching the provided name.
+     *
+     * Costs 5 credits per request.
+     *
+     * @param input - Search criteria including full name and optional filters.
+     * @returns Matching sanction records with source attribution.
+     *
+     * @example
+     * ```ts
+     * const results = await service.aml.searchSanctions({
+     *   fullName: 'John Doe',
+     *   sources: ['ofac', 'un'],
+     *   countries: ['US'],
+     * });
+     * ```
+     */
+    searchSanctions(input) {
+        return this.http.request('POST', '/sanctions/search', { body: input });
+    }
+    /**
+     * Search PEP registries, sanctions lists, and adverse media databases for
+     * individuals matching the provided name. Returns detailed dossiers including
+     * risk scores, positions held, associates, and identification documents.
+     *
+     * @param input - Search criteria. Use `noCache: true` to force a fresh search.
+     * @returns An array of matching individual dossiers with risk scorecards.
+     *
+     * @example
+     * ```ts
+     * const dossiers = await service.aml.searchDossiers({
+     *   fullName: 'Robert Jones',
+     *   onlyShowHighRiskProfiles: true,
+     * });
+     * for (const d of dossiers) {
+     *   console.log(d.fullName, d.riskScorecard?.riskCategory);
+     * }
+     * ```
+     */
+    searchDossiers(input) {
+        return this.http.request('POST', '/high-risk/search', { body: input });
+    }
+    /**
+     * Submit an individual for ongoing background screening against global
+     * sanctions lists, PEP registries, and adverse media databases.
+     *
+     * A webhook event is emitted when the screening completes or when new
+     * alerts are triggered.
+     *
+     * @param input - Individual details for screening.
+     * @returns A screening request ID for tracking status.
+     *
+     * @example
+     * ```ts
+     * const { requestId } = await service.aml.createScreeningRequest({
+     *   fullName: 'Alice Brown',
+     *   externalId: 'cust_123',
+     *   dateOfBirth: '1985-06-15',
+     *   country: 'GB',
+     * });
+     * ```
+     */
+    createScreeningRequest(input) {
+        return this.http.request('POST', '/screening/request', { body: input });
+    }
+}
+//# sourceMappingURL=aml.js.map

package/dist/esm/resources/aml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aml.js","sourceRoot":"","sources":["../../../src/resources/aml.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,WAAW;IACpB,gBAAgB;IAChB,YAA6B,IAAkB;QAAlB,SAAI,GAAJ,IAAI,CAAc;IAAG,CAAC;IAEnD;;;;;;;;;;;;;;;;;OAiBG;IACH,eAAe,CAAC,KAA0B;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,mBAAmB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,cAAc,CAAC,KAAyB;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,mBAAmB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,sBAAsB,CAClB,KAAgC;QAEhC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,oBAAoB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5E,CAAC;CACJ"}

package/dist/esm/resources/documents.js

@@ -0,0 +1,166 @@
+/**
+ * Document processing methods — initiate, track, and retrieve AI-extracted
+ * data from uploaded documents.
+ *
+ * Access via `service.documents`.
+ *
+ * @example
+ * ```ts
+ * const instance = await service.documents.initiate({
+ *   processorId: 'INVOICE',
+ *   files: [{ url: 'https://example.com/invoice.pdf', mimeType: 'application/pdf' }],
+ * });
+ * console.log(instance.instanceId);
+ * ```
+ */
+export class DocumentsResource {
+    /** @internal */
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Initiate a new document processing job.
+     *
+     * By default, processing runs asynchronously in the background — subscribe
+     * to the SSE stream via {@link stream} or listen for webhook events to know
+     * when it completes. Set `backgroundProcessing: false` to wait synchronously.
+     *
+     * The generic parameter `TSchema` narrows the `result.schema` field to a
+     * processor-specific extraction schema for full type safety.
+     *
+     * @param input - Files, processor ID, optional cross-check context, and flags.
+     * @returns The created processing instance (result is `null` until completed).
+     *
+     * @example
+     * ```ts
+     * // Typed extraction schema for Sri Lanka NIC
+     * type SriLankaIdSchema = {
+     *   name: DocumentProcessingTransliteratedField;
+     *   idNumber: DocumentProcessingExtractedField<string>;
+     *   dateOfBirth: DocumentProcessingExtractedField<string>;
+     * };
+     *
+     * const instance = await service.documents.initiate<SriLankaIdSchema>({
+     *   processorId: 'SRI_LANKA_ID',
+     *   files: [{ base64Data: '...', mimeType: 'image/jpeg' }],
+     *   inputData: { name: 'Nimal Perera' },
+     * });
+     * ```
+     */
+    initiate(input) {
+        return this.http.request('POST', '/document-processing', { body: input });
+    }
+    /**
+     * List document processing instances for your organization, with optional
+     * filtering and pagination.
+     *
+     * @param query - Optional filters: `processorId`, `status`, `limit`, `offset`.
+     * @returns A paginated list of instance summaries.
+     *
+     * @example
+     * ```ts
+     * const { instances, count } = await service.documents.list({
+     *   processorId: 'INVOICE',
+     *   status: 'completed',
+     *   limit: 20,
+     * });
+     * ```
+     */
+    list(query = {}) {
+        return this.http.request('GET', '/document-processing', { query });
+    }
+    /**
+     * List all available document processor types registered for your organization.
+     *
+     * @returns An array of processor descriptors including IDs and labels.
+     *
+     * @example
+     * ```ts
+     * const processors = await service.documents.listProcessors();
+     * processors.forEach(p => console.log(p.id, p.label));
+     * ```
+     */
+    listProcessors() {
+        return this.http.request('GET', '/document-processing/processors');
+    }
+    /**
+     * Retrieve the full details of a single document processing instance by ID.
+     *
+     * The generic parameter `TSchema` narrows `result.schema` for processor-specific
+     * type safety — use the same type you passed to {@link initiate}.
+     *
+     * @param id - The `instanceId` returned by {@link initiate}.
+     * @returns The full instance including result once processing is complete.
+     *
+     * @example
+     * ```ts
+     * const instance = await service.documents.get('inst_abc123');
+     * if (instance.status === 'completed') {
+     *   console.log(instance.result?.normalizedData);
+     * }
+     * ```
+     */
+    get(id) {
+        return this.http.request('GET', `/document-processing/${encodeURIComponent(id)}`);
+    }
+    /**
+     * Retrieve the result of a specific processing stage within an instance.
+     * Useful for debugging or inspecting intermediate pipeline results.
+     *
+     * Stage IDs: `crop_and_detect_faces`, `pre_validate_and_extract`, `post_validation`.
+     *
+     * @param id - The `instanceId`.
+     * @param stageId - The stage ID to retrieve.
+     * @returns The stage status and extracted data.
+     *
+     * @example
+     * ```ts
+     * const stage = await service.documents.getStage('inst_abc123', 'post_validation');
+     * console.log(stage.status, stage.data.validation.passed);
+     * ```
+     */
+    getStage(id, stageId) {
+        return this.http.request('GET', `/document-processing/${encodeURIComponent(id)}/stages/${encodeURIComponent(stageId)}`);
+    }
+    /**
+     * Delete a document processing instance and all associated files.
+     *
+     * @param id - The `instanceId` to delete.
+     * @returns A success confirmation.
+     *
+     * @example
+     * ```ts
+     * const { success } = await service.documents.delete('inst_abc123');
+     * ```
+     */
+    delete(id) {
+        return this.http.request('DELETE', `/document-processing/${encodeURIComponent(id)}`);
+    }
+    /**
+     * Open a Server-Sent Events (SSE) stream for real-time stage progress updates
+     * on a document processing instance.
+     *
+     * Returns the raw `Response` — iterate over `response.body` using a
+     * `ReadableStream` reader to consume SSE events.
+     *
+     * @param id - The `instanceId` to stream events for.
+     * @param init - Optional fetch init options (e.g. `signal` for cancellation).
+     * @returns A live SSE `Response` stream.
+     *
+     * @example
+     * ```ts
+     * const res = await service.documents.stream('inst_abc123');
+     * const reader = res.body!.getReader();
+     * const decoder = new TextDecoder();
+     * while (true) {
+     *   const { done, value } = await reader.read();
+     *   if (done) break;
+     *   console.log(decoder.decode(value));
+     * }
+     * ```
+     */
+    stream(id, init) {
+        return this.http.stream(`/document-processing/${encodeURIComponent(id)}/events`, 'text/event-stream', init);
+    }
+}
+//# sourceMappingURL=documents.js.map

package/dist/esm/resources/documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.js","sourceRoot":"","sources":["../../../src/resources/documents.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,iBAAiB;IAC1B,gBAAgB;IAChB,YAA6B,IAAkB;QAAlB,SAAI,GAAJ,IAAI,CAAc;IAAG,CAAC;IAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,QAAQ,CACJ,KAAsC;QAEtC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,sBAAsB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CACA,QAA8C,EAAE;QAEhD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,sBAAsB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;;;;;;;;OAUG;IACH,cAAc;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,iCAAiC,CAAC,CAAC;IACvE,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,GAAG,CACC,EAAU;QAEV,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,wBAAwB,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACtF,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAe;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CACpB,KAAK,EACL,wBAAwB,kBAAkB,CAAC,EAAE,CAAC,WAAW,kBAAkB,CAAC,OAAO,CAAC,EAAE,CACzF,CAAC;IACN,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,wBAAwB,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,CAAC,EAAU,EAAE,IAAkB;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CACnB,wBAAwB,kBAAkB,CAAC,EAAE,CAAC,SAAS,EACvD,mBAAmB,EACnB,IAAI,CACP,CAAC;IACN,CAAC;CACJ"}

package/dist/esm/resources/form-templates.js

@@ -0,0 +1,113 @@
+/**
+ * Form template management — create and manage reusable form schemas for
+ * the `form_collection` KYC workflow step.
+ *
+ * Access via `service.formTemplates`.
+ *
+ * A form template defines the fields (text, select, file upload, etc.) that
+ * customers fill in during a form collection step. Templates can be referenced
+ * by `templateId` in the step's `input.config`, or fields can be defined inline
+ * on the step itself.
+ *
+ * @example
+ * ```ts
+ * const template = await service.formTemplates.create({
+ *   name: 'Employment Details',
+ *   fields: [
+ *     { id: 'employer', type: 'text', label: 'Employer Name', required: true },
+ *     { id: 'salary',   type: 'currency', label: 'Annual Salary', required: true },
+ *   ],
+ * });
+ * ```
+ */
+export class FormTemplatesResource {
+    /** @internal */
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Create a new form template.
+     *
+     * @param input - Template name, optional description, visibility, and field definitions.
+     * @returns The created form template.
+     *
+     * @example
+     * ```ts
+     * const template = await service.formTemplates.create({
+     *   name: 'Address Collection',
+     *   fields: [
+     *     { id: 'street',  type: 'text',    label: 'Street Address', required: true },
+     *     { id: 'city',    type: 'text',    label: 'City',           required: true },
+     *     { id: 'country', type: 'country', label: 'Country',        required: true },
+     *   ],
+     * });
+     * ```
+     */
+    create(input) {
+        return this.http.request('POST', '/form-templates', { body: input });
+    }
+    /**
+     * List form templates available to your organization, with optional
+     * search and pagination.
+     *
+     * @param query - Optional `searchQuery`, `limit`, and `offset`.
+     * @returns A paginated list of template summaries (fields omitted for brevity).
+     *
+     * @example
+     * ```ts
+     * const { templates, totalCount } = await service.formTemplates.list({
+     *   searchQuery: 'address',
+     *   limit: 10,
+     * });
+     * ```
+     */
+    list(query = {}) {
+        return this.http.request('GET', '/form-templates', { query });
+    }
+    /**
+     * Retrieve a single form template by ID, including all field definitions.
+     *
+     * @param id - The template ID.
+     * @returns The full template with fields.
+     *
+     * @example
+     * ```ts
+     * const template = await service.formTemplates.get('tmpl_abc123');
+     * template.fields.forEach(f => console.log(f.id, f.type));
+     * ```
+     */
+    get(id) {
+        return this.http.request('GET', `/form-templates/${encodeURIComponent(id)}`);
+    }
+    /**
+     * Update an existing form template.
+     *
+     * @param id - The template ID to update.
+     * @param input - Fields to update (all optional).
+     * @returns The updated template.
+     *
+     * @example
+     * ```ts
+     * const updated = await service.formTemplates.update('tmpl_abc123', {
+     *   name: 'Updated Address Form',
+     * });
+     * ```
+     */
+    update(id, input) {
+        return this.http.request('PUT', `/form-templates/${encodeURIComponent(id)}`, { body: input });
+    }
+    /**
+     * Delete a form template.
+     *
+     * @param id - The template ID to delete.
+     *
+     * @example
+     * ```ts
+     * await service.formTemplates.delete('tmpl_abc123');
+     * ```
+     */
+    delete(id) {
+        return this.http.request('DELETE', `/form-templates/${encodeURIComponent(id)}`);
+    }
+}
+//# sourceMappingURL=form-templates.js.map

package/dist/esm/resources/form-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-templates.js","sourceRoot":"","sources":["../../../src/resources/form-templates.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,qBAAqB;IAC9B,gBAAgB;IAChB,YAA6B,IAAkB;QAAlB,SAAI,GAAJ,IAAI,CAAc;IAAG,CAAC;IAEnD;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,KAA8B;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,QAAgC,EAAE;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,EAAU;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,mBAAmB,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAU,EAAE,KAA8B;QAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,mBAAmB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAClG,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,mBAAmB,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC;CACJ"}

package/dist/esm/resources/kyc/index.js

@@ -0,0 +1,26 @@
+import { KycSessionsResource } from './sessions.js';
+import { KycWorkflowsResource } from './workflows.js';
+export { KycSessionsResource } from './sessions.js';
+export { KycWorkflowsResource } from './workflows.js';
+/**
+ * KYC (Know Your Customer) namespace — sessions and workflow management.
+ *
+ * Access via `service.kyc`.
+ *
+ * @example
+ * ```ts
+ * // Create a session using an existing workflow
+ * const { sessionUrl } = await service.kyc.sessions.create({ workflowId: 'wf_abc' });
+ *
+ * // Manage workflows
+ * const workflows = await service.kyc.workflows.list();
+ * ```
+ */
+export class KycResource {
+    /** @internal */
+    constructor(http) {
+        this.sessions = new KycSessionsResource(http);
+        this.workflows = new KycWorkflowsResource(http);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/resources/kyc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/resources/kyc/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,WAAW;IAapB,gBAAgB;IAChB,YAAY,IAAkB;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,SAAS,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;CACJ"}

package/dist/esm/resources/kyc/sessions.js

@@ -0,0 +1,99 @@
+/**
+ * KYC session management — create and manage customer verification sessions.
+ *
+ * Access via `service.kyc.sessions`.
+ *
+ * A KYC session represents a single customer verification journey. When created,
+ * the customer receives a `sessionUrl` they visit to complete the configured
+ * workflow steps (identity verification, liveness, form collection, etc.).
+ *
+ * @example
+ * ```ts
+ * const { session, sessionUrl, token } = await service.kyc.sessions.create({
+ *   customer: { name: 'Nimal Perera', email: 'nimal@example.com' },
+ *   workflowId: 'wf_abc123',
+ * });
+ * // Send sessionUrl to the customer
+ * ```
+ */
+export class KycSessionsResource {
+    /** @internal */
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Create a new KYC session for a customer.
+     *
+     * If `customer.email` and `customer.name` are both provided, an invitation
+     * email with the session link is automatically sent to the customer.
+     *
+     * @param input - Session configuration: customer details, expiry, workflow ID.
+     * @returns The created session, a short-lived customer access `token`, and the `sessionUrl`.
+     *
+     * @example
+     * ```ts
+     * const { session, sessionUrl } = await service.kyc.sessions.create({
+     *   customer: { name: 'Alice Brown', email: 'alice@example.com', externalId: 'cust_001' },
+     *   workflowId: 'wf_standard_kyc',
+     *   expiresInMs: 86_400_000, // 24 hours
+     * });
+     * await sendEmail(session.customer.email, sessionUrl);
+     * ```
+     */
+    create(input) {
+        return this.http.request('POST', '/kyc-sessions', { body: input });
+    }
+    /**
+     * List KYC sessions for your organization with optional filtering and pagination.
+     *
+     * @param filters - Optional query filters: `searchQuery`, `checkpoint`, `status`,
+     *   `isComplete`, `isInvalid`, date ranges, and sort/pagination options.
+     * @returns A paginated list of sessions with `totalCount`.
+     *
+     * @example
+     * ```ts
+     * const { sessions, totalCount } = await service.kyc.sessions.list({
+     *   isComplete: true,
+     *   sortBy: 'completedAt',
+     *   sortOrder: 'desc',
+     *   limit: 50,
+     * });
+     * ```
+     */
+    list(filters = {}) {
+        return this.http.request('GET', '/kyc-sessions', { query: filters });
+    }
+    /**
+     * Retrieve a single KYC session by ID.
+     *
+     * The response includes the full session state, per-step submission history,
+     * signed media URLs, and the admin decision record if one has been made.
+     *
+     * @param id - The session ID.
+     * @returns The full session output.
+     *
+     * @example
+     * ```ts
+     * const session = await service.kyc.sessions.get('ses_abc123');
+     * console.log(session.status); // 'complete' | 'in-progress' | ...
+     * ```
+     */
+    get(id) {
+        return this.http.request('GET', `/kyc-sessions/${encodeURIComponent(id)}`);
+    }
+    /**
+     * Delete a KYC session and all associated data.
+     *
+     * @param id - The session ID to delete.
+     * @returns A success confirmation.
+     *
+     * @example
+     * ```ts
+     * const { success } = await service.kyc.sessions.delete('ses_abc123');
+     * ```
+     */
+    delete(id) {
+        return this.http.request('DELETE', `/kyc-sessions/${encodeURIComponent(id)}`);
+    }
+}
+//# sourceMappingURL=sessions.js.map

package/dist/esm/resources/kyc/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../../../src/resources/kyc/sessions.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,mBAAmB;IAC5B,gBAAgB;IAChB,YAA6B,IAAkB;QAAlB,SAAI,GAAJ,IAAI,CAAc;IAAG,CAAC;IAEnD;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,KAA0B;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,CAAC,UAAgC,EAAE;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,GAAG,CAAC,EAAU;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,iBAAiB,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,iBAAiB,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;CACJ"}