@superdurable/dex 0.1.0

package/dist/src/grpc-status.js

@@ -0,0 +1,105 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Super Durable Source License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+import { Metadata, status } from "@grpc/grpc-js";
+import { ErrorResponse, ErrorSubStatus as ProtoErrorSubStatus, WorkerErrorResponse, } from "./gen/dex.js";
+import { DexError, ErrorSubStatus } from "./errors.js";
+const statusDetailsKey = "grpc-status-details-bin";
+export function workerServiceError(failure) {
+    const cause = failure instanceof Error ? failure : new Error(String(failure));
+    const detail = cause.message || cause.name;
+    const worker = WorkerErrorResponse.encode({ detail, errorType: cause.name }).finish();
+    const metadata = new Metadata();
+    metadata.set(statusDetailsKey, Buffer.from(encodeStatus(status.UNKNOWN, detail, [
+        { typeUrl: "type.googleapis.com/dex.WorkerErrorResponse", value: worker },
+    ])));
+    return Object.assign(new Error(detail), {
+        code: status.UNKNOWN,
+        details: detail,
+        metadata,
+    });
+}
+export function translateServiceError(error) {
+    const response = errorResponse(error);
+    const detail = response?.detail || error.details || error.message;
+    return new DexError(error.code, response === undefined ? undefined : mapSubStatus(response.subStatus), detail, response?.originalWorkerErrorType ?? "", response?.originalWorkerErrorDetail ?? "", { cause: error });
+}
+function errorResponse(error) {
+    const encoded = error.metadata.get(statusDetailsKey)[0];
+    if (!(encoded instanceof Buffer)) {
+        return undefined;
+    }
+    const decoded = decodeStatus(encoded);
+    const detail = decoded.details.find((candidate) => candidate.typeUrl.endsWith("/dex.ErrorResponse"));
+    return detail === undefined ? undefined : ErrorResponse.decode(detail.value);
+}
+function mapSubStatus(value) {
+    switch (value) {
+        case ProtoErrorSubStatus.ERROR_SUB_STATUS_UNCATEGORIZED:
+            return ErrorSubStatus.UNCATEGORIZED;
+        case ProtoErrorSubStatus.ERROR_SUB_STATUS_FLOW_ALREADY_STARTED:
+            return ErrorSubStatus.FLOW_ALREADY_STARTED;
+        case ProtoErrorSubStatus.ERROR_SUB_STATUS_FLOW_NOT_EXISTS:
+            return ErrorSubStatus.FLOW_NOT_EXISTS;
+        case ProtoErrorSubStatus.ERROR_SUB_STATUS_WORKER_API_ERROR:
+            return ErrorSubStatus.WORKER_API_ERROR;
+        case ProtoErrorSubStatus.ERROR_SUB_STATUS_LONG_POLL_TIME_OUT:
+            return ErrorSubStatus.LONG_POLL_TIMEOUT;
+        default:
+            return undefined;
+    }
+}
+function encodeStatus(code, message, details) {
+    const writer = new BinaryWriter();
+    if (code !== 0) {
+        writer.uint32(8).int32(code);
+    }
+    if (message !== "") {
+        writer.uint32(18).string(message);
+    }
+    for (const detail of details) {
+        writer.uint32(26).fork();
+        writer.uint32(10).string(detail.typeUrl);
+        writer.uint32(18).bytes(detail.value);
+        writer.join();
+    }
+    return writer.finish();
+}
+function decodeStatus(input) {
+    const reader = new BinaryReader(input);
+    const details = [];
+    while (reader.pos < reader.len) {
+        const tag = reader.uint32();
+        if (tag >>> 3 === 3) {
+            details.push(decodeAny(reader, reader.uint32()));
+        }
+        else {
+            reader.skip(tag & 7);
+        }
+    }
+    return { details };
+}
+function decodeAny(reader, length) {
+    const end = reader.pos + length;
+    let typeUrl = "";
+    let value = new Uint8Array();
+    while (reader.pos < end) {
+        const tag = reader.uint32();
+        if (tag >>> 3 === 1) {
+            typeUrl = reader.string();
+        }
+        else if (tag >>> 3 === 2) {
+            value = reader.bytes();
+        }
+        else {
+            reader.skip(tag & 7);
+        }
+    }
+    return { typeUrl, value };
+}
+//# sourceMappingURL=grpc-status.js.map

package/dist/src/grpc-status.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,14 @@
+export * from "./blob-cache.js";
+export * from "./client.js";
+export * from "./codec.js";
+export * from "./context.js";
+export * from "./errors.js";
+export { Registry } from "./flow.js";
+export type { Flow } from "./flow.js";
+export * from "./options.js";
+export * from "./persistence.js";
+export { rpc } from "./rpc.js";
+export type { RPC, RPCOptions, RPCResult } from "./rpc.js";
+export * from "./step.js";
+export * from "./wait.js";
+export * from "./worker.js";

package/dist/src/index.js

@@ -0,0 +1,20 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Super Durable Source License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+export * from "./blob-cache.js";
+export * from "./client.js";
+export * from "./codec.js";
+export * from "./context.js";
+export * from "./errors.js";
+export { Registry } from "./flow.js";
+export * from "./options.js";
+export * from "./persistence.js";
+export { rpc } from "./rpc.js";
+export * from "./step.js";
+export * from "./wait.js";
+export * from "./worker.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,uDAAuD;AACvD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,wDAAwD;AAExD,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/src/invocation-context.d.ts

@@ -0,0 +1,44 @@
+import type { Codec } from "./codec.js";
+import type { Context } from "./context.js";
+import { type AttributeWrite, type ChannelInfo, type ChannelMessage, type ConditionResults, type Context as ProtoContext, type KV } from "./gen/dex.js";
+import type { RegisteredFlow } from "./flow.js";
+import { AttributeMap, type Attribute } from "./persistence.js";
+import { ChannelMap, type Channel } from "./wait.js";
+export type InvocationMethod = "waitFor" | "execute" | "rpc";
+export declare class InvocationContext implements Context {
+    private readonly method;
+    private readonly flow;
+    private readonly conditionResults?;
+    readonly flowId: string;
+    readonly runId: string;
+    readonly flowStartedAt: Date;
+    readonly stepExecutionId: string;
+    readonly fromStepExecutionId: string;
+    readonly firstAttemptAt: Date;
+    readonly attempt: number;
+    private readonly attributes;
+    private readonly locals;
+    private readonly channelInfos;
+    private readonly attributeWrites;
+    private readonly localWrites;
+    private readonly events;
+    private readonly eventNames;
+    private readonly publications;
+    constructor(method: InvocationMethod, flow: RegisteredFlow, metadata: ProtoContext | undefined, attributes: readonly KV[], locals?: readonly KV[], conditionResults?: ConditionResults | undefined, channelInfos?: Readonly<Record<string, ChannelInfo>>);
+    hasTimerFired(index?: number): boolean;
+    waitForMethodFailed(): boolean;
+    setStepExecutionLocal<T>(key: string, value: T, codec: Codec<T>): void;
+    getStepExecutionLocal<T>(key: string, codec: Codec<T>): T | undefined;
+    recordEvent<T>(name: string, value: T, codec: Codec<T>): void;
+    getAttribute<T>(attribute: Attribute<T> | AttributeMap<T>, instance?: string): T;
+    setAttribute<T>(attribute: Attribute<T> | AttributeMap<T>, value: T, instance?: string): void;
+    deleteAttribute(attribute: Attribute<unknown> | AttributeMap<unknown>, instance?: string): void;
+    publish<T>(channel: Channel<T> | ChannelMap<T>, value: T, instance?: string): void;
+    channelSize(channel: Channel<unknown> | ChannelMap<unknown>, instance?: string): number;
+    channelResults<T>(channel: Channel<T> | ChannelMap<T>, instance?: string): readonly T[];
+    getAttributeWrites(): readonly AttributeWrite[];
+    getLocalWrites(): readonly KV[];
+    getEvents(): readonly KV[];
+    getPublications(): readonly ChannelMessage[];
+    private requireRegistered;
+}

package/dist/src/invocation-context.js

@@ -0,0 +1,203 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Super Durable Source License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+import { ConditionStatus, IndexType as ProtoIndexType, } from "./gen/dex.js";
+import { AttributeMap, IndexType } from "./persistence.js";
+import { decodeValue, deletionValue, encodeValue } from "./value-mapper.js";
+import { requireName } from "./validation.js";
+import { ChannelMap } from "./wait.js";
+export class InvocationContext {
+    method;
+    flow;
+    conditionResults;
+    flowId;
+    runId;
+    flowStartedAt;
+    stepExecutionId;
+    fromStepExecutionId;
+    firstAttemptAt;
+    attempt;
+    attributes;
+    locals;
+    channelInfos;
+    attributeWrites = new Map();
+    localWrites = new Map();
+    events = [];
+    eventNames = new Set();
+    publications = [];
+    constructor(method, flow, metadata, attributes, locals = [], conditionResults, channelInfos = {}) {
+        this.method = method;
+        this.flow = flow;
+        this.conditionResults = conditionResults;
+        if (metadata === undefined) {
+            throw new TypeError("Worker request Context is required");
+        }
+        this.flowId = metadata.flowId;
+        this.runId = metadata.runId;
+        this.flowStartedAt = secondsDate(metadata.flowStartedTimestamp);
+        this.stepExecutionId = metadata.stepExecutionId;
+        this.fromStepExecutionId = metadata.fromStepExecutionId;
+        this.firstAttemptAt = secondsDate(metadata.firstAttemptTimestamp);
+        this.attempt = metadata.attempt;
+        this.attributes = mapValues("Attribute", attributes);
+        this.locals = mapValues("step-execution local", locals);
+        this.channelInfos = new Map(Object.entries(channelInfos));
+    }
+    hasTimerFired(index) {
+        const results = this.conditionResults?.timerResults ?? [];
+        if (index !== undefined) {
+            return results[index]?.conditionStatus === ConditionStatus.CONDITION_STATUS_COMPLETED;
+        }
+        return results.some((result) => result.conditionStatus === ConditionStatus.CONDITION_STATUS_COMPLETED);
+    }
+    waitForMethodFailed() {
+        return this.conditionResults?.waitForFailed ?? false;
+    }
+    setStepExecutionLocal(key, value, codec) {
+        requireName(key);
+        this.localWrites.set(key, { key, value: encodeValue(codec, value) });
+    }
+    getStepExecutionLocal(key, codec) {
+        requireName(key);
+        const value = this.localWrites.get(key)?.value ?? this.locals.get(key);
+        return value === undefined ? undefined : decodeValue(codec, value);
+    }
+    recordEvent(name, value, codec) {
+        requireName(name);
+        if (this.eventNames.has(name)) {
+            throw new TypeError(`event was already recorded: ${name}`);
+        }
+        this.eventNames.add(name);
+        this.events.push({ key: name, value: encodeValue(codec, value) });
+    }
+    getAttribute(attribute, instance) {
+        this.requireRegistered(attribute);
+        const key = definitionName(attribute, instance);
+        const write = this.attributeWrites.get(key)?.value;
+        if (write?.kind?.$case === "nullValue") {
+            return defaultValue(attribute.codec);
+        }
+        const value = write ?? this.attributes.get(key);
+        return value === undefined ? defaultValue(attribute.codec) : decodeValue(attribute.codec, value);
+    }
+    setAttribute(attribute, value, instance) {
+        this.requireRegistered(attribute);
+        const key = definitionName(attribute, instance);
+        this.attributeWrites.set(key, {
+            key,
+            value: encodeValue(attribute.codec, value),
+            indexConfig: mapIndex(attribute.index),
+        });
+    }
+    deleteAttribute(attribute, instance) {
+        this.requireRegistered(attribute);
+        const key = definitionName(attribute, instance);
+        this.attributeWrites.set(key, {
+            key,
+            value: deletionValue(),
+            indexConfig: mapIndex(attribute.index),
+        });
+    }
+    publish(channel, value, instance) {
+        this.requireRegistered(channel);
+        const name = definitionName(channel, instance);
+        this.publications.push({ channelName: name, value: encodeValue(channel.codec, value) });
+        if (this.method === "rpc") {
+            this.channelInfos.set(name, { size: (this.channelInfos.get(name)?.size ?? 0) + 1 });
+        }
+    }
+    channelSize(channel, instance) {
+        this.requireRegistered(channel);
+        return this.channelInfos.get(definitionName(channel, instance))?.size ?? 0;
+    }
+    channelResults(channel, instance) {
+        this.requireRegistered(channel);
+        const name = definitionName(channel, instance);
+        return (this.conditionResults?.channelResults ?? [])
+            .filter((result) => result.channelName === name &&
+            result.conditionStatus === ConditionStatus.CONDITION_STATUS_COMPLETED)
+            .flatMap((result) => result.values.map((value) => decodeValue(channel.codec, value)));
+    }
+    getAttributeWrites() {
+        return [...this.attributeWrites.values()];
+    }
+    getLocalWrites() {
+        return [...this.localWrites.values()];
+    }
+    getEvents() {
+        return this.events;
+    }
+    getPublications() {
+        return this.publications;
+    }
+    requireRegistered(definition) {
+        if (this.flow.persistence.get(definition.name) !== definition) {
+            throw new TypeError(`persistence definition does not belong to Flow: ${definition.name}`);
+        }
+    }
+}
+function definitionName(definition, instance) {
+    if (definition instanceof AttributeMap || definition instanceof ChannelMap) {
+        if (instance === undefined) {
+            throw new TypeError(`map definition ${definition.name} requires an instance`);
+        }
+        requireName(instance);
+        return `${definition.name}/${encodeURIComponent(instance).replace(/[!'()*]/g, encodeCharacter)}`;
+    }
+    if (instance !== undefined) {
+        throw new TypeError(`static definition ${definition.name} cannot use an instance`);
+    }
+    return definition.name;
+}
+function encodeCharacter(character) {
+    return `%${character.charCodeAt(0).toString(16).toUpperCase()}`;
+}
+function mapValues(kind, entries) {
+    const values = new Map();
+    for (const entry of entries) {
+        if (entry.key === "" || entry.value === undefined || values.has(entry.key)) {
+            throw new TypeError(`invalid or duplicate ${kind}`);
+        }
+        values.set(entry.key, entry.value);
+    }
+    return values;
+}
+function defaultValue(codec) {
+    switch (codec.wireKind) {
+        case "bool":
+            return false;
+        case "double":
+            return 0;
+        case "int64":
+            return 0n;
+        default:
+            return undefined;
+    }
+}
+function mapIndex(index) {
+    if (index === undefined) {
+        return undefined;
+    }
+    const types = {
+        [IndexType.KEYWORD]: ProtoIndexType.INDEX_TYPE_KEYWORD,
+        [IndexType.FULL_TEXT]: ProtoIndexType.INDEX_TYPE_TEXT,
+        [IndexType.KEYWORD_ARRAY]: ProtoIndexType.INDEX_TYPE_KEYWORD_ARRAY,
+        [IndexType.INT]: ProtoIndexType.INDEX_TYPE_INT,
+        [IndexType.DOUBLE]: ProtoIndexType.INDEX_TYPE_DOUBLE,
+        [IndexType.BOOL]: ProtoIndexType.INDEX_TYPE_BOOL,
+        [IndexType.DATETIME]: ProtoIndexType.INDEX_TYPE_DATETIME,
+    };
+    return { enable: true, type: types[index.type], indexKey: index.indexKey ?? "" };
+}
+function secondsDate(seconds) {
+    const milliseconds = Number(seconds * 1000n);
+    if (!Number.isSafeInteger(milliseconds)) {
+        throw new RangeError("Context timestamp exceeds JavaScript's safe Date range");
+    }
+    return new Date(milliseconds);
+}
+//# sourceMappingURL=invocation-context.js.map

package/dist/src/invocation-context.js.map

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

package/dist/src/options.d.ts

@@ -0,0 +1,106 @@
+import type { Attribute, AttributeMap } from "./persistence.js";
+import type { RetryPolicy, StepDurability } from "./step.js";
+export interface ClientOptions {
+    readonly serverAddress?: string;
+    readonly workerTarget?: WorkerTarget;
+}
+export declare const ActiveStepSearchMode: Readonly<{
+    readonly DEFAULT: "default";
+    readonly ALL: "all";
+}>;
+export type ActiveStepSearchMode = (typeof ActiveStepSearchMode)[keyof typeof ActiveStepSearchMode];
+export declare const IdReusePolicy: Readonly<{
+    readonly DEFAULT: "default";
+    readonly ALLOW_IF_PREVIOUS_FAILED: "allowIfPreviousFailed";
+    readonly ALLOW_IF_NOT_RUNNING: "allowIfNotRunning";
+    readonly ALLOW_TERMINATE_IF_RUNNING: "allowTerminateIfRunning";
+    readonly DISALLOW: "disallow";
+}>;
+export type IdReusePolicy = (typeof IdReusePolicy)[keyof typeof IdReusePolicy];
+export interface FlowConfig {
+    readonly activeStepSearchMode?: ActiveStepSearchMode;
+    readonly continueAsNewThreshold?: number;
+    readonly continueAsNewPageSizeBytes?: number;
+    readonly stepDurability?: StepDurability;
+    readonly workerTarget?: WorkerTarget;
+}
+export interface InitialAttribute<T> {
+    readonly attribute: Attribute<T> | AttributeMap<T>;
+    readonly instance?: string;
+    readonly value: T;
+}
+export declare const InitialAttribute: Readonly<{
+    of<T>(attribute: Attribute<T>, value: T): InitialAttribute<T>;
+    mapValue<T>(attribute: AttributeMap<T>, instance: string, value: T): InitialAttribute<T>;
+}>;
+export interface StartFlowOptions {
+    readonly timeoutMs?: number;
+    readonly startDelayMs?: number;
+    readonly idReusePolicy?: IdReusePolicy;
+    readonly cronSchedule?: string;
+    readonly retryPolicy?: RetryPolicy;
+    readonly attributes?: readonly InitialAttribute<any>[];
+    readonly configOverride?: FlowConfig;
+    readonly ignoreAlreadyStarted?: boolean;
+    readonly requestId?: string;
+}
+export type FlowStatus = "running" | "completed" | "failed" | "cancelled" | "terminated" | "timedOut" | "continuedAsNew";
+export interface FlowInfo {
+    readonly flowId: string;
+    readonly runId: string;
+    readonly flowType: string;
+    readonly status: FlowStatus;
+    readonly startedAt: Date;
+}
+export interface StepExecutionId {
+    readonly stepType: string;
+    readonly number?: number;
+}
+export declare const StepExecutionId: Readonly<{
+    of(stepType: string, number?: number): StepExecutionId;
+}>;
+export interface TimerId {
+    readonly conditionId?: string;
+    readonly conditionIndex?: number;
+}
+export declare const TimerId: Readonly<{
+    byConditionId(conditionId: string): TimerId;
+    byConditionIndex(conditionIndex: number): TimerId;
+}>;
+export declare const ResetType: Readonly<{
+    readonly BEGINNING: "beginning";
+    readonly HISTORY_EVENT_ID: "historyEventId";
+    readonly HISTORY_EVENT_TIME: "historyEventTime";
+    readonly STEP_TYPE: "stepType";
+    readonly STEP_EXECUTION_ID: "stepExecutionId";
+}>;
+export type ResetType = (typeof ResetType)[keyof typeof ResetType];
+export interface ResetFlowOptions {
+    readonly type: ResetType;
+    readonly historyEventId?: bigint;
+    readonly historyEventTime?: Date;
+    readonly stepType?: string;
+    readonly stepExecutionId?: string;
+    readonly reason?: string;
+    readonly skipChannelMessagesReapply?: boolean;
+    readonly skipLockingRpcReapply?: boolean;
+}
+export declare const StopType: Readonly<{
+    readonly CANCEL: "cancel";
+    readonly TERMINATE: "terminate";
+    readonly FAIL: "fail";
+}>;
+export type StopType = (typeof StopType)[keyof typeof StopType];
+export interface StopFlowOptions {
+    readonly type?: StopType;
+    readonly reason?: string;
+}
+export interface WorkerOptions {
+    readonly bindAddress?: string;
+    readonly workerTarget?: WorkerTarget;
+    readonly serverAddress?: string;
+}
+export interface WorkerTarget {
+    readonly address: string;
+    readonly headless?: boolean;
+}

package/dist/src/options.js

@@ -0,0 +1,55 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Super Durable Source License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+import { requireName } from "./validation.js";
+export const ActiveStepSearchMode = Object.freeze({
+    DEFAULT: "default",
+    ALL: "all",
+});
+export const IdReusePolicy = Object.freeze({
+    DEFAULT: "default",
+    ALLOW_IF_PREVIOUS_FAILED: "allowIfPreviousFailed",
+    ALLOW_IF_NOT_RUNNING: "allowIfNotRunning",
+    ALLOW_TERMINATE_IF_RUNNING: "allowTerminateIfRunning",
+    DISALLOW: "disallow",
+});
+export const InitialAttribute = Object.freeze({
+    of(attribute, value) {
+        return { attribute, value };
+    },
+    mapValue(attribute, instance, value) {
+        requireName(instance);
+        return { attribute, instance, value };
+    },
+});
+export const StepExecutionId = Object.freeze({
+    of(stepType, number) {
+        return { stepType, number: number ?? 1 };
+    },
+});
+export const TimerId = Object.freeze({
+    byConditionId(conditionId) {
+        requireName(conditionId);
+        return { conditionId };
+    },
+    byConditionIndex(conditionIndex) {
+        return { conditionIndex };
+    },
+});
+export const ResetType = Object.freeze({
+    BEGINNING: "beginning",
+    HISTORY_EVENT_ID: "historyEventId",
+    HISTORY_EVENT_TIME: "historyEventTime",
+    STEP_TYPE: "stepType",
+    STEP_EXECUTION_ID: "stepExecutionId",
+});
+export const StopType = Object.freeze({
+    CANCEL: "cancel",
+    TERMINATE: "terminate",
+    FAIL: "fail",
+});
+//# sourceMappingURL=options.js.map

package/dist/src/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/options.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,uDAAuD;AACvD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,wDAAwD;AAIxD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAO9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,SAAS;IAClB,GAAG,EAAE,KAAK;CACF,CAAC,CAAC;AAKZ,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,SAAS;IAClB,wBAAwB,EAAE,uBAAuB;IACjD,oBAAoB,EAAE,mBAAmB;IACzC,0BAA0B,EAAE,yBAAyB;IACrD,QAAQ,EAAE,UAAU;CACZ,CAAC,CAAC;AAkBZ,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5C,EAAE,CAAI,SAAuB,EAAE,KAAQ;QACrC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;IACD,QAAQ,CACN,SAA0B,EAC1B,QAAgB,EAChB,KAAQ;QAER,WAAW,CAAC,QAAQ,CAAC,CAAC;QACtB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACxC,CAAC;CACF,CAAC,CAAC;AAoCH,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,EAAE,CAAC,QAAgB,EAAE,MAAe;QAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;IAC3C,CAAC;CACF,CAAC,CAAC;AAOH,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,aAAa,CAAC,WAAmB;QAC/B,WAAW,CAAC,WAAW,CAAC,CAAC;QACzB,OAAO,EAAE,WAAW,EAAE,CAAC;IACzB,CAAC;IACD,gBAAgB,CAAC,cAAsB;QACrC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC5B,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;IACrC,SAAS,EAAE,WAAW;IACtB,gBAAgB,EAAE,gBAAgB;IAClC,kBAAkB,EAAE,kBAAkB;IACtC,SAAS,EAAE,UAAU;IACrB,iBAAiB,EAAE,iBAAiB;CAC5B,CAAC,CAAC;AAeZ,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;IACpC,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,MAAM;CACJ,CAAC,CAAC"}

package/dist/src/persistence.d.ts

@@ -0,0 +1,45 @@
+import type { Channel, ChannelMap } from "./wait.js";
+import type { Codec } from "./codec.js";
+import type { Context } from "./context.js";
+export declare const IndexType: Readonly<{
+    readonly KEYWORD: "keyword";
+    readonly FULL_TEXT: "fullText";
+    readonly KEYWORD_ARRAY: "keywordArray";
+    readonly INT: "int";
+    readonly DOUBLE: "double";
+    readonly BOOL: "bool";
+    readonly DATETIME: "datetime";
+}>;
+export type IndexType = (typeof IndexType)[keyof typeof IndexType];
+export interface AttributeIndex {
+    readonly type: IndexType;
+    readonly indexKey?: string;
+}
+export interface AttributeLock {
+    readonly attribute: Attribute<unknown> | AttributeMap<unknown>;
+    readonly instance?: string;
+}
+export declare class Attribute<T> {
+    readonly name: string;
+    readonly codec: Codec<T>;
+    readonly index?: AttributeIndex | undefined;
+    constructor(name: string, codec: Codec<T>, index?: AttributeIndex | undefined);
+    get(context: Context): T;
+    set(context: Context, value: T): void;
+    delete(context: Context): void;
+    lock(): AttributeLock;
+}
+export declare class AttributeMap<T> {
+    readonly name: string;
+    readonly codec: Codec<T>;
+    readonly index?: AttributeIndex | undefined;
+    constructor(name: string, codec: Codec<T>, index?: AttributeIndex | undefined);
+    get(context: Context, instance: string): T;
+    set(context: Context, instance: string, value: T): void;
+    delete(context: Context, instance: string): void;
+    lock(instance: string): AttributeLock;
+}
+export interface PersistenceSchema {
+    readonly attributes?: readonly (Attribute<unknown> | AttributeMap<unknown>)[];
+    readonly channels?: readonly (Channel<unknown> | ChannelMap<unknown>)[];
+}