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

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

@@ -0,0 +1,146 @@
+/**
+ * KYC workflow management — define the ordered steps customers go through
+ * during a verification session.
+ *
+ * Access via `service.kyc.workflows`.
+ *
+ * A workflow is a reusable template of verification steps (e.g. identity
+ * verification → liveness → form collection). Each step has a type, routing
+ * rules, and an optional config that controls its behavior. When creating a
+ * session, you reference a workflow ID to apply that step sequence.
+ *
+ * Use {@link stepDefaults} to fetch pre-built step configurations for each
+ * step type before building your workflow.
+ *
+ * @example
+ * ```ts
+ * const defaults = await service.kyc.workflows.stepDefaults();
+ * const idStep = defaults.find(d => d.type === 'id_verification');
+ *
+ * const workflow = await service.kyc.workflows.create({
+ *   name: 'Standard KYC',
+ *   steps: [
+ *     {
+ *       stepId: idStep.defaultStepId,
+ *       type: 'id_verification',
+ *       input: idStep.defaultInput,
+ *       output: { schema: idStep.schema },
+ *       rules: idStep.defaultRules as WorkflowRules,
+ *       locales: idStep.defaultLocales,
+ *       skippable: idStep.skippable,
+ *     },
+ *   ],
+ * });
+ * ```
+ */
+export class KycWorkflowsResource {
+    /** @internal */
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Create a new KYC workflow.
+     *
+     * Use the {@link schemas.CreateWorkflowSchema} Zod schema to validate your
+     * input before calling this method — it enforces the discriminated-union
+     * constraint on each step's `type` and `input.config`.
+     *
+     * @param input - Workflow name, description, and ordered array of steps.
+     * @returns The created workflow.
+     *
+     * @example
+     * ```ts
+     * import { schemas } from '@dossier-wiki/cloud-sdk';
+     *
+     * const parsed = schemas.CreateWorkflowSchema.parse(rawInput);
+     * const workflow = await service.kyc.workflows.create(parsed);
+     * ```
+     */
+    create(input) {
+        return this.http.request('POST', '/kyc-workflows', { body: input });
+    }
+    /**
+     * List all KYC workflows available to your organization (own + public).
+     *
+     * @returns An array of workflows.
+     *
+     * @example
+     * ```ts
+     * const workflows = await service.kyc.workflows.list();
+     * workflows.forEach(wf => console.log(wf.id, wf.name, wf.version));
+     * ```
+     */
+    list() {
+        return this.http.request('GET', '/kyc-workflows');
+    }
+    /**
+     * Retrieve a single KYC workflow by ID.
+     *
+     * @param id - The workflow ID.
+     * @returns The full workflow including all steps.
+     *
+     * @example
+     * ```ts
+     * const wf = await service.kyc.workflows.get('wf_abc123');
+     * console.log(wf.steps.map(s => s.type));
+     * ```
+     */
+    get(id) {
+        return this.http.request('GET', `/kyc-workflows/${encodeURIComponent(id)}`);
+    }
+    /**
+     * Update an existing KYC workflow.
+     *
+     * Updating a workflow creates a new version — existing sessions referencing
+     * the old version are not affected.
+     *
+     * @param id - The workflow ID to update.
+     * @param input - Fields to update (all optional).
+     * @returns The updated workflow.
+     *
+     * @example
+     * ```ts
+     * const updated = await service.kyc.workflows.update('wf_abc123', {
+     *   name: 'Enhanced KYC v2',
+     * });
+     * console.log(updated.version); // incremented
+     * ```
+     */
+    update(id, input) {
+        return this.http.request('PUT', `/kyc-workflows/${encodeURIComponent(id)}`, { body: input });
+    }
+    /**
+     * Delete a KYC workflow.
+     *
+     * Only the owning organization can delete a workflow. Workflows referenced
+     * by active sessions cannot be deleted.
+     *
+     * @param id - The workflow ID to delete.
+     *
+     * @example
+     * ```ts
+     * await service.kyc.workflows.delete('wf_old123');
+     * ```
+     */
+    delete(id) {
+        return this.http.request('DELETE', `/kyc-workflows/${encodeURIComponent(id)}`);
+    }
+    /**
+     * Get the default configuration for every available step type.
+     *
+     * Use this to bootstrap a new workflow — each default includes the step's
+     * suggested `input`, `rules`, `locales`, and output `schema`.
+     *
+     * @returns An array of step defaults, one per step type.
+     *
+     * @example
+     * ```ts
+     * const defaults = await service.kyc.workflows.stepDefaults();
+     * const livenessDefault = defaults.find(d => d.type === 'liveness');
+     * ```
+     */
+    stepDefaults() {
+        return this.http.request('GET', '/kyc-workflows/step-defaults');
+    }
+}
+//# sourceMappingURL=workflows.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.js","sourceRoot":"","sources":["../../../../src/resources/kyc/workflows.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,OAAO,oBAAoB;IAC7B,gBAAgB;IAChB,YAA6B,IAAkB;QAAlB,SAAI,GAAJ,IAAI,CAAc;IAAG,CAAC;IAEnD;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,KAA6B;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI;QACA,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,EAAU;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,kBAAkB,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,EAAU,EAAE,KAA6B;QAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,kBAAkB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACjG,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,kBAAkB,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,YAAY;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,8BAA8B,CAAC,CAAC;IACpE,CAAC;CACJ"}

package/dist/esm/resources/media.js

@@ -0,0 +1,58 @@
+/**
+ * Signed media file access.
+ *
+ * Access via `service.media`.
+ *
+ * Media tokens are short-lived signed URLs embedded in session results, document
+ * processing instances, and submission records. Pass the token to {@link get}
+ * to stream the original file bytes.
+ *
+ * @example
+ * ```ts
+ * // Extract a media token from a session step submission
+ * const token = session.result.steps[0].summary?.media[0]?.key;
+ * if (token) {
+ *   const res = await service.media.get(token);
+ *   const blob = await res.blob();
+ * }
+ * ```
+ */
+export class MediaResource {
+    /** @internal */
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Fetch a signed media file by its storage token.
+     *
+     * Returns the raw `Response` so the caller can stream or buffer the binary
+     * payload — e.g. save to disk, pipe to an upload, or convert to a `Blob`.
+     *
+     * Tokens are single-use and expire after a short window. Fetch the token
+     * from a session result or document processing instance immediately before
+     * calling this method.
+     *
+     * @param token - The signed media token from a session or processing result.
+     * @param init - Optional fetch init options (e.g. `signal` for cancellation).
+     * @returns The raw `Response` with binary body.
+     *
+     * @example
+     * ```ts
+     * const res = await service.media.get(token);
+     * if (!res.ok) throw new Error(`Media fetch failed: ${res.status}`);
+     *
+     * // Save to disk (Node.js)
+     * const { Writable } = await import('stream');
+     * const dest = createWriteStream('./document-front.jpg');
+     * Readable.fromWeb(res.body!).pipe(dest);
+     *
+     * // Convert to Blob (browser)
+     * const blob = await res.blob();
+     * const url = URL.createObjectURL(blob);
+     * ```
+     */
+    get(token, init) {
+        return this.http.stream(`/media/${encodeURIComponent(token)}`, '*/*', init);
+    }
+}
+//# sourceMappingURL=media.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../../src/resources/media.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,aAAa;IACtB,gBAAgB;IAChB,YAA6B,IAAkB;QAAlB,SAAI,GAAJ,IAAI,CAAc;IAAG,CAAC;IAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,GAAG,CAAC,KAAa,EAAE,IAAkB;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,kBAAkB,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAChF,CAAC;CACJ"}

package/dist/esm/schemas/index.js

@@ -0,0 +1,2 @@
+export { WorkflowStepSchema, KycStepTypeSchema, CreateWorkflowSchema, UpdateWorkflowSchema, } from './kyc/workflow-steps.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,GACvB,MAAM,yBAAyB,CAAC"}

package/dist/esm/schemas/kyc/workflow-steps.js

@@ -0,0 +1,142 @@
+import { z } from 'zod';
+export const KycStepTypeSchema = z.enum([
+    'id_verification',
+    'document_collection',
+    'liveness',
+    'form_collection',
+    'esignature',
+    'action',
+]);
+const WorkflowRulesSchema = z.object({
+    onSuccess: z.string(), // stepId | 'COMPLETE_SESSION'
+    onFailure: z.string(), // stepId | 'FAIL_SESSION'
+    conditions: z
+        .array(z.object({
+        variable: z.string(),
+        operator: z.enum(['gt', 'lt', 'eq', 'neq']),
+        value: z.unknown(),
+        targetStepId: z.string(),
+    }))
+        .optional(),
+});
+const InputMappingSchema = z.object({
+    target: z.string(),
+    sourceStepId: z.string(),
+    sourcePath: z.string(),
+});
+const DocumentTypeOptionSchema = z
+    .object({
+    id: z.string(),
+    typeId: z.string(),
+    name: z.string(),
+    kind: z.string().nullish(),
+    category: z.string().nullish(),
+    captureProfile: z
+        .object({ method: z.string(), layout: z.string() })
+        .partial()
+        .passthrough()
+        .nullish(),
+    acceptedMimeTypes: z.array(z.string()).optional(),
+})
+    .passthrough();
+const AllowedDocumentsSchema = z.record(z.array(DocumentTypeOptionSchema).min(1));
+const IdVerificationConfigSchema = z.object({
+    strategy: z
+        .enum(['document_based', 'aadhaar_otp', 'nfc'])
+        .default('document_based'),
+    allowedDocuments: AllowedDocumentsSchema.optional(),
+    maxSubmissions: z.union([z.literal(1), z.literal(3), z.literal(4), z.literal(7)]).optional(),
+    allowUpload: z.boolean().optional().default(true),
+});
+const DocumentCollectionConfigSchema = z.object({
+    allowedDocuments: AllowedDocumentsSchema.optional(),
+    allowUpload: z.boolean().optional().default(true),
+    maxSubmissions: z.union([z.literal(1), z.literal(3), z.literal(4), z.literal(7)]).optional(),
+});
+const LivenessConfigSchema = z.object({
+    challengeType: z.enum(['selfie', 'distance']).optional(),
+    timeLimitSeconds: z.number().min(5).max(120).optional(),
+    minFaceLuminance: z.number().min(0).max(255).optional(),
+    minFaceDetectionConfidence: z.number().min(0).max(1).optional(),
+});
+const FormFieldSchema = z.object({
+    id: z.string(),
+    label: z.string(),
+    type: z.enum([
+        'text', 'long_text', 'number', 'currency', 'country', 'language',
+        'email', 'phone', 'date', 'select', 'multi_select', 'dropdown',
+        'toggle', 'boolean', 'file', 'heading', 'paragraph', 'description', 'divider',
+    ]),
+    placeholder: z.string().optional(),
+    helpText: z.string().optional(),
+    required: z.boolean().optional(),
+    content: z.string().optional(),
+    consentText: z.string().optional(),
+    defaultValue: z.unknown().optional(),
+    options: z.array(z.object({ label: z.string(), value: z.string() })).optional(),
+    validation: z.record(z.unknown()).optional(),
+});
+const FormCollectionConfigSchema = z.object({
+    templateId: z.string().nullable().optional(),
+    fields: z.array(FormFieldSchema).optional(),
+});
+const EsignatureConfigSchema = z.object({
+    signatureTypesAllowed: z.array(z.enum(['draw', 'upload'])).min(1),
+});
+const ActionConfigSchema = z.object({
+    actionType: z.enum(['SEND_WEBHOOK', 'EMAIL_USER', 'NOTIFY_COMPLIANCE']),
+});
+// Base fields shared by all step variants
+const baseStep = {
+    stepId: z.string(),
+    rules: WorkflowRulesSchema,
+    output: z.object({ schema: z.record(z.string(), z.unknown()).optional() }),
+    skippable: z.boolean().optional(),
+    locales: z.record(z.string(), z.record(z.string(), z.unknown())).optional(),
+};
+const baseInput = {
+    mapping: z.array(InputMappingSchema).optional(),
+};
+// Discriminated union — each variant narrows input.config to the step-specific type
+export const WorkflowStepSchema = z.discriminatedUnion('type', [
+    z.object({
+        ...baseStep,
+        type: z.literal('id_verification'),
+        input: z.object({ ...baseInput, config: IdVerificationConfigSchema.optional() }),
+    }),
+    z.object({
+        ...baseStep,
+        type: z.literal('document_collection'),
+        input: z.object({ ...baseInput, config: DocumentCollectionConfigSchema.optional() }),
+    }),
+    z.object({
+        ...baseStep,
+        type: z.literal('liveness'),
+        input: z.object({ ...baseInput, config: LivenessConfigSchema.optional() }),
+    }),
+    z.object({
+        ...baseStep,
+        type: z.literal('form_collection'),
+        input: z.object({ ...baseInput, config: FormCollectionConfigSchema.optional() }),
+    }),
+    z.object({
+        ...baseStep,
+        type: z.literal('esignature'),
+        input: z.object({ ...baseInput, config: EsignatureConfigSchema.optional() }),
+    }),
+    z.object({
+        ...baseStep,
+        type: z.literal('action'),
+        input: z.object({ ...baseInput, config: ActionConfigSchema.optional() }),
+    }),
+]);
+export const CreateWorkflowSchema = z.object({
+    name: z.string(),
+    description: z.string().optional(),
+    isPublic: z.boolean().optional(),
+    allowedOrganizations: z.array(z.string()).optional(),
+    defaultConfig: z.record(z.unknown()).optional(),
+    steps: z.array(WorkflowStepSchema),
+});
+export const UpdateWorkflowSchema = CreateWorkflowSchema.partial();
+//# sourceMappingURL=workflow-steps.js.map

package/dist/esm/schemas/kyc/workflow-steps.js.map

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

package/dist/esm/service.js

@@ -0,0 +1,127 @@
+import { DossiersHttp } from './http.js';
+import { AmlResource } from './resources/aml.js';
+import { DocumentsResource } from './resources/documents.js';
+import { FormTemplatesResource } from './resources/form-templates.js';
+import { KycResource } from './resources/kyc/index.js';
+import { MediaResource } from './resources/media.js';
+export { DossiersAPIError } from './error.js';
+/** Default API base URL. Override via `DossiersAPIServiceOptions.baseUrl`. */
+export const DOSSIERS_API_BASE_URL = 'https://api.dossiers.wiki';
+/**
+ * The main entry point for the Dossiers SDK.
+ *
+ * Construct a single instance per application and reuse it — the service
+ * is stateless and safe to share across requests.
+ *
+ * Methods are organized into namespaced resource groups:
+ * - `service.aml` — sanctions search, PEP/adverse media dossiers, ongoing screening
+ * - `service.kyc.sessions` — create and manage customer verification sessions
+ * - `service.kyc.workflows` — define the step sequences customers go through
+ * - `service.documents` — initiate and track AI-powered document processing
+ * - `service.formTemplates` — manage reusable form schemas for form collection steps
+ * - `service.media` — fetch signed media files from sessions and processing results
+ *
+ * @example
+ * ```ts
+ * import { DossiersAPIService } from '@dossier-wiki/cloud-sdk';
+ *
+ * const service = new DossiersAPIService({
+ *   apiKey: process.env.DOSSIERS_API_KEY!,
+ * });
+ *
+ * // AML
+ * const hits = await service.aml.searchSanctions({ fullName: 'John Doe' });
+ *
+ * // KYC
+ * const { sessionUrl } = await service.kyc.sessions.create({
+ *   customer: { name: 'Alice Brown', email: 'alice@example.com' },
+ *   workflowId: 'wf_abc123',
+ * });
+ *
+ * // Document processing
+ * const instance = await service.documents.initiate({
+ *   processorId: 'INVOICE',
+ *   files: [{ url: 'https://example.com/invoice.pdf', mimeType: 'application/pdf' }],
+ * });
+ * ```
+ */
+export class DossiersAPIService {
+    constructor(options) {
+        if (!options.apiKey)
+            throw new Error('DossiersAPIService: apiKey is required');
+        const http = new DossiersHttp(options.apiKey, (options.baseUrl ?? DOSSIERS_API_BASE_URL).replace(/\/$/, ''), options.fetch ?? fetch);
+        this.aml = new AmlResource(http);
+        this.kyc = new KycResource(http);
+        this.documents = new DocumentsResource(http);
+        this.formTemplates = new FormTemplatesResource(http);
+        this.media = new MediaResource(http);
+    }
+    // -----------------------------------------------------------------------
+    // Deprecated flat methods (v0.1 layout)
+    //
+    // The original SDK exposed every operation directly on the service. That
+    // surface grew unwieldy, so v0.2 groups operations into resource namespaces
+    // (`service.aml`, `service.kyc.sessions`, `service.documents`, ...).
+    //
+    // These delegators keep pre-v0.2 code working unchanged. They forward to the
+    // resource methods and add no behaviour of their own — prefer the resource
+    // API for new code. A future major version will remove them.
+    // -----------------------------------------------------------------------
+    /** @deprecated Use `service.aml.searchSanctions()` instead. */
+    searchSanctions(input) {
+        return this.aml.searchSanctions(input);
+    }
+    /** @deprecated Use `service.aml.searchDossiers()` instead. */
+    searchDossiers(input) {
+        return this.aml.searchDossiers(input);
+    }
+    /** @deprecated Use `service.aml.createScreeningRequest()` instead. */
+    createScreeningRequest(input) {
+        return this.aml.createScreeningRequest(input);
+    }
+    /** @deprecated Use `service.kyc.sessions.create()` instead. */
+    createKycSession(input) {
+        return this.kyc.sessions.create(input);
+    }
+    /** @deprecated Use `service.kyc.sessions.list()` instead. */
+    listKycSessions(filters) {
+        return this.kyc.sessions.list(filters);
+    }
+    /** @deprecated Use `service.kyc.sessions.get()` instead. */
+    getKycSession(id) {
+        return this.kyc.sessions.get(id);
+    }
+    /** @deprecated Use `service.kyc.sessions.delete()` instead. */
+    deleteKycSession(id) {
+        return this.kyc.sessions.delete(id);
+    }
+    /** @deprecated Use `service.documents.initiate()` instead. */
+    initiateDocumentProcessing(input) {
+        return this.documents.initiate(input);
+    }
+    /** @deprecated Use `service.documents.list()` instead. */
+    listDocumentProcessingInstances(query) {
+        return this.documents.list(query);
+    }
+    /** @deprecated Use `service.documents.listProcessors()` instead. */
+    listDocumentProcessors() {
+        return this.documents.listProcessors();
+    }
+    /** @deprecated Use `service.documents.get()` instead. */
+    getDocumentProcessingInstance(id) {
+        return this.documents.get(id);
+    }
+    /** @deprecated Use `service.documents.getStage()` instead. */
+    getDocumentProcessingStage(id, stageId) {
+        return this.documents.getStage(id, stageId);
+    }
+    /** @deprecated Use `service.documents.delete()` instead. */
+    deleteDocumentProcessingInstance(id) {
+        return this.documents.delete(id);
+    }
+    /** @deprecated Use `service.documents.stream()` instead. */
+    streamDocumentProcessingEvents(id, init) {
+        return this.documents.stream(id, init);
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/esm/service.js.map

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