cantonjs 0.0.1

package/dist/cjs/clients/createLedgerClient.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Factory for creating a party-scoped Ledger API client.
+ *
+ * The LedgerClient provides contract operations: create, exercise, query.
+ * Each client is scoped to a party via its JWT token.
+ *
+ * Request/response shapes match the Canton JSON Ledger API V2 OpenAPI spec (3.4+).
+ */
+import type { Transport } from '../transport/types.js';
+import type { Party } from '../types/party.js';
+import type { CreatedEvent, ActiveContract } from '../types/contract.js';
+import type { JsTransaction } from '../types/transaction.js';
+import type { Reassignment, ReassignmentCommand } from '../types/reassignment.js';
+import type { PrepareSubmissionResponse, PartySignatures } from '../types/interactive.js';
+import type { LedgerOffset, EventFormat } from '../types/command.js';
+export type LedgerClientConfig = {
+    /** Transport to communicate with the Canton node. */
+    readonly transport: Transport;
+    /** The party this client acts as. */
+    readonly actAs: Party;
+    /** Additional parties this client can read as. */
+    readonly readAs?: readonly Party[];
+};
+export type LedgerClient = {
+    /** The party this client acts as. */
+    readonly actAs: Party;
+    /** Additional parties this client can read as. */
+    readonly readAs: readonly Party[];
+    /** Create a new contract on the ledger. */
+    createContract: (templateId: string, createArguments: Record<string, unknown>, options?: CommandOptions) => Promise<CreatedEvent>;
+    /** Exercise a choice on an existing contract. */
+    exerciseChoice: (templateId: string, contractId: string, choice: string, choiceArgument: Record<string, unknown>, options?: CommandOptions) => Promise<JsTransaction>;
+    /** Query active contracts matching a template. */
+    queryContracts: (templateId: string, options?: QueryOptions) => Promise<readonly ActiveContract[]>;
+    /** Get a transaction by its update ID. */
+    getTransactionById: (updateId: string) => Promise<JsTransaction>;
+    /** Get the current ledger end offset. */
+    getLedgerEnd: () => Promise<LedgerOffset>;
+    /** Get events for a specific contract. */
+    getEventsByContractId: (contractId: string) => Promise<unknown>;
+    /** Get connected synchronizer IDs. */
+    getConnectedSynchronizers: () => Promise<readonly ConnectedSynchronizer[]>;
+    /** Get the latest pruned offsets. */
+    getLatestPrunedOffsets: () => Promise<PrunedOffsets>;
+    /** Submit a reassignment command and wait for completion. */
+    submitReassignment: (command: ReassignmentCommand, options?: CommandOptions) => Promise<Reassignment>;
+    /**
+     * Prepare a transaction for external signing.
+     * Returns the prepared transaction and hash to sign.
+     */
+    prepareSubmission: (templateId: string, createArguments: Record<string, unknown>, options?: CommandOptions) => Promise<PrepareSubmissionResponse>;
+    /**
+     * Execute a previously prepared and externally signed transaction.
+     */
+    executeSubmission: (preparedTransaction: string, partySignatures: readonly PartySignatures[], options?: {
+        readonly submissionId?: string;
+        readonly signal?: AbortSignal;
+    }) => Promise<JsTransaction>;
+};
+/** A connected synchronizer (domain). */
+export type ConnectedSynchronizer = {
+    readonly synchronizerId: string;
+    readonly permission: 'SUBMISSION' | 'OBSERVATION' | 'UNSPECIFIED';
+};
+/** Pruned offset information. */
+export type PrunedOffsets = {
+    readonly participantPrunedUpToInclusive?: number;
+    readonly allDivulgedContractsPrunedUpToInclusive?: number;
+};
+export type CommandOptions = {
+    readonly commandId?: string;
+    readonly workflowId?: string;
+    readonly signal?: AbortSignal;
+};
+export type QueryOptions = {
+    readonly signal?: AbortSignal;
+    /** Event format for filtering. Defaults to verbose wildcard filter for actAs party. */
+    readonly eventFormat?: EventFormat;
+    /** Offset to snapshot at. 0 = empty ledger. Defaults to 0. */
+    readonly activeAtOffset?: LedgerOffset;
+};
+export declare function createLedgerClient(config: LedgerClientConfig): LedgerClient;
+//# sourceMappingURL=createLedgerClient.d.ts.map

package/dist/cjs/clients/createLedgerClient.d.ts.map

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

package/dist/cjs/clients/createLedgerClient.js

@@ -0,0 +1,240 @@
+"use strict";
+/**
+ * Factory for creating a party-scoped Ledger API client.
+ *
+ * The LedgerClient provides contract operations: create, exercise, query.
+ * Each client is scoped to a party via its JWT token.
+ *
+ * Request/response shapes match the Canton JSON Ledger API V2 OpenAPI spec (3.4+).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLedgerClient = createLedgerClient;
+/** Generate a random UUID, compatible with Node.js 18+ and browsers. */
+function generateUUID() {
+    if (typeof globalThis.crypto?.randomUUID === 'function') {
+        return globalThis.crypto.randomUUID();
+    }
+    // Fallback for Node.js 18 where globalThis.crypto.randomUUID may not exist
+    const bytes = new Uint8Array(16);
+    if (typeof globalThis.crypto?.getRandomValues === 'function') {
+        globalThis.crypto.getRandomValues(bytes);
+    }
+    else {
+        for (let i = 0; i < 16; i++)
+            bytes[i] = Math.floor(Math.random() * 256);
+    }
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('');
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+function createLedgerClient(config) {
+    const { transport, actAs, readAs = [] } = config;
+    function defaultEventFormat() {
+        return {
+            filtersByParty: {
+                [actAs]: {
+                    cumulative: [
+                        {
+                            identifierFilter: {
+                                WildcardFilter: { value: { includeCreatedEventBlob: false } },
+                            },
+                        },
+                    ],
+                },
+            },
+            verbose: true,
+        };
+    }
+    function templateEventFormat(templateId) {
+        return {
+            filtersByParty: {
+                [actAs]: {
+                    cumulative: [
+                        {
+                            identifierFilter: {
+                                TemplateFilter: {
+                                    value: { templateId, includeCreatedEventBlob: false },
+                                },
+                            },
+                        },
+                    ],
+                },
+            },
+            verbose: true,
+        };
+    }
+    function defaultTransactionFormat() {
+        return {
+            transactionShape: 'TRANSACTION_SHAPE_ACS_DELTA',
+            eventFormat: defaultEventFormat(),
+        };
+    }
+    return {
+        actAs,
+        readAs,
+        async createContract(templateId, createArguments, options) {
+            const request = {
+                method: 'POST',
+                path: '/v2/commands/submit-and-wait-for-transaction',
+                body: {
+                    commands: {
+                        commands: [{ CreateCommand: { templateId, createArguments } }],
+                        commandId: options?.commandId ?? generateUUID(),
+                        actAs: [actAs],
+                        readAs: readAs.length > 0 ? readAs : undefined,
+                        workflowId: options?.workflowId,
+                    },
+                    transactionFormat: defaultTransactionFormat(),
+                },
+            };
+            if (options?.signal)
+                request.signal = options.signal;
+            const response = await transport.request(request);
+            const created = extractCreatedEvent(response.transaction.events);
+            if (created === undefined) {
+                throw new Error('No created event in transaction response');
+            }
+            return created;
+        },
+        async exerciseChoice(templateId, contractId, choice, choiceArgument, options) {
+            const request = {
+                method: 'POST',
+                path: '/v2/commands/submit-and-wait-for-transaction',
+                body: {
+                    commands: {
+                        commands: [
+                            { ExerciseCommand: { templateId, contractId, choice, choiceArgument } },
+                        ],
+                        commandId: options?.commandId ?? generateUUID(),
+                        actAs: [actAs],
+                        readAs: readAs.length > 0 ? readAs : undefined,
+                        workflowId: options?.workflowId,
+                    },
+                    transactionFormat: defaultTransactionFormat(),
+                },
+            };
+            if (options?.signal)
+                request.signal = options.signal;
+            const response = await transport.request(request);
+            return response.transaction;
+        },
+        async queryContracts(templateId, options) {
+            const request = {
+                method: 'POST',
+                path: '/v2/state/active-contracts',
+                body: {
+                    activeAtOffset: options?.activeAtOffset ?? 0,
+                    eventFormat: options?.eventFormat ?? templateEventFormat(templateId),
+                },
+            };
+            if (options?.signal)
+                request.signal = options.signal;
+            const response = await transport.request(request);
+            return response
+                .map((entry) => {
+                if ('JsActiveContract' in entry.contractEntry) {
+                    return entry.contractEntry.JsActiveContract;
+                }
+                return undefined;
+            })
+                .filter((c) => c !== undefined);
+        },
+        async getTransactionById(updateId) {
+            const response = await transport.request({
+                method: 'POST',
+                path: '/v2/updates/transaction-by-id',
+                body: {
+                    updateId,
+                    requestingParties: [actAs, ...readAs],
+                },
+            });
+            return response.transaction;
+        },
+        async getLedgerEnd() {
+            const response = await transport.request({
+                method: 'GET',
+                path: '/v2/state/ledger-end',
+            });
+            return response.offset;
+        },
+        async getEventsByContractId(contractId) {
+            return transport.request({
+                method: 'POST',
+                path: '/v2/events/events-by-contract-id',
+                body: { contractId, requestingParties: [actAs, ...readAs] },
+            });
+        },
+        async getConnectedSynchronizers() {
+            const response = await transport.request({
+                method: 'GET',
+                path: '/v2/state/connected-synchronizers',
+            });
+            return response.connectedSynchronizers ?? [];
+        },
+        async getLatestPrunedOffsets() {
+            const response = await transport.request({
+                method: 'GET',
+                path: '/v2/state/latest-pruned-offsets',
+            });
+            return response;
+        },
+        async submitReassignment(command, options) {
+            const request = {
+                method: 'POST',
+                path: '/v2/commands/submit-and-wait-for-reassignment',
+                body: {
+                    reassignmentCommand: command,
+                    commandId: options?.commandId ?? generateUUID(),
+                    submitter: actAs,
+                    workflowId: options?.workflowId,
+                },
+            };
+            if (options?.signal)
+                request.signal = options.signal;
+            const response = await transport.request(request);
+            return response.reassignment;
+        },
+        async prepareSubmission(templateId, createArguments, options) {
+            const request = {
+                method: 'POST',
+                path: '/v2/interactive-submission/prepare',
+                body: {
+                    commands: [{ CreateCommand: { templateId, createArguments } }],
+                    commandId: options?.commandId ?? generateUUID(),
+                    actAs: [actAs],
+                    readAs: readAs.length > 0 ? readAs : undefined,
+                    workflowId: options?.workflowId,
+                },
+            };
+            if (options?.signal)
+                request.signal = options.signal;
+            return transport.request(request);
+        },
+        async executeSubmission(preparedTransaction, partySignatures, options) {
+            const request = {
+                method: 'POST',
+                path: '/v2/interactive-submission/execute',
+                body: {
+                    preparedTransaction,
+                    partySignatures,
+                    submissionId: options?.submissionId,
+                },
+            };
+            if (options?.signal)
+                request.signal = options.signal;
+            const response = await transport.request(request);
+            return response.transaction;
+        },
+    };
+}
+/** Extract the first CreatedEvent from a list of tagged events. */
+function extractCreatedEvent(events) {
+    for (const event of events) {
+        if ('CreatedEvent' in event) {
+            return event.CreatedEvent;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=createLedgerClient.js.map

package/dist/cjs/clients/createLedgerClient.js.map

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

package/dist/cjs/clients/createTestClient.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Factory for creating a test client for Canton sandbox.
+ *
+ * The TestClient provides sandbox lifecycle management, party allocation,
+ * and time manipulation for testing. Extends LedgerClient + AdminClient.
+ */
+import type { Transport } from '../transport/types.js';
+import type { Party, PartyDetails } from '../types/party.js';
+import { type LedgerClient } from './createLedgerClient.js';
+import { type AdminClient } from './createAdminClient.js';
+export type TestClientConfig = {
+    readonly transport: Transport;
+    /** Default party for ledger operations. If not provided, one will be allocated. */
+    readonly party?: Party;
+};
+export type TestClient = LedgerClient & AdminClient & {
+    /** Get the current ledger time (static-time sandbox only). */
+    getTime: () => Promise<Date>;
+    /** Set the ledger time (static-time sandbox only). */
+    setTime: (currentTime: Date, newTime: Date) => Promise<void>;
+    /** Advance ledger time by a duration in seconds (static-time sandbox only). */
+    advanceTime: (seconds: number) => Promise<void>;
+    /** Allocate multiple parties at once. */
+    allocateParties: (hints: readonly string[]) => Promise<readonly PartyDetails[]>;
+};
+export declare function createTestClient(config: TestClientConfig): TestClient;
+//# sourceMappingURL=createTestClient.d.ts.map

package/dist/cjs/clients/createTestClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTestClient.d.ts","sourceRoot":"","sources":["../../../src/clients/createTestClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC5D,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC/E,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAE5E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,mFAAmF;IACnF,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,YAAY,GACnC,WAAW,GAAG;IACZ,8DAA8D;IAC9D,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAE5B,sDAAsD;IACtD,OAAO,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAE5D,+EAA+E;IAC/E,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAE/C,yCAAyC;IACzC,eAAe,EAAE,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAAA;CAChF,CAAA;AAEH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CA2CrE"}

package/dist/cjs/clients/createTestClient.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Factory for creating a test client for Canton sandbox.
+ *
+ * The TestClient provides sandbox lifecycle management, party allocation,
+ * and time manipulation for testing. Extends LedgerClient + AdminClient.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTestClient = createTestClient;
+const createLedgerClient_js_1 = require("./createLedgerClient.js");
+const createAdminClient_js_1 = require("./createAdminClient.js");
+function createTestClient(config) {
+    const { transport, party = 'test-party' } = config;
+    const ledger = (0, createLedgerClient_js_1.createLedgerClient)({ transport, actAs: party });
+    const admin = (0, createAdminClient_js_1.createAdminClient)({ transport });
+    return {
+        ...ledger,
+        ...admin,
+        async getTime() {
+            const response = await transport.request({
+                method: 'GET',
+                path: '/v2/time',
+            });
+            return new Date(response.currentTime);
+        },
+        async setTime(currentTime, newTime) {
+            await transport.request({
+                method: 'POST',
+                path: '/v2/time',
+                body: {
+                    currentTime: currentTime.toISOString(),
+                    newTime: newTime.toISOString(),
+                },
+            });
+        },
+        async advanceTime(seconds) {
+            const current = await this.getTime();
+            const newTime = new Date(current.getTime() + seconds * 1000);
+            await this.setTime(current, newTime);
+        },
+        async allocateParties(hints) {
+            return Promise.all(hints.map((hint) => admin.allocateParty({ partyIdHint: hint })));
+        },
+    };
+}
+//# sourceMappingURL=createTestClient.js.map

package/dist/cjs/clients/createTestClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTestClient.js","sourceRoot":"","sources":["../../../src/clients/createTestClient.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AA4BH,4CA2CC;AAnED,mEAA+E;AAC/E,iEAA4E;AAuB5E,SAAgB,gBAAgB,CAAC,MAAwB;IACvD,MAAM,EAAE,SAAS,EAAE,KAAK,GAAG,YAAqB,EAAE,GAAG,MAAM,CAAA;IAE3D,MAAM,MAAM,GAAG,IAAA,0CAAkB,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;IAC9D,MAAM,KAAK,GAAG,IAAA,wCAAiB,EAAC,EAAE,SAAS,EAAE,CAAC,CAAA;IAE9C,OAAO;QACL,GAAG,MAAM;QACT,GAAG,KAAK;QAER,KAAK,CAAC,OAAO;YACX,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,OAAO,CAA0B;gBAChE,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,UAAU;aACjB,CAAC,CAAA;YACF,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;QACvC,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO;YAChC,MAAM,SAAS,CAAC,OAAO,CAAC;gBACtB,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE;oBACJ,WAAW,EAAE,WAAW,CAAC,WAAW,EAAE;oBACtC,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE;iBAC/B;aACF,CAAC,CAAA;QACJ,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,OAAO;YACvB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;YACpC,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,OAAO,GAAG,IAAI,CAAC,CAAA;YAC5D,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACtC,CAAC;QAED,KAAK,CAAC,eAAe,CAAC,KAAK;YACzB,OAAO,OAAO,CAAC,GAAG,CAChB,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACjB,KAAK,CAAC,aAAa,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAC3C,CACF,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/cjs/clients/index.d.ts

@@ -0,0 +1,4 @@
+export { createLedgerClient, type LedgerClient, type LedgerClientConfig, type CommandOptions, type QueryOptions, } from './createLedgerClient.js';
+export { createAdminClient, type AdminClient, type AdminClientConfig, } from './createAdminClient.js';
+export { createTestClient, type TestClient, type TestClientConfig, } from './createTestClient.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/clients/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/clients/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAA"}

package/dist/cjs/clients/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTestClient = exports.createAdminClient = exports.createLedgerClient = void 0;
+var createLedgerClient_js_1 = require("./createLedgerClient.js");
+Object.defineProperty(exports, "createLedgerClient", { enumerable: true, get: function () { return createLedgerClient_js_1.createLedgerClient; } });
+var createAdminClient_js_1 = require("./createAdminClient.js");
+Object.defineProperty(exports, "createAdminClient", { enumerable: true, get: function () { return createAdminClient_js_1.createAdminClient; } });
+var createTestClient_js_1 = require("./createTestClient.js");
+Object.defineProperty(exports, "createTestClient", { enumerable: true, get: function () { return createTestClient_js_1.createTestClient; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/clients/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/clients/index.ts"],"names":[],"mappings":";;;AAAA,iEAMgC;AAL9B,2HAAA,kBAAkB,OAAA;AAOpB,+DAI+B;AAH7B,yHAAA,iBAAiB,OAAA;AAKnB,6DAI8B;AAH5B,uHAAA,gBAAgB,OAAA"}

package/dist/cjs/codegen/index.d.ts

@@ -0,0 +1,2 @@
+export type { ChoiceDescriptor, TemplateDescriptor, InferPayload, InferChoiceArgs, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/codegen/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/codegen/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,eAAe,GAChB,MAAM,YAAY,CAAA"}

package/dist/cjs/codegen/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/cjs/codegen/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/codegen/index.ts"],"names":[],"mappings":""}

package/dist/cjs/codegen/types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Runtime types for cantonjs codegen output.
+ *
+ * Generated code imports these types to describe templates and choices.
+ * The core library uses them for type-safe contract operations.
+ */
+/** Describes a choice on a template. */
+export type ChoiceDescriptor<TArgs extends Record<string, unknown> = Record<string, unknown>, _TResult = unknown> = {
+    readonly name: string;
+    readonly _args?: TArgs;
+};
+/** Describes a template with its payload type and available choices. */
+export type TemplateDescriptor<TPayload extends Record<string, unknown> = Record<string, unknown>, TChoices extends Record<string, ChoiceDescriptor> = Record<string, ChoiceDescriptor>> = {
+    readonly templateId: string;
+    readonly choices: TChoices;
+    readonly _payload?: TPayload;
+};
+/**
+ * Extract the payload type from a TemplateDescriptor.
+ *
+ * @example
+ * ```typescript
+ * type AssetPayload = InferPayload<typeof Asset>
+ * // { readonly owner: string; readonly value: string }
+ * ```
+ */
+export type InferPayload<T extends TemplateDescriptor> = T extends TemplateDescriptor<infer P, Record<string, ChoiceDescriptor>> ? P : never;
+/**
+ * Extract the choice argument type for a specific choice.
+ *
+ * @example
+ * ```typescript
+ * type TransferArgs = InferChoiceArgs<typeof Asset, 'Transfer'>
+ * // { readonly newOwner: string }
+ * ```
+ */
+export type InferChoiceArgs<T extends TemplateDescriptor, C extends keyof T['choices']> = T['choices'][C] extends ChoiceDescriptor<infer A> ? A : never;
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/codegen/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/codegen/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wCAAwC;AACxC,MAAM,MAAM,gBAAgB,CAC1B,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,QAAQ,GAAG,OAAO,IAChB;IACF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CACvB,CAAA;AAED,wEAAwE;AACxE,MAAM,MAAM,kBAAkB,CAC5B,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,IAClF;IACF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAA;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAC7B,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,kBAAkB,IACnD,CAAC,SAAS,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;AAErF;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,CACzB,CAAC,SAAS,kBAAkB,EAC5B,CAAC,SAAS,MAAM,CAAC,CAAC,SAAS,CAAC,IAC1B,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,gBAAgB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA"}

package/dist/cjs/codegen/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Runtime types for cantonjs codegen output.
+ *
+ * Generated code imports these types to describe templates and choices.
+ * The core library uses them for type-safe contract operations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/codegen/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/codegen/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/cjs/errors/auth.d.ts

@@ -0,0 +1,13 @@
+import { CantonjsError } from './base.js';
+/** JWT token has expired. */
+export declare class TokenExpiredError extends CantonjsError {
+    readonly expiredAt: Date;
+    constructor(expiredAt: Date);
+}
+/** JWT token is invalid or malformed. */
+export declare class InvalidTokenError extends CantonjsError {
+    constructor(reason: string, options?: {
+        cause?: Error;
+    });
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/cjs/errors/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/errors/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,WAAW,CAAA;AAEzD,6BAA6B;AAC7B,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;gBAEZ,SAAS,EAAE,IAAI;CAW5B;AAED,yCAAyC;AACzC,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAWxD"}

package/dist/cjs/errors/auth.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidTokenError = exports.TokenExpiredError = void 0;
+const base_js_1 = require("./base.js");
+/** JWT token has expired. */
+class TokenExpiredError extends base_js_1.CantonjsError {
+    expiredAt;
+    constructor(expiredAt) {
+        super('JWT token has expired', {
+            code: 'CJ2001',
+            metaMessages: [
+                `Token expired at: ${expiredAt.toISOString()}`,
+                'Generate a new token using cantonctl auth or your identity provider.',
+            ],
+        });
+        this.name = 'TokenExpiredError';
+        this.expiredAt = expiredAt;
+    }
+}
+exports.TokenExpiredError = TokenExpiredError;
+/** JWT token is invalid or malformed. */
+class InvalidTokenError extends base_js_1.CantonjsError {
+    constructor(reason, options) {
+        super(`Invalid JWT token: ${reason}`, {
+            code: 'CJ2002',
+            cause: options?.cause,
+            metaMessages: [
+                'Ensure the token is a valid JWT with the required Canton claims.',
+                'Required scope: daml_ledger_api',
+            ],
+        });
+        this.name = 'InvalidTokenError';
+    }
+}
+exports.InvalidTokenError = InvalidTokenError;
+//# sourceMappingURL=auth.js.map

package/dist/cjs/errors/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/errors/auth.ts"],"names":[],"mappings":";;;AAAA,uCAAyD;AAEzD,6BAA6B;AAC7B,MAAa,iBAAkB,SAAQ,uBAAa;IACzC,SAAS,CAAM;IAExB,YAAY,SAAe;QACzB,KAAK,CAAC,uBAAuB,EAAE;YAC7B,IAAI,EAAE,QAAqB;YAC3B,YAAY,EAAE;gBACZ,qBAAqB,SAAS,CAAC,WAAW,EAAE,EAAE;gBAC9C,sEAAsE;aACvE;SACF,CAAC,CAAA;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC5B,CAAC;CACF;AAdD,8CAcC;AAED,yCAAyC;AACzC,MAAa,iBAAkB,SAAQ,uBAAa;IAClD,YAAY,MAAc,EAAE,OAA2B;QACrD,KAAK,CAAC,sBAAsB,MAAM,EAAE,EAAE;YACpC,IAAI,EAAE,QAAqB;YAC3B,KAAK,EAAE,OAAO,EAAE,KAAK;YACrB,YAAY,EAAE;gBACZ,kEAAkE;gBAClE,iCAAiC;aAClC;SACF,CAAC,CAAA;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACjC,CAAC;CACF;AAZD,8CAYC"}

package/dist/cjs/errors/base.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Structured error hierarchy for cantonjs.
+ *
+ * Follows viem's BaseError pattern with walk(), docsPath, and metaMessages.
+ * Error code ranges are complementary to cantonctl's E1xxx-E8xxx system.
+ *
+ * cantonjs error ranges:
+ *   CJ1xxx — Transport errors (connection, HTTP, gRPC)
+ *   CJ2xxx — Authentication errors (JWT, token lifecycle)
+ *   CJ3xxx — Ledger errors (command rejection, contract not found)
+ *   CJ4xxx — Admin errors (party, user, package management)
+ *   CJ5xxx — Streaming errors (subscription, reconnection)
+ *   CJ6xxx — Codegen errors (type mismatch, generation failures)
+ */
+export type ErrorCode = `CJ${number}`;
+export declare class CantonjsError extends Error {
+    readonly code: ErrorCode;
+    readonly shortMessage: string;
+    readonly docsPath?: string;
+    readonly metaMessages?: readonly string[];
+    readonly cause?: Error;
+    constructor(shortMessage: string, options: CantonjsErrorOptions);
+    /**
+     * Walk the error cause chain, returning the first error matching the predicate.
+     * Useful for finding specific error types in nested cause chains.
+     */
+    walk(fn?: (error: Error) => boolean): Error | undefined;
+}
+export type CantonjsErrorOptions = {
+    readonly code: ErrorCode;
+    readonly cause?: Error;
+    readonly docsPath?: string;
+    readonly metaMessages?: readonly string[];
+};
+//# sourceMappingURL=base.d.ts.map

package/dist/cjs/errors/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/errors/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,SAAS,GAAG,KAAK,MAAM,EAAE,CAAA;AAErC,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACzC,SAAkB,KAAK,CAAC,EAAE,KAAK,CAAA;gBAEnB,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB;IAW/D;;;OAGG;IACH,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,GAAG,KAAK,GAAG,SAAS;CAexD;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC1C,CAAA"}