solid-objects 0.12.0

package/dist/cli.js

@@ -0,0 +1,216 @@
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { SolidObjectsRuntime } from "./runtime.js";
+const COMMANDS = new Set([
+    "start",
+    "doctor",
+    "status",
+    "cleanup",
+    "dead-letters",
+    "retry-dead-letter",
+    "reminders",
+    "resume-reminder",
+    "prune",
+]);
+const administrationContext = Object.freeze({ source: "cli" });
+export async function runCli(argumentsValue, options = {}) {
+    const [command, ...commandArguments] = argumentsValue;
+    if (!command || command === "help" || command === "--help" || command === "-h") {
+        options.write?.(help()) ?? process.stdout.write(help());
+        return 0;
+    }
+    if (!COMMANDS.has(command))
+        throw new TypeError(`unknown command ${JSON.stringify(command)}`);
+    const parsed = parseArguments(commandArguments);
+    const configurationPath = stringOption(parsed, "config") ?? "solid-objects.config.js";
+    const loadRuntime = options.loadRuntime ?? loadRuntimeModule;
+    const runtime = await loadRuntime(configurationPath);
+    const write = options.write ?? ((value) => process.stdout.write(value));
+    await runtime.install();
+    try {
+        if (command === "start") {
+            assertOptions(parsed, { command });
+            assertNoPositionals(parsed, command);
+            await runtime.run(options.signal ?? new AbortController().signal);
+            return 0;
+        }
+        if (command === "doctor") {
+            assertOptions(parsed, { command, flags: ["skip-round-trip"] });
+            assertNoPositionals(parsed, command);
+            const report = await runtime.doctor.run({
+                roundTrip: parsed.flags.has("skip-round-trip") ? "skip" : "run",
+            });
+            writeJson(write, report);
+            return report.healthy ? 0 : 1;
+        }
+        if (command === "status") {
+            assertOptions(parsed, { command });
+            assertNoPositionals(parsed, command);
+            writeJson(write, await runtime.processes.all({ authorizationContext: administrationContext }));
+            return 0;
+        }
+        if (command === "cleanup") {
+            assertOptions(parsed, { command });
+            assertNoPositionals(parsed, command);
+            writeJson(write, await runtime.processes.cleanup({ authorizationContext: administrationContext }));
+            return 0;
+        }
+        if (command === "dead-letters") {
+            assertOptions(parsed, { command });
+            assertNoPositionals(parsed, command);
+            writeJson(write, await runtime.deadLetters.all({ authorizationContext: administrationContext }));
+            return 0;
+        }
+        if (command === "retry-dead-letter") {
+            assertOptions(parsed, { command });
+            const id = requiredPositional(parsed, command);
+            const message = await runtime.deadLetters.retry(id, {
+                authorizationContext: administrationContext,
+            });
+            writeJson(write, { messageId: message.id, requestId: message.requestId });
+            return 0;
+        }
+        if (command === "reminders") {
+            assertOptions(parsed, { command, options: ["actor-type", "status"] });
+            assertNoPositionals(parsed, command);
+            const actorType = stringOption(parsed, "actor-type");
+            const status = stringOption(parsed, "status");
+            const page = await runtime.reminders.all({
+                authorizationContext: administrationContext,
+                ...(actorType === undefined ? {} : { actorType }),
+                ...(status === undefined ? {} : { status: reminderStatus(status) }),
+            });
+            writeJson(write, page);
+            return 0;
+        }
+        if (command === "resume-reminder") {
+            assertOptions(parsed, { command, options: ["run-at"] });
+            const id = requiredPositional(parsed, command);
+            const runAt = stringOption(parsed, "run-at");
+            const reminder = await runtime.reminders.resume(id, {
+                authorizationContext: administrationContext,
+                ...(runAt === undefined ? {} : { runAt: dateOption(runAt, "run-at") }),
+            });
+            writeJson(write, reminder);
+            return 0;
+        }
+        assertOptions(parsed, { command, flags: ["execute"] });
+        const target = retentionTarget(requiredPositional(parsed, command));
+        const result = parsed.flags.has("execute")
+            ? await runtime.retention.prune({
+                target,
+                authorizationContext: administrationContext,
+            })
+            : await runtime.retention.preview({
+                target,
+                authorizationContext: administrationContext,
+            });
+        writeJson(write, {
+            target: result.target,
+            mode: parsed.flags.has("execute") ? "execute" : "preview",
+            count: result.count,
+        });
+        return 0;
+    }
+    finally {
+        if (options.closeRuntime !== false)
+            await runtime.close();
+    }
+}
+function parseArguments(argumentsValue) {
+    const positionals = [];
+    const flags = new Set();
+    const options = new Map();
+    for (let index = 0; index < argumentsValue.length; index += 1) {
+        const argument = argumentsValue[index];
+        if (!argument)
+            continue;
+        if (!argument.startsWith("--") && argument !== "-c") {
+            positionals.push(argument);
+            continue;
+        }
+        const name = argument === "-c" ? "config" : argument.slice(2);
+        if (name === "execute" || name === "skip-round-trip") {
+            flags.add(name);
+            continue;
+        }
+        const value = argumentsValue[index + 1];
+        if (!value || value.startsWith("-"))
+            throw new TypeError(`--${name} requires a value`);
+        options.set(name, value);
+        index += 1;
+    }
+    return { positionals, flags, options };
+}
+async function loadRuntimeModule(path) {
+    const module = (await import(pathToFileURL(resolve(path)).href));
+    let runtime = module.default ?? module.runtime;
+    if (typeof runtime === "function")
+        runtime = await runtime();
+    if (!(runtime instanceof SolidObjectsRuntime)) {
+        throw new TypeError(`${path} must export a SolidObjectsRuntime as default or runtime`);
+    }
+    return runtime;
+}
+function stringOption(argumentsValue, name) {
+    return argumentsValue.options.get(name);
+}
+function requiredPositional(argumentsValue, command) {
+    const [value, ...extra] = argumentsValue.positionals;
+    if (!value || extra.length > 0)
+        throw new TypeError(`${command} requires exactly one argument`);
+    return value;
+}
+function assertNoPositionals(argumentsValue, command) {
+    if (argumentsValue.positionals.length > 0) {
+        throw new TypeError(`${command} does not accept positional arguments`);
+    }
+}
+function assertOptions(argumentsValue, allowed) {
+    const optionNames = new Set(["config", ...(allowed.options ?? [])]);
+    const flagNames = new Set(allowed.flags ?? []);
+    const unknownOption = [...argumentsValue.options.keys()].find((name) => !optionNames.has(name));
+    if (unknownOption)
+        throw new TypeError(`${allowed.command} does not accept --${unknownOption}`);
+    const unknownFlag = [...argumentsValue.flags].find((name) => !flagNames.has(name));
+    if (unknownFlag)
+        throw new TypeError(`${allowed.command} does not accept --${unknownFlag}`);
+}
+function retentionTarget(value) {
+    if (value === "messages" || value === "instances" || value === "processes")
+        return value;
+    throw new TypeError(`unknown retention target ${JSON.stringify(value)}`);
+}
+function reminderStatus(value) {
+    if (value === "scheduled" || value === "paused" || value === "completed")
+        return value;
+    throw new TypeError(`unknown reminder status ${JSON.stringify(value)}`);
+}
+function dateOption(value, name) {
+    const date = new Date(value);
+    if (!Number.isFinite(date.getTime()))
+        throw new TypeError(`--${name} must be an ISO date`);
+    return date;
+}
+function writeJson(write, value) {
+    write(`${JSON.stringify(value, (_key, item) => (typeof item === "bigint" ? String(item) : item), 2)}\n`);
+}
+function help() {
+    return `Usage: solid-objects <command> [options]
+
+Commands:
+  start
+  doctor [--skip-round-trip]
+  status
+  cleanup
+  dead-letters
+  retry-dead-letter ID
+  reminders [--actor-type TYPE] [--status STATUS]
+  resume-reminder ID [--run-at ISO_DATE]
+  prune messages|instances|processes [--execute]
+
+Options:
+  --config, -c PATH  Application module (default: solid-objects.config.js)
+`;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/configuration.d.ts

@@ -0,0 +1,96 @@
+import type { Database } from "./database/types.js";
+import type { DeepReadonly, JsonObject, JsonValue, Logger, LongRunningComponent } from "./types.js";
+import { type WakeUpAdapter } from "./wake-up.js";
+export interface AuthorizationInput {
+    actorType: string;
+    actorId: string;
+    operation: string;
+    arguments: Record<string, JsonValue>;
+    authorizationContext: unknown;
+}
+export interface DestroyAuthorizationInput {
+    actorType: string;
+    actorId: string;
+    authorizationContext: unknown;
+}
+export interface AdministrationAuthorizationInput {
+    action: string;
+    resource: string;
+    resourceId?: string;
+    authorizationContext: unknown;
+}
+export interface SubscriptionAuthorizationInput {
+    actorType: string;
+    actorId: string;
+    authorizationContext: unknown;
+}
+export interface InstrumentationEvent {
+    readonly name: string;
+    readonly occurredAt: string;
+    readonly attributes: DeepReadonly<JsonObject>;
+}
+export interface SolidObjectsConfiguration {
+    database: Database;
+    tableNamePrefix?: string;
+    pollingIntervalMilliseconds?: number;
+    syncPollingIntervalMilliseconds?: number;
+    leaseDurationMilliseconds?: number;
+    leaseRenewalIntervalMilliseconds?: number;
+    idleDeactivationTimeoutMilliseconds?: number;
+    maxMailboxLength?: number;
+    maxPayloadBytes?: number;
+    maxStateBytes?: number;
+    maxResultBytes?: number;
+    maxAttempts?: number;
+    maxMessagesPerActivationPass?: number;
+    maxActivationDurationMilliseconds?: number;
+    claimScanLimit?: number;
+    retryDelayMilliseconds?: (attempt: number) => number;
+    processHeartbeatIntervalMilliseconds?: number;
+    processAliveThresholdMilliseconds?: number;
+    shutdownTimeoutMilliseconds?: number;
+    supervisorRestartDelayMilliseconds?: number;
+    supervisorMaximumRestartDelayMilliseconds?: number;
+    workerCount?: number;
+    effectWorkerCount?: number;
+    broadcastWorkerCount?: number;
+    reminderSchedulerCount?: number;
+    retentionIntervalMilliseconds?: number;
+    deadProcessCleanupIntervalMilliseconds?: number;
+    messageRetentionMilliseconds?: number;
+    messageRetentionByActorType?: Readonly<Record<string, number>>;
+    instanceRetentionByActorType?: Readonly<Record<string, number>>;
+    processRetentionMilliseconds?: number;
+    pruneBatchSize?: number;
+    logger?: Logger;
+    authorizeMessage?: (input: AuthorizationInput) => boolean | Promise<boolean>;
+    authorizeQuery?: (input: AuthorizationInput) => boolean | Promise<boolean>;
+    authorizeDestroy?: (input: DestroyAuthorizationInput) => boolean | Promise<boolean>;
+    authorizeAdministration?: (input: AdministrationAuthorizationInput) => boolean | Promise<boolean>;
+    authorizeSubscription?: (input: SubscriptionAuthorizationInput) => boolean | Promise<boolean>;
+    instrumentation?: (event: InstrumentationEvent) => void;
+    broadcast?: (event: BroadcastEvent) => Promise<void>;
+    wakeUp?: WakeUpAdapter;
+}
+export interface BroadcastEvent {
+    readonly actorType: string;
+    readonly actorId: string;
+    readonly instanceId: string;
+    readonly revision: string;
+    readonly observables: DeepReadonly<JsonObject>;
+}
+export interface RuntimeSettings extends Required<Omit<SolidObjectsConfiguration, "logger" | "broadcast" | "instrumentation" | "wakeUp">> {
+    logger: Logger;
+    broadcast?: (event: BroadcastEvent) => Promise<void>;
+    instrumentation?: (event: InstrumentationEvent) => void;
+    wakeUp: WakeUpAdapter;
+    authorizationPoliciesConfigured: Readonly<Record<string, boolean>>;
+}
+export declare function buildSettings(configuration: SolidObjectsConfiguration): RuntimeSettings;
+export interface ComponentRegistration {
+    count: number;
+    factory(): LongRunningComponent;
+}
+export declare function validateComponent(component: LongRunningComponent): void;
+export declare function broadcastsEnabled(settings: RuntimeSettings): boolean;
+//# sourceMappingURL=configuration.d.ts.map

package/dist/configuration.d.ts.map

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

package/dist/configuration.js

@@ -0,0 +1,169 @@
+import { InvalidActor } from "./errors.js";
+import { InProcessWakeUpAdapter } from "./wake-up.js";
+const consoleLogger = {
+    debug: (entry) => console.debug(entry),
+    info: (entry) => console.info(entry),
+    warn: (entry) => console.warn(entry),
+    error: (entry) => console.error(entry),
+};
+export function buildSettings(configuration) {
+    const settings = {
+        database: configuration.database,
+        tableNamePrefix: configuration.tableNamePrefix ?? "solid_objects_",
+        pollingIntervalMilliseconds: configuration.pollingIntervalMilliseconds ?? 100,
+        syncPollingIntervalMilliseconds: configuration.syncPollingIntervalMilliseconds ?? 50,
+        leaseDurationMilliseconds: configuration.leaseDurationMilliseconds ?? 30_000,
+        leaseRenewalIntervalMilliseconds: configuration.leaseRenewalIntervalMilliseconds ?? 10_000,
+        idleDeactivationTimeoutMilliseconds: configuration.idleDeactivationTimeoutMilliseconds ?? 30_000,
+        maxMailboxLength: configuration.maxMailboxLength ?? 10_000,
+        maxPayloadBytes: configuration.maxPayloadBytes ?? 1_048_576,
+        maxStateBytes: configuration.maxStateBytes ?? 5_242_880,
+        maxResultBytes: configuration.maxResultBytes ?? 1_048_576,
+        maxAttempts: configuration.maxAttempts ?? 5,
+        maxMessagesPerActivationPass: configuration.maxMessagesPerActivationPass ?? 50,
+        maxActivationDurationMilliseconds: configuration.maxActivationDurationMilliseconds ?? 5_000,
+        claimScanLimit: configuration.claimScanLimit ?? 100,
+        retryDelayMilliseconds: configuration.retryDelayMilliseconds ??
+            ((attempt) => Math.min(2 ** (attempt - 1), 60) * 1_000),
+        processHeartbeatIntervalMilliseconds: configuration.processHeartbeatIntervalMilliseconds ?? 15_000,
+        processAliveThresholdMilliseconds: configuration.processAliveThresholdMilliseconds ?? 60_000,
+        shutdownTimeoutMilliseconds: configuration.shutdownTimeoutMilliseconds ?? 15_000,
+        supervisorRestartDelayMilliseconds: configuration.supervisorRestartDelayMilliseconds ?? 100,
+        supervisorMaximumRestartDelayMilliseconds: configuration.supervisorMaximumRestartDelayMilliseconds ?? 10_000,
+        workerCount: configuration.workerCount ?? 1,
+        effectWorkerCount: configuration.effectWorkerCount ?? 1,
+        broadcastWorkerCount: configuration.broadcastWorkerCount ?? 1,
+        reminderSchedulerCount: configuration.reminderSchedulerCount ?? 1,
+        retentionIntervalMilliseconds: configuration.retentionIntervalMilliseconds ?? 3_600_000,
+        deadProcessCleanupIntervalMilliseconds: configuration.deadProcessCleanupIntervalMilliseconds ?? 60_000,
+        messageRetentionMilliseconds: configuration.messageRetentionMilliseconds ?? 30 * 86_400_000,
+        messageRetentionByActorType: Object.freeze({
+            ...(configuration.messageRetentionByActorType ?? {}),
+        }),
+        instanceRetentionByActorType: Object.freeze({
+            ...(configuration.instanceRetentionByActorType ?? {}),
+        }),
+        processRetentionMilliseconds: configuration.processRetentionMilliseconds ?? 7 * 86_400_000,
+        pruneBatchSize: configuration.pruneBatchSize ?? 1_000,
+        logger: configuration.logger ?? consoleLogger,
+        wakeUp: configuration.wakeUp ?? new InProcessWakeUpAdapter(),
+        authorizeMessage: configuration.authorizeMessage ?? (() => false),
+        authorizeQuery: configuration.authorizeQuery ?? (() => false),
+        authorizeDestroy: configuration.authorizeDestroy ?? (() => false),
+        authorizeAdministration: configuration.authorizeAdministration ?? (() => false),
+        authorizeSubscription: configuration.authorizeSubscription ?? (() => false),
+        authorizationPoliciesConfigured: Object.freeze({
+            authorizeMessage: configuration.authorizeMessage !== undefined,
+            authorizeQuery: configuration.authorizeQuery !== undefined,
+            authorizeDestroy: configuration.authorizeDestroy !== undefined,
+            authorizeAdministration: configuration.authorizeAdministration !== undefined,
+            authorizeSubscription: configuration.authorizeSubscription !== undefined,
+        }),
+    };
+    if (configuration.broadcast !== undefined)
+        settings.broadcast = configuration.broadcast;
+    if (configuration.instrumentation !== undefined) {
+        settings.instrumentation = configuration.instrumentation;
+    }
+    validateSettings(settings);
+    return settings;
+}
+export function validateComponent(component) {
+    for (const name of ["run", "requestShutdown", "stopped", "stop"]) {
+        if (typeof component[name] !== "function") {
+            throw new InvalidActor(`a registered component must implement ${name}`);
+        }
+    }
+}
+function validateSettings(settings) {
+    for (const name of ["watch", "notify", "close"]) {
+        if (typeof settings.wakeUp[name] !== "function") {
+            throw new TypeError(`wakeUp must implement ${name}`);
+        }
+    }
+    if (!/^[a-z][a-z0-9_]*$/.test(settings.tableNamePrefix)) {
+        throw new TypeError("tableNamePrefix must contain lowercase letters, digits, and underscores");
+    }
+    const positive = {
+        pollingIntervalMilliseconds: settings.pollingIntervalMilliseconds,
+        syncPollingIntervalMilliseconds: settings.syncPollingIntervalMilliseconds,
+        leaseDurationMilliseconds: settings.leaseDurationMilliseconds,
+        leaseRenewalIntervalMilliseconds: settings.leaseRenewalIntervalMilliseconds,
+        maxMailboxLength: settings.maxMailboxLength,
+        maxPayloadBytes: settings.maxPayloadBytes,
+        maxStateBytes: settings.maxStateBytes,
+        maxResultBytes: settings.maxResultBytes,
+        maxAttempts: settings.maxAttempts,
+        maxActivationDurationMilliseconds: settings.maxActivationDurationMilliseconds,
+        processHeartbeatIntervalMilliseconds: settings.processHeartbeatIntervalMilliseconds,
+        processAliveThresholdMilliseconds: settings.processAliveThresholdMilliseconds,
+        shutdownTimeoutMilliseconds: settings.shutdownTimeoutMilliseconds,
+        supervisorRestartDelayMilliseconds: settings.supervisorRestartDelayMilliseconds,
+        supervisorMaximumRestartDelayMilliseconds: settings.supervisorMaximumRestartDelayMilliseconds,
+        messageRetentionMilliseconds: settings.messageRetentionMilliseconds,
+        processRetentionMilliseconds: settings.processRetentionMilliseconds,
+    };
+    for (const name of ["maxMessagesPerActivationPass", "claimScanLimit"]) {
+        if (!Number.isSafeInteger(settings[name]) || settings[name] < 1) {
+            throw new TypeError(`${name} must be a positive safe integer`);
+        }
+    }
+    for (const [name, value] of Object.entries(positive)) {
+        if (!Number.isFinite(value) || value <= 0)
+            throw new TypeError(`${name} must be positive`);
+    }
+    if (settings.leaseDurationMilliseconds <= settings.leaseRenewalIntervalMilliseconds) {
+        throw new TypeError("leaseDurationMilliseconds must exceed leaseRenewalIntervalMilliseconds");
+    }
+    if (!Number.isFinite(settings.idleDeactivationTimeoutMilliseconds) ||
+        settings.idleDeactivationTimeoutMilliseconds < 0) {
+        throw new TypeError("idleDeactivationTimeoutMilliseconds must be non-negative");
+    }
+    for (const [name, value] of Object.entries({
+        retentionIntervalMilliseconds: settings.retentionIntervalMilliseconds,
+        deadProcessCleanupIntervalMilliseconds: settings.deadProcessCleanupIntervalMilliseconds,
+    })) {
+        if (!Number.isFinite(value) || value < 0)
+            throw new TypeError(`${name} must be non-negative`);
+    }
+    if (settings.supervisorMaximumRestartDelayMilliseconds < settings.supervisorRestartDelayMilliseconds) {
+        throw new TypeError("supervisorMaximumRestartDelayMilliseconds must be at least supervisorRestartDelayMilliseconds");
+    }
+    const roleCounts = {
+        workerCount: settings.workerCount,
+        effectWorkerCount: settings.effectWorkerCount,
+        broadcastWorkerCount: settings.broadcastWorkerCount,
+        reminderSchedulerCount: settings.reminderSchedulerCount,
+    };
+    for (const [name, value] of Object.entries(roleCounts)) {
+        if (!Number.isSafeInteger(value) || value < 0)
+            throw new TypeError(`${name} must be a non-negative integer`);
+    }
+    if (!Number.isSafeInteger(settings.pruneBatchSize) || settings.pruneBatchSize < 1) {
+        throw new TypeError("pruneBatchSize must be a positive safe integer");
+    }
+    validateRetentionOverrides("messageRetentionByActorType", settings.messageRetentionByActorType);
+    validateRetentionOverrides("instanceRetentionByActorType", settings.instanceRetentionByActorType);
+    const roleCount = settings.workerCount +
+        settings.effectWorkerCount +
+        settings.reminderSchedulerCount +
+        (broadcastsEnabled(settings) ? settings.broadcastWorkerCount : 0) +
+        (settings.retentionIntervalMilliseconds > 0 ? 1 : 0) +
+        (settings.deadProcessCleanupIntervalMilliseconds > 0 ? 1 : 0);
+    if (roleCount === 0)
+        throw new TypeError("at least one runtime role must be configured");
+}
+export function broadcastsEnabled(settings) {
+    return (settings.broadcast !== undefined ||
+        settings.authorizationPoliciesConfigured.authorizeSubscription === true);
+}
+function validateRetentionOverrides(name, overrides) {
+    for (const [actorType, retention] of Object.entries(overrides)) {
+        if (actorType.length === 0)
+            throw new TypeError(`${name} actor types must not be empty`);
+        if (!Number.isFinite(retention) || retention <= 0) {
+            throw new TypeError(`${name} values must be positive`);
+        }
+    }
+}
+//# sourceMappingURL=configuration.js.map

package/dist/configuration.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,20 @@
+import type { Actor } from "./actor.js";
+import type { SolidObjectsRuntime } from "./runtime.js";
+import type { MessageContext } from "./types.js";
+interface ActorExecutionContext {
+    actor: Actor;
+    runtime: SolidObjectsRuntime;
+    message?: MessageContext;
+}
+export declare function currentActor(): Actor | undefined;
+export declare function currentRuntime(): SolidObjectsRuntime | undefined;
+export declare function currentMessage(): MessageContext | undefined;
+export declare function applicationWritesForbidden(): boolean;
+export declare function withActorContext<Result>(context: ActorExecutionContext, callback: () => Result): Result;
+export declare function withActorProjection<Result>(context: {
+    actor: Actor;
+    runtime: SolidObjectsRuntime;
+}, callback: () => Result): Result;
+export declare function withApplicationWritesForbidden<Result>(callback: () => Result): Result;
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAShD,UAAU,qBAAqB;IAC7B,KAAK,EAAE,KAAK,CAAA;IACZ,OAAO,EAAE,mBAAmB,CAAA;IAC5B,OAAO,CAAC,EAAE,cAAc,CAAA;CACzB;AAID,wBAAgB,YAAY,IAAI,KAAK,GAAG,SAAS,CAEhD;AAED,wBAAgB,cAAc,IAAI,mBAAmB,GAAG,SAAS,CAEhE;AAED,wBAAgB,cAAc,IAAI,cAAc,GAAG,SAAS,CAE3D;AAED,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EACrC,OAAO,EAAE,qBAAqB,EAC9B,QAAQ,EAAE,MAAM,MAAM,GACrB,MAAM,CAER;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EACxC,OAAO,EAAE;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,mBAAmB,CAAA;CAAE,EACvD,QAAQ,EAAE,MAAM,MAAM,GACrB,MAAM,CAER;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,MAAM,GAAG,MAAM,CAErF"}

package/dist/context.js

@@ -0,0 +1,24 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+const storage = new AsyncLocalStorage();
+export function currentActor() {
+    return storage.getStore()?.actor;
+}
+export function currentRuntime() {
+    return storage.getStore()?.runtime;
+}
+export function currentMessage() {
+    return storage.getStore()?.message;
+}
+export function applicationWritesForbidden() {
+    return storage.getStore()?.applicationWritesForbidden === true;
+}
+export function withActorContext(context, callback) {
+    return storage.run({ ...context, applicationWritesForbidden: true }, callback);
+}
+export function withActorProjection(context, callback) {
+    return storage.run({ ...context, applicationWritesForbidden: true }, callback);
+}
+export function withApplicationWritesForbidden(callback) {
+    return storage.run({ ...storage.getStore(), applicationWritesForbidden: true }, callback);
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAkBpD,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAoB,CAAA;AAEzD,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAA;AAClC,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,OAAO,CAAA;AACpC,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,OAAO,CAAA;AACpC,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,0BAA0B,KAAK,IAAI,CAAA;AAChE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAA8B,EAC9B,QAAsB;IAEtB,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,EAAE,0BAA0B,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAA;AAChF,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAAuD,EACvD,QAAsB;IAEtB,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,EAAE,0BAA0B,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAA;AAChF,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAS,QAAsB;IAC3E,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,EAAE,0BAA0B,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAA;AAC3F,CAAC"}

package/dist/database/deadline.d.ts

@@ -0,0 +1,9 @@
+import { DatabaseDeadlineExceeded } from "../errors.js";
+export declare function withDatabaseDeadline<Result>(options: {
+    timeoutMilliseconds: number;
+}, operation: () => Promise<Result>): Promise<Result>;
+export declare function databaseDeadlineRemainingMilliseconds(): number | undefined;
+export declare function requireDatabaseDeadlineRemaining(): number | undefined;
+export declare function databaseDeadlineError(error: unknown): DatabaseDeadlineExceeded;
+export declare function acquireBeforeDatabaseDeadline<Resource>(acquire: () => Promise<Resource>, release: (resource: Resource) => void): Promise<Resource>;
+//# sourceMappingURL=deadline.d.ts.map

package/dist/database/deadline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.d.ts","sourceRoot":"","sources":["../../src/database/deadline.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAA;AAQvD,wBAAgB,oBAAoB,CAAC,MAAM,EACzC,OAAO,EAAE;IAAE,mBAAmB,EAAE,MAAM,CAAA;CAAE,EACxC,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAC/B,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,wBAAgB,qCAAqC,IAAI,MAAM,GAAG,SAAS,CAI1E;AAED,wBAAgB,gCAAgC,IAAI,MAAM,GAAG,SAAS,CAKrE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAE9E;AAED,wBAAsB,6BAA6B,CAAC,QAAQ,EAC1D,OAAO,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,EAChC,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,GACpC,OAAO,CAAC,QAAQ,CAAC,CAyBnB"}

package/dist/database/deadline.js

@@ -0,0 +1,49 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { DatabaseDeadlineExceeded } from "../errors.js";
+const deadlines = new AsyncLocalStorage();
+export function withDatabaseDeadline(options, operation) {
+    return deadlines.run({ expiresAt: performance.now() + options.timeoutMilliseconds }, operation);
+}
+export function databaseDeadlineRemainingMilliseconds() {
+    const deadline = deadlines.getStore();
+    if (!deadline)
+        return undefined;
+    return Math.max(Math.floor(deadline.expiresAt - performance.now()), 0);
+}
+export function requireDatabaseDeadlineRemaining() {
+    const remaining = databaseDeadlineRemainingMilliseconds();
+    if (remaining === undefined)
+        return undefined;
+    if (remaining > 0)
+        return remaining;
+    throw new DatabaseDeadlineExceeded("database deadline exceeded");
+}
+export function databaseDeadlineError(error) {
+    return new DatabaseDeadlineExceeded("database deadline exceeded", { cause: error });
+}
+export async function acquireBeforeDatabaseDeadline(acquire, release) {
+    const remaining = requireDatabaseDeadlineRemaining();
+    const acquisition = acquire();
+    if (remaining === undefined)
+        return acquisition;
+    return new Promise((resolve, reject) => {
+        let expired = false;
+        const timeout = setTimeout(() => {
+            expired = true;
+            reject(new DatabaseDeadlineExceeded("database deadline exceeded"));
+        }, remaining);
+        void acquisition.then((resource) => {
+            clearTimeout(timeout);
+            if (expired) {
+                release(resource);
+                return;
+            }
+            resolve(resource);
+        }, (error) => {
+            clearTimeout(timeout);
+            if (!expired)
+                reject(error);
+        });
+    });
+}
+//# sourceMappingURL=deadline.js.map

package/dist/database/deadline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.js","sourceRoot":"","sources":["../../src/database/deadline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAA;AAMvD,MAAM,SAAS,GAAG,IAAI,iBAAiB,EAAoB,CAAA;AAE3D,MAAM,UAAU,oBAAoB,CAClC,OAAwC,EACxC,SAAgC;IAEhC,OAAO,SAAS,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,mBAAmB,EAAE,EAAE,SAAS,CAAC,CAAA;AACjG,CAAC;AAED,MAAM,UAAU,qCAAqC;IACnD,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAA;IACrC,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;AACxE,CAAC;AAED,MAAM,UAAU,gCAAgC;IAC9C,MAAM,SAAS,GAAG,qCAAqC,EAAE,CAAA;IACzD,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC7C,IAAI,SAAS,GAAG,CAAC;QAAE,OAAO,SAAS,CAAA;IACnC,MAAM,IAAI,wBAAwB,CAAC,4BAA4B,CAAC,CAAA;AAClE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,OAAO,IAAI,wBAAwB,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;AACrF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,OAAgC,EAChC,OAAqC;IAErC,MAAM,SAAS,GAAG,gCAAgC,EAAE,CAAA;IACpD,MAAM,WAAW,GAAG,OAAO,EAAE,CAAA;IAC7B,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,WAAW,CAAA;IAC/C,OAAO,IAAI,OAAO,CAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC/C,IAAI,OAAO,GAAG,KAAK,CAAA;QACnB,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,OAAO,GAAG,IAAI,CAAA;YACd,MAAM,CAAC,IAAI,wBAAwB,CAAC,4BAA4B,CAAC,CAAC,CAAA;QACpE,CAAC,EAAE,SAAS,CAAC,CAAA;QACb,KAAK,WAAW,CAAC,IAAI,CACnB,CAAC,QAAQ,EAAE,EAAE;YACX,YAAY,CAAC,OAAO,CAAC,CAAA;YACrB,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,QAAQ,CAAC,CAAA;gBACjB,OAAM;YACR,CAAC;YACD,OAAO,CAAC,QAAQ,CAAC,CAAA;QACnB,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,YAAY,CAAC,OAAO,CAAC,CAAA;YACrB,IAAI,CAAC,OAAO;gBAAE,MAAM,CAAC,KAAK,CAAC,CAAA;QAC7B,CAAC,CACF,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}