solid-objects 0.12.0

package/dist/realtime.js

@@ -0,0 +1,238 @@
+const MAXIMUM_PAYLOADS_PER_SUBSCRIPTION = 50;
+export class RealtimeManager {
+    runtime;
+    subscriptions = new Map();
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    connect(options) {
+        let session;
+        session = new ManagedRealtimeSession(options, {
+            receive: (value) => this.receive(session, value),
+            disconnect: () => this.removeSession(session),
+        });
+        return session;
+    }
+    async publish(event) {
+        const key = subscriptionKey(event);
+        const sessions = [...(this.subscriptions.get(key) ?? [])];
+        await Promise.all(sessions.map(async (session) => {
+            try {
+                await session.deliver(invalidationEnvelope(event));
+                const payloads = await this.runtime.subscriptionPayloads({
+                    actorType: event.actorType,
+                    actorId: event.actorId,
+                    payloadNames: session.payloadNames(event),
+                    authorizationContext: session.authorizationContext,
+                });
+                for (const payload of payloads)
+                    await session.deliver(payload);
+            }
+            catch (error) {
+                this.remove(session, event);
+                this.runtime.emitInstrumentation("subscription.delivery_failed", {
+                    actorType: event.actorType,
+                    actorId: event.actorId,
+                    errorName: error instanceof Error ? error.name : "Error",
+                });
+            }
+        }));
+    }
+    close() {
+        const sessions = new Set([...this.subscriptions.values()].flatMap((entries) => [...entries]));
+        for (const session of sessions)
+            session.close();
+        this.subscriptions.clear();
+    }
+    async receive(session, value) {
+        if (session.closed)
+            throw new TypeError("realtime connection is closed");
+        const request = parseSubscriptionRequest(value);
+        if (request.action === "unsubscribe") {
+            this.remove(session, request);
+            return;
+        }
+        try {
+            const snapshot = await this.runtime.subscriptionSnapshot({
+                actorType: request.actorType,
+                actorId: request.actorId,
+                authorizationContext: session.authorizationContext,
+                onAuthorized: () => {
+                    if (!session.closed)
+                        this.add(session, request);
+                },
+            });
+            if (session.closed)
+                return;
+            const payloads = await this.runtime.subscriptionPayloads({
+                actorType: request.actorType,
+                actorId: request.actorId,
+                payloadNames: request.payloads ?? [],
+                authorizationContext: session.authorizationContext,
+            });
+            await session.deliver(invalidationEnvelope(snapshot));
+            for (const payload of payloads)
+                await session.deliver(payload);
+        }
+        catch (error) {
+            this.remove(session, request);
+            throw error;
+        }
+    }
+    removeSession(session) {
+        for (const [key, sessions] of this.subscriptions) {
+            sessions.delete(session);
+            if (sessions.size === 0)
+                this.subscriptions.delete(key);
+        }
+    }
+    add(session, subscription) {
+        const key = subscriptionKey(subscription);
+        const sessions = this.subscriptions.get(key) ?? new Set();
+        sessions.add(session);
+        this.subscriptions.set(key, sessions);
+        session.add(subscription);
+    }
+    remove(session, subscription) {
+        const key = subscriptionKey(subscription);
+        const sessions = this.subscriptions.get(key);
+        if (!sessions)
+            return;
+        sessions.delete(session);
+        if (sessions.size === 0)
+            this.subscriptions.delete(key);
+        session.remove(subscription);
+    }
+}
+class ManagedRealtimeSession {
+    options;
+    lifecycle;
+    authorizationContext;
+    #closed = false;
+    #delivery = Promise.resolve();
+    #requests = Promise.resolve();
+    #subscriptions = new Map();
+    #revisions = new Map();
+    constructor(options, lifecycle) {
+        this.options = options;
+        this.lifecycle = lifecycle;
+        this.authorizationContext = options.authorizationContext;
+    }
+    get closed() {
+        return this.#closed;
+    }
+    receive(value) {
+        const request = this.#requests.catch(() => undefined).then(() => this.lifecycle.receive(value));
+        this.#requests = request;
+        return request;
+    }
+    close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.#subscriptions.clear();
+        this.#revisions.clear();
+        this.lifecycle.disconnect();
+    }
+    deliver(envelope) {
+        const delivery = this.#delivery
+            .catch(() => undefined)
+            .then(() => {
+            if (this.#closed || !this.accepts(envelope) || !this.accept(envelope)) {
+                return;
+            }
+            return this.options.send(envelope);
+        })
+            .then(() => undefined);
+        this.#delivery = delivery;
+        return delivery;
+    }
+    remove(subscription) {
+        const key = subscriptionKey(subscription);
+        this.#subscriptions.delete(key);
+        this.#revisions.delete(key);
+    }
+    add(subscription) {
+        const key = subscriptionKey(subscription);
+        const previous = this.#subscriptions.get(key);
+        const revisions = this.#revisions.get(key);
+        for (const payload of subscription.payloads ?? []) {
+            if (!previous?.has(payload))
+                revisions?.delete(`payload:${payload}`);
+        }
+        this.#subscriptions.set(key, new Set(subscription.payloads ?? []));
+    }
+    payloadNames(subscription) {
+        return [...(this.#subscriptions.get(subscriptionKey(subscription)) ?? [])];
+    }
+    accepts(envelope) {
+        const key = subscriptionKey(envelope);
+        const payloadNames = this.#subscriptions.get(key);
+        if (!payloadNames)
+            return false;
+        if (envelope.kind === "payload" && !payloadNames.has(envelope.name))
+            return false;
+        return true;
+    }
+    accept(envelope) {
+        const key = subscriptionKey(envelope);
+        const revision = BigInt(envelope.revision);
+        const channel = envelope.kind === "payload" ? `payload:${envelope.name}` : "invalidation";
+        const revisions = this.#revisions.get(key) ?? new Map();
+        const current = revisions.get(channel);
+        if (current?.instanceId === envelope.instanceId && revision <= current.revision)
+            return false;
+        revisions.set(channel, { instanceId: envelope.instanceId, revision });
+        this.#revisions.set(key, revisions);
+        return true;
+    }
+}
+export function parseSubscriptionRequest(value) {
+    const parsed = parseValue(value);
+    if (!isRecord(parsed) || parsed.version !== 1) {
+        throw new TypeError("invalid subscription protocol version");
+    }
+    if (parsed.action !== "subscribe" && parsed.action !== "unsubscribe") {
+        throw new TypeError("invalid subscription action");
+    }
+    return Object.freeze({
+        version: 1,
+        action: parsed.action,
+        actorType: requiredString(parsed.actorType, "actorType"),
+        actorId: requiredString(parsed.actorId, "actorId"),
+        ...(parsed.payloads === undefined ? {} : { payloads: parsePayloadNames(parsed.payloads) }),
+    });
+}
+function parseValue(value) {
+    if (typeof value === "string")
+        return JSON.parse(value);
+    if (value instanceof Uint8Array)
+        return JSON.parse(new TextDecoder().decode(value));
+    return value;
+}
+function subscriptionKey(subscription) {
+    return JSON.stringify([subscription.actorType, subscription.actorId]);
+}
+function invalidationEnvelope(event) {
+    return Object.freeze({ version: 1, kind: "invalidation", ...event });
+}
+function parsePayloadNames(value) {
+    if (!Array.isArray(value) || value.length > MAXIMUM_PAYLOADS_PER_SUBSCRIPTION) {
+        throw new TypeError(`payloads must be an array of at most ${MAXIMUM_PAYLOADS_PER_SUBSCRIPTION} names`);
+    }
+    const names = value.map((name) => requiredString(name, "payload name"));
+    return Object.freeze([...new Set(names)]);
+}
+function requiredString(value, name) {
+    if (typeof value !== "string" || value.length === 0) {
+        throw new TypeError(`${name} must be a non-empty string`);
+    }
+    return value;
+}
+function isRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+//# sourceMappingURL=realtime.js.map

package/dist/realtime.js.map

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

package/dist/reconciliation.d.ts

@@ -0,0 +1,41 @@
+import type { SolidObjectsRuntime } from "./runtime.js";
+import type { ActorIdentifier, AdministrationOptions, DeepReadonly, JsonObject } from "./types.js";
+export interface ReconciliationInstance {
+    readonly id: string;
+    readonly actorType: string;
+    readonly actorId: string;
+    readonly stateVersion: number;
+    readonly revision: string;
+    readonly status: "active" | "paused";
+    readonly createdAt: Date;
+    readonly updatedAt: Date;
+}
+export interface ReconciliationPage {
+    readonly items: readonly ReconciliationInstance[];
+    readonly nextCursor: string | null;
+}
+export interface ReconciliationPageOptions extends AdministrationOptions {
+    actorType?: string;
+    cursor?: string;
+    limit?: number;
+}
+export interface QuietReconciliationOptions extends ReconciliationPageOptions {
+    quietForMilliseconds: number;
+}
+export interface ReconciliationStatesOptions extends AdministrationOptions {
+    actorType: string;
+    actorIds: readonly ActorIdentifier[];
+}
+export interface OrphanedReconciliationOptions extends ReconciliationPageOptions {
+    actorType: string;
+    ownerIds: readonly ActorIdentifier[];
+}
+export declare class ReconciliationManager {
+    private readonly runtime;
+    constructor(runtime: SolidObjectsRuntime);
+    active(options?: ReconciliationPageOptions): Promise<ReconciliationPage>;
+    withoutPendingWork(options: QuietReconciliationOptions): Promise<ReconciliationPage>;
+    statesFor(options: ReconciliationStatesOptions): Promise<DeepReadonly<Record<string, JsonObject>>>;
+    orphaned(options: OrphanedReconciliationOptions): Promise<ReconciliationPage>;
+}
+//# sourceMappingURL=reconciliation.d.ts.map

package/dist/reconciliation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation.d.ts","sourceRoot":"","sources":["../src/reconciliation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAElG,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAA;IACpC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,sBAAsB,EAAE,CAAA;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CACnC;AAED,MAAM,WAAW,yBAA0B,SAAQ,qBAAqB;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,0BAA2B,SAAQ,yBAAyB;IAC3E,oBAAoB,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,2BAA4B,SAAQ,qBAAqB;IACxE,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAA;CACrC;AAED,MAAM,WAAW,6BAA8B,SAAQ,yBAAyB;IAC9E,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAA;CACrC;AAED,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,mBAAmB;IAEzD,MAAM,CAAC,OAAO,GAAE,yBAA8B,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI5E,kBAAkB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIpF,SAAS,CACP,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAIpD,QAAQ,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAG9E"}

package/dist/reconciliation.js

@@ -0,0 +1,19 @@
+export class ReconciliationManager {
+    runtime;
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    active(options = {}) {
+        return this.runtime.activeInstances(options);
+    }
+    withoutPendingWork(options) {
+        return this.runtime.instancesWithoutPendingWork(options);
+    }
+    statesFor(options) {
+        return this.runtime.instanceStatesFor(options);
+    }
+    orphaned(options) {
+        return this.runtime.orphanedInstances(options);
+    }
+}
+//# sourceMappingURL=reconciliation.js.map

package/dist/reconciliation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation.js","sourceRoot":"","sources":["../src/reconciliation.ts"],"names":[],"mappings":"AAuCA,MAAM,OAAO,qBAAqB;IACH;IAA7B,YAA6B,OAA4B;QAA5B,YAAO,GAAP,OAAO,CAAqB;IAAG,CAAC;IAE7D,MAAM,CAAC,UAAqC,EAAE;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;IAC9C,CAAC;IAED,kBAAkB,CAAC,OAAmC;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAA;IAC1D,CAAC;IAED,SAAS,CACP,OAAoC;QAEpC,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAChD,CAAC;IAED,QAAQ,CAAC,OAAsC;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAChD,CAAC;CACF"}

package/dist/records.d.ts

@@ -0,0 +1,137 @@
+import type { JsonObject } from "./types.js";
+export interface ProcessRow {
+    id: string;
+    kind: string;
+    hostname: string;
+    host_process_id: number | bigint;
+    metadata: string;
+    started_at_ms: number | bigint;
+    heartbeat_at_ms: number | bigint;
+    shutdown_requested_at_ms: number | bigint | null;
+    stopped_at_ms: number | bigint | null;
+    shutdown_state: "running" | "draining" | "stopped";
+}
+export interface InstanceRow {
+    id: string;
+    actor_type: string;
+    actor_id: string;
+    state: string;
+    state_version: number | bigint;
+    state_revision: number | bigint;
+    next_message_sequence: number | bigint;
+    activation_owner_id: string | null;
+    activation_token: string | null;
+    activation_expires_at_ms: number | bigint | null;
+    activation_generation: number | bigint;
+    paused: number | bigint;
+    created_at_ms: number | bigint;
+    updated_at_ms: number | bigint;
+}
+export interface MessageRow {
+    id: string;
+    request_id: string;
+    idempotency_key: string | null;
+    instance_id: string;
+    actor_type: string;
+    actor_id: string;
+    sequence: number | bigint;
+    operation: string;
+    delivery_mode: "async" | "sync" | "internal";
+    arguments: string;
+    result: string | null;
+    rejection: string | null;
+    error: string | null;
+    attempt_count: number | bigint;
+    max_attempts: number | bigint;
+    completed_at_ms: number | bigint | null;
+    created_at_ms: number | bigint;
+    updated_at_ms: number | bigint;
+}
+export interface DeadLetterRow {
+    id: string;
+    message_id: string;
+    instance_id: string;
+    actor_type: string;
+    actor_id: string;
+    operation: string;
+    delivery_mode: "async" | "sync" | "internal";
+    arguments: string;
+    attempts: number | bigint;
+    error: string;
+    created_at_ms: number | bigint;
+    retried_message_id: string | null;
+}
+export interface ClaimedTurn {
+    instance: InstanceRow;
+    message: MessageRow;
+    processId: string;
+    activationToken: string;
+    activationGeneration: bigint;
+    nowMilliseconds: number;
+}
+export interface ActivationLease {
+    instanceId: string;
+    processId: string;
+    activationToken: string;
+    activationGeneration: bigint;
+}
+export interface EnqueueInput {
+    actorType: string;
+    actorId: string;
+    operation: string;
+    deliveryMode: "async" | "sync" | "internal";
+    arguments: JsonObject;
+    initialState?: JsonObject;
+    stateVersion?: number;
+    availableAtMilliseconds?: number;
+    idempotencyKey?: string;
+}
+export interface EffectRow {
+    id: string;
+    message_id: string;
+    instance_id: string;
+    actor_type: string;
+    actor_id: string;
+    name: string;
+    arguments: string;
+    success_operation: string | null;
+    failure_operation: string | null;
+    status: "pending" | "processing" | "completed" | "dead";
+    attempt_count: number | bigint;
+    max_attempts: number | bigint;
+    available_at_ms: number | bigint;
+    claimed_by: string | null;
+    result: string | null;
+    error: string | null;
+}
+export interface ReminderRow {
+    id: string;
+    instance_id: string;
+    actor_type: string;
+    actor_id: string;
+    operation: string;
+    run_at_ms: number | bigint;
+    arguments: string;
+    interval_ms: number | bigint | null;
+    missed_policy: "latest" | "all";
+    occurrence: number | bigint;
+    status: "scheduled" | "paused" | "completed";
+    claimed_by: string | null;
+    claimed_at_ms: number | bigint | null;
+    error: string | null;
+}
+export interface BroadcastRow {
+    id: string;
+    message_id: string;
+    instance_id: string;
+    actor_type: string;
+    actor_id: string;
+    state_revision: number | bigint;
+    observables: string;
+    status: "pending" | "processing" | "delivered" | "dead";
+    attempt_count: number | bigint;
+    available_at_ms: number | bigint;
+    claimed_by: string | null;
+    error: string | null;
+}
+//# sourceMappingURL=records.d.ts.map

package/dist/records.d.ts.map

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

package/dist/records.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=records.js.map

package/dist/records.js.map

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

package/dist/reference.d.ts

@@ -0,0 +1,97 @@
+import type { Actor, ActorClass } from "./actor.js";
+import type { SolidObjectsRuntime } from "./runtime.js";
+import type { AsyncInvocationOptions, DeepReadonly, DestroyOptions, InvocationOptions, JsonObject, MessageStatus, SnapshotOptions } from "./types.js";
+type FunctionKeys<Value> = {
+    [Key in keyof Value]-?: Value[Key] extends (...argumentsValue: any[]) => any ? Key : never;
+}[keyof Value];
+type DataKeys<Value> = {
+    [Key in keyof Value]-?: Value[Key] extends (...argumentsValue: any[]) => any ? never : Key;
+}[keyof Value];
+export type ActorOperationNames<ActorType extends Actor> = Exclude<Extract<FunctionKeys<ActorType>, string>, Extract<keyof Actor, string>>;
+export type ActorQueryNames<ActorType extends Actor> = Exclude<Extract<DataKeys<ActorType>, string>, Extract<keyof Actor, string>>;
+export type ActorSnapshot<ActorType extends Actor> = {
+    readonly [Key in ActorQueryNames<ActorType>]: DeepReadonly<Awaited<ActorType[Key]>>;
+};
+type MethodResult<Method> = Method extends (...argumentsValue: any[]) => infer Result ? Awaited<Result> : never;
+type OperationArguments<Method> = Method extends (...argumentsValue: infer Arguments) => any ? Arguments extends [] ? Arguments : Arguments extends [unknown?] ? Exclude<Arguments[0], undefined> extends readonly unknown[] ? never : Exclude<Arguments[0], undefined> extends object ? Arguments : never : never : never;
+type InvokedMethod<Method> = Method extends (...argumentsValue: any[]) => infer Result ? [OperationArguments<Method>] extends [never] ? never : (...argumentsValue: OperationArguments<Method>) => Promise<DeepReadonly<Awaited<Result>>> : never;
+type SentMethod<Method> = Method extends (...argumentsValue: any[]) => any ? [OperationArguments<Method>] extends [never] ? never : (...argumentsValue: OperationArguments<Method>) => Promise<MessageReference<MethodResult<Method>>> : never;
+type StagedMethod<Method> = Method extends (...argumentsValue: any[]) => any ? [OperationArguments<Method>] extends [never] ? never : (...argumentsValue: OperationArguments<Method>) => void : never;
+type DirectMessages<ActorType extends Actor> = {
+    [Key in ActorOperationNames<ActorType>]: InvokedMethod<ActorType[Key]>;
+};
+type DirectQueries<ActorType extends Actor> = {
+    readonly [Key in ActorQueryNames<ActorType>]: Promise<DeepReadonly<Awaited<ActorType[Key]>>>;
+};
+type SentMessages<ActorType extends Actor> = {
+    [Key in ActorOperationNames<ActorType>]: SentMethod<ActorType[Key]>;
+};
+export type StagedOperations<ActorType extends Actor> = {
+    [Key in keyof ActorType as Key extends keyof Actor ? never : ActorType[Key] extends (...argumentsValue: any[]) => any ? Key : never]: StagedMethod<ActorType[Key]>;
+};
+export interface ScheduledOperations {
+    [operation: string]: (argumentsValue?: Record<string, unknown>) => void;
+}
+export type ActorReference<ActorType extends Actor> = ActorReferenceCore<ActorType> & DirectMessages<ActorType> & DirectQueries<ActorType>;
+export type ActorMessageSender<ActorType extends Actor> = ActorMessageSenderCore<ActorType> & SentMessages<ActorType>;
+export type ActorInvoker<ActorType extends Actor> = DirectMessages<ActorType> & DirectQueries<ActorType>;
+export declare class MessageReference<Result = unknown> {
+    private readonly runtime;
+    private readonly databaseTransactionActive;
+    readonly id: string;
+    readonly requestId: string;
+    readonly actorType: string;
+    readonly actorId: string;
+    readonly sequence: bigint;
+    private readonly operation;
+    constructor(options: {
+        runtime: SolidObjectsRuntime;
+        id: string;
+        requestId: string;
+        actorType: string;
+        actorId: string;
+        sequence: bigint;
+        operation?: string;
+        databaseTransactionActive?: () => boolean;
+    });
+    status(options?: SnapshotOptions): Promise<MessageStatus>;
+    result(options?: SnapshotOptions): Promise<DeepReadonly<Result> | undefined>;
+    wait(options?: InvocationOptions): Promise<DeepReadonly<Result>>;
+}
+export declare class ActorMessageSenderCore<ActorType extends Actor> {
+    private readonly reference;
+    constructor(reference: ActorReferenceCore<ActorType>);
+    with(options: AsyncInvocationOptions): ActorMessageSender<ActorType>;
+}
+export declare class ActorReferenceCore<ActorType extends Actor> {
+    readonly send: ActorMessageSender<ActorType>;
+    readonly runtime: SolidObjectsRuntime;
+    readonly actorClass: ActorClass<ActorType>;
+    readonly actorType: string;
+    readonly actorId: string;
+    readonly operations: ReadonlySet<string>;
+    readonly queries: ReadonlySet<string>;
+    constructor(options: {
+        runtime: SolidObjectsRuntime;
+        actorClass: ActorClass<ActorType>;
+        actorType: string;
+        actorId: string;
+        operations: ReadonlySet<string>;
+        queries: ReadonlySet<string>;
+    });
+    with(options: InvocationOptions): ActorInvoker<ActorType>;
+    snapshot(options?: SnapshotOptions): Promise<ActorSnapshot<ActorType>>;
+    destroy(options?: DestroyOptions): Promise<boolean>;
+}
+export declare function createActorReference<ActorType extends Actor>(options: {
+    runtime: SolidObjectsRuntime;
+    actorClass: ActorClass<ActorType>;
+    actorType: string;
+    actorId: string;
+    operations: ReadonlySet<string>;
+    queries: ReadonlySet<string>;
+}): ActorReference<ActorType>;
+export declare function createStagedOperations<ActorType extends Actor>(operations: ReadonlySet<string>, dispatch: (operation: string, argumentsValue: JsonObject) => void): StagedOperations<ActorType>;
+export declare function createStagedOperationMap(operations: ReadonlySet<string>, dispatch: (operation: string, argumentsValue: JsonObject) => void): ScheduledOperations;
+export {};
+//# sourceMappingURL=reference.d.ts.map

package/dist/reference.d.ts.map

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