solid-objects 0.12.0

package/dist/database/sqlite.js

@@ -0,0 +1,190 @@
+import { DatabaseSync } from "node:sqlite";
+import { databaseDeadlineError, databaseDeadlineRemainingMilliseconds, requireDatabaseDeadlineRemaining, } from "./deadline.js";
+import { DatabaseDeadlineExceeded } from "../errors.js";
+import { databaseTransactionActive, withDatabaseTransaction } from "./transaction-context.js";
+class SQLiteConnection {
+    database;
+    constructor(database) {
+        this.database = database;
+    }
+    async run(sql, parameters = []) {
+        requireDatabaseDeadlineRemaining();
+        const result = this.database.prepare(sql).run(...parameters.map(normalizeParameter));
+        const output = { changes: Number(result.changes) };
+        if (result.lastInsertRowid !== 0)
+            output.lastInsertId = String(result.lastInsertRowid);
+        return output;
+    }
+    async get(sql, parameters = []) {
+        requireDatabaseDeadlineRemaining();
+        return this.database.prepare(sql).get(...parameters.map(normalizeParameter));
+    }
+    async all(sql, parameters = []) {
+        requireDatabaseDeadlineRemaining();
+        return this.database.prepare(sql).all(...parameters.map(normalizeParameter));
+    }
+    async nowMilliseconds() {
+        requireDatabaseDeadlineRemaining();
+        const row = this.database
+            .prepare("SELECT CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER) AS now_ms")
+            .get();
+        return Number(row.now_ms);
+    }
+}
+export class SQLiteDatabase {
+    family = "sqlite";
+    schemaIdentity = "solid-objects-node-v1";
+    database;
+    databaseConnection;
+    accessTail = Promise.resolve();
+    closed = false;
+    timeoutMilliseconds;
+    lockRetryAttempts;
+    constructor(options) {
+        this.timeoutMilliseconds = options.timeoutMilliseconds ?? 5_000;
+        this.lockRetryAttempts = options.lockRetryAttempts ?? 10;
+        if (!Number.isSafeInteger(this.lockRetryAttempts) || this.lockRetryAttempts < 1) {
+            throw new TypeError("lockRetryAttempts must be a positive safe integer");
+        }
+        this.database = new DatabaseSync(options.path, {
+            timeout: this.timeoutMilliseconds,
+            readBigInts: true,
+        });
+        this.database.exec("PRAGMA foreign_keys = ON");
+        this.databaseConnection = new SQLiteConnection(this.database);
+    }
+    async connection(callback) {
+        return this.withAccess(() => callback(this.databaseConnection));
+    }
+    async transaction(callback) {
+        return withDatabaseTransaction(this, () => this.withAccess(() => this.runTransaction(callback)));
+    }
+    transactionActive() {
+        return databaseTransactionActive(this);
+    }
+    async close() {
+        if (this.closed)
+            return;
+        await this.accessTail;
+        if (this.closed)
+            return;
+        this.database.close();
+        this.closed = true;
+    }
+    async withAccess(callback) {
+        const initialRemaining = requireDatabaseDeadlineRemaining();
+        const previous = this.accessTail;
+        let release = () => { };
+        this.accessTail = new Promise((resolve) => {
+            release = resolve;
+        });
+        if (initialRemaining !== undefined) {
+            try {
+                await waitForAccess(previous, initialRemaining);
+            }
+            catch (error) {
+                void previous.then(release, release);
+                throw error;
+            }
+        }
+        else {
+            await previous;
+        }
+        try {
+            if (initialRemaining !== undefined)
+                requireDatabaseDeadlineRemaining();
+            return await this.withBusyTimeout(callback);
+        }
+        finally {
+            release();
+        }
+    }
+    async withBusyTimeout(callback) {
+        const remaining = requireDatabaseDeadlineRemaining();
+        if (remaining === undefined)
+            return callback();
+        this.database.exec(`PRAGMA busy_timeout = ${Math.max(remaining, 1)}`);
+        try {
+            return await callback();
+        }
+        catch (error) {
+            if (!sqliteBusyError(error))
+                throw error;
+            throw databaseDeadlineError(error);
+        }
+        finally {
+            this.database.exec(`PRAGMA busy_timeout = ${this.timeoutMilliseconds}`);
+        }
+    }
+    async runTransaction(callback) {
+        await this.beginTransactionWithRetry();
+        try {
+            const result = await callback(this.databaseConnection);
+            this.database.exec("COMMIT");
+            return result;
+        }
+        catch (error) {
+            this.database.exec("ROLLBACK");
+            throw error;
+        }
+    }
+    async beginTransactionWithRetry() {
+        let retries = 0;
+        while (true) {
+            try {
+                this.database.exec("BEGIN IMMEDIATE");
+                return;
+            }
+            catch (error) {
+                if (databaseDeadlineRemainingMilliseconds() !== undefined)
+                    throw error;
+                if (!sqliteBusyError(error) || retries >= this.lockRetryAttempts)
+                    throw error;
+                retries += 1;
+                await waitForRetry(retries);
+            }
+        }
+    }
+}
+function waitForAccess(access, timeoutMilliseconds) {
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => reject(new DatabaseDeadlineExceeded("database deadline exceeded")), timeoutMilliseconds);
+        void access.then(() => {
+            clearTimeout(timeout);
+            resolve();
+        }, (error) => {
+            clearTimeout(timeout);
+            reject(error);
+        });
+    });
+}
+function waitForRetry(attempt) {
+    const milliseconds = Math.min(2 ** (attempt - 1), 250);
+    return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+export function sqlite(options) {
+    return new SQLiteDatabase(options);
+}
+function normalizeParameter(value) {
+    if (value === undefined)
+        return null;
+    if (value === null ||
+        typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "bigint" ||
+        value instanceof Uint8Array)
+        return value;
+    if (typeof value === "boolean")
+        return value ? 1 : 0;
+    throw new TypeError(`unsupported SQLite parameter ${typeof value}`);
+}
+function sqliteBusyError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        (error.code === "ERR_SQLITE_ERROR" || error.code === "SQLITE_BUSY") &&
+        "message" in error &&
+        typeof error.message === "string" &&
+        error.message.includes("database is locked"));
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/database/sqlite.js.map

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

package/dist/database/transaction-context.d.ts

@@ -0,0 +1,3 @@
+export declare function withDatabaseTransaction<Result>(database: object, operation: () => Promise<Result>): Promise<Result>;
+export declare function databaseTransactionActive(database: object): boolean;
+//# sourceMappingURL=transaction-context.d.ts.map

package/dist/database/transaction-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-context.d.ts","sourceRoot":"","sources":["../../src/database/transaction-context.ts"],"names":[],"mappings":"AASA,wBAAgB,uBAAuB,CAAC,MAAM,EAC5C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAC/B,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAKnE"}

package/dist/database/transaction-context.js

@@ -0,0 +1,19 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+const transactionScopes = new AsyncLocalStorage();
+export function withDatabaseTransaction(database, operation) {
+    const scope = { database, active: true };
+    const scopes = [...(transactionScopes.getStore() ?? []), scope];
+    return transactionScopes.run(scopes, async () => {
+        try {
+            return await operation();
+        }
+        finally {
+            scope.active = false;
+        }
+    });
+}
+export function databaseTransactionActive(database) {
+    return (transactionScopes.getStore()?.some((scope) => scope.database === database && scope.active) ??
+        false);
+}
+//# sourceMappingURL=transaction-context.js.map

package/dist/database/transaction-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-context.js","sourceRoot":"","sources":["../../src/database/transaction-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAOpD,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAA+B,CAAA;AAE9E,MAAM,UAAU,uBAAuB,CACrC,QAAgB,EAChB,SAAgC;IAEhC,MAAM,KAAK,GAAqB,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;IAC1D,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;IAC/D,OAAO,iBAAiB,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;QAC9C,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAA;QAC1B,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,MAAM,GAAG,KAAK,CAAA;QACtB,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,QAAgB;IACxD,OAAO,CACL,iBAAiB,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC;QAC1F,KAAK,CACN,CAAA;AACH,CAAC"}

package/dist/database/types.d.ts

@@ -0,0 +1,20 @@
+export type DatabaseFamily = "sqlite" | "postgresql" | "mysql";
+export interface RunResult {
+    changes: number;
+    lastInsertId?: string;
+}
+export interface DatabaseConnection {
+    run(sql: string, parameters?: readonly unknown[]): Promise<RunResult>;
+    get<Row extends object>(sql: string, parameters?: readonly unknown[]): Promise<Row | undefined>;
+    all<Row extends object>(sql: string, parameters?: readonly unknown[]): Promise<Row[]>;
+    nowMilliseconds(): Promise<number>;
+}
+export interface Database {
+    readonly family: DatabaseFamily;
+    readonly schemaIdentity: string;
+    transactionActive?(): boolean;
+    connection<Result>(callback: (connection: DatabaseConnection) => Promise<Result>): Promise<Result>;
+    transaction<Result>(callback: (connection: DatabaseConnection) => Promise<Result>): Promise<Result>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/database/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAA;AAE9D,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;IACrE,GAAG,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAAA;IAC/F,GAAG,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IACrF,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,iBAAiB,CAAC,IAAI,OAAO,CAAA;IAC7B,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,UAAU,EAAE,kBAAkB,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAClG,WAAW,CAAC,MAAM,EAChB,QAAQ,EAAE,CAAC,UAAU,EAAE,kBAAkB,KAAK,OAAO,CAAC,MAAM,CAAC,GAC5D,OAAO,CAAC,MAAM,CAAC,CAAA;IAClB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB"}

package/dist/database/types.js

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

package/dist/database/types.js.map

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

package/dist/dead-letters.d.ts

@@ -0,0 +1,23 @@
+import type { MessageReference } from "./reference.js";
+import type { SolidObjectsRuntime } from "./runtime.js";
+import type { AdministrationOptions, DeepReadonly, JsonObject, JsonValue } from "./types.js";
+export interface DeadLetter {
+    readonly id: string;
+    readonly messageId: string;
+    readonly actorType: string;
+    readonly actorId: string;
+    readonly operation: string;
+    readonly deliveryMode: "async" | "sync" | "internal";
+    readonly arguments: DeepReadonly<JsonObject>;
+    readonly attempts: number;
+    readonly error: DeepReadonly<Record<string, JsonValue>>;
+    readonly createdAt: Date;
+    readonly retriedMessageId: string | null;
+}
+export declare class DeadLetterManager {
+    private readonly runtime;
+    constructor(runtime: SolidObjectsRuntime);
+    all(options?: AdministrationOptions): Promise<readonly DeadLetter[]>;
+    retry(id: string, options?: AdministrationOptions): Promise<MessageReference>;
+}
+//# sourceMappingURL=dead-letters.d.ts.map

package/dist/dead-letters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letters.d.ts","sourceRoot":"","sources":["../src/dead-letters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE5F,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,YAAY,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,CAAA;IACpD,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC,UAAU,CAAC,CAAA;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;IACvD,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;IACxB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;CACzC;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,mBAAmB;IAEzD,GAAG,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC;IAIxE,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAGlF"}

package/dist/dead-letters.js

@@ -0,0 +1,13 @@
+export class DeadLetterManager {
+    runtime;
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    all(options = {}) {
+        return this.runtime.inspectDeadLetters(options);
+    }
+    retry(id, options = {}) {
+        return this.runtime.retryDeadLetter(id, options);
+    }
+}
+//# sourceMappingURL=dead-letters.js.map

package/dist/dead-letters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letters.js","sourceRoot":"","sources":["../src/dead-letters.ts"],"names":[],"mappings":"AAkBA,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,OAA4B;QAA5B,YAAO,GAAP,OAAO,CAAqB;IAAG,CAAC;IAE7D,GAAG,CAAC,UAAiC,EAAE;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAA;IACjD,CAAC;IAED,KAAK,CAAC,EAAU,EAAE,UAAiC,EAAE;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IAClD,CAAC;CACF"}

package/dist/default-runtime.d.ts

@@ -0,0 +1,5 @@
+import type { SolidObjectsRuntime } from "./runtime.js";
+export declare function setDefaultRuntime(value: SolidObjectsRuntime): void;
+export declare function getDefaultRuntime(): SolidObjectsRuntime;
+export declare function clearDefaultRuntime(value?: SolidObjectsRuntime): void;
+//# sourceMappingURL=default-runtime.d.ts.map

package/dist/default-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-runtime.d.ts","sourceRoot":"","sources":["../src/default-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAIvD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAElE;AAED,wBAAgB,iBAAiB,IAAI,mBAAmB,CAGvD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAErE"}

package/dist/default-runtime.js

@@ -0,0 +1,14 @@
+let runtime;
+export function setDefaultRuntime(value) {
+    runtime = value;
+}
+export function getDefaultRuntime() {
+    if (!runtime)
+        throw new Error("SolidObjects.configure must be called before Actor.ref");
+    return runtime;
+}
+export function clearDefaultRuntime(value) {
+    if (value === undefined || runtime === value)
+        runtime = undefined;
+}
+//# sourceMappingURL=default-runtime.js.map

package/dist/default-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-runtime.js","sourceRoot":"","sources":["../src/default-runtime.ts"],"names":[],"mappings":"AAEA,IAAI,OAAwC,CAAA;AAE5C,MAAM,UAAU,iBAAiB,CAAC,KAA0B;IAC1D,OAAO,GAAG,KAAK,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAA;IACvF,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAA2B;IAC7D,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK;QAAE,OAAO,GAAG,SAAS,CAAA;AACnE,CAAC"}

package/dist/definition.d.ts

@@ -0,0 +1,32 @@
+import { Actor, type ActorClass } from "./actor.js";
+import type { JsonObject } from "./types.js";
+export type PayloadBroadcastHandler = (actor: Actor, authorizationContext: unknown) => unknown | Promise<unknown>;
+export interface StateMigration {
+    from: number;
+    to: number;
+    migrate(state: JsonObject): JsonObject;
+}
+export interface ValidatedActorDefinition<ActorType extends Actor = Actor> {
+    actorClass: ActorClass<ActorType>;
+    type: string;
+    stateKeys: readonly string[];
+    operations: readonly string[];
+    queries: readonly string[];
+    stateVersion: number;
+    migrations: readonly StateMigration[];
+    payloads: Readonly<Record<string, PayloadBroadcastHandler>>;
+}
+export declare function validateDefinition<ActorType extends Actor>(actorClass: ActorClass<ActorType>): ValidatedActorDefinition<ActorType>;
+export declare function initialStateFor(definition: ValidatedActorDefinition): JsonObject;
+export declare function actorState(actor: Actor, stateKeys?: readonly string[]): JsonObject;
+export declare function hydrateActor<ActorType extends Actor>(options: {
+    definition: ValidatedActorDefinition<ActorType>;
+    actorId: string;
+    state: JsonObject;
+}): ActorType;
+export declare function migrateState(options: {
+    definition: ValidatedActorDefinition;
+    storedVersion: number;
+    storedState: JsonObject;
+}): JsonObject;
+//# sourceMappingURL=definition.d.ts.map

package/dist/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../src/definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAA;AAInD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,MAAM,MAAM,uBAAuB,GAAG,CACpC,KAAK,EAAE,KAAK,EACZ,oBAAoB,EAAE,OAAO,KAC1B,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAE/B,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAAA;CACvC;AAED,MAAM,WAAW,wBAAwB,CAAC,SAAS,SAAS,KAAK,GAAG,KAAK;IACvE,UAAU,EAAE,UAAU,CAAC,SAAS,CAAC,CAAA;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7B,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,SAAS,cAAc,EAAE,CAAA;IACrC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAAA;CAC5D;AAED,wBAAgB,kBAAkB,CAAC,SAAS,SAAS,KAAK,EACxD,UAAU,EAAE,UAAU,CAAC,SAAS,CAAC,GAChC,wBAAwB,CAAC,SAAS,CAAC,CAsFrC;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,wBAAwB,GAAG,UAAU,CAEhF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAKlF;AAED,wBAAgB,YAAY,CAAC,SAAS,SAAS,KAAK,EAAE,OAAO,EAAE;IAC7D,UAAU,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAA;IAC/C,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,UAAU,CAAA;CAClB,GAAG,SAAS,CAOZ;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,UAAU,EAAE,wBAAwB,CAAA;IACpC,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,UAAU,CAAA;CACxB,GAAG,UAAU,CA+Bb"}

package/dist/definition.js

@@ -0,0 +1,173 @@
+import { Actor } from "./actor.js";
+import { withApplicationWritesForbidden } from "./context.js";
+import { ApplicationWriteForbidden, InvalidActor, StateMigrationError } from "./errors.js";
+import { deepCopy, jsonObject, normalizeJson } from "./serialization.js";
+export function validateDefinition(actorClass) {
+    const type = actorClass.actorType;
+    if (!type || !/^[A-Za-z0-9_.:-]+$/.test(type)) {
+        throw new InvalidActor("actorType must contain letters, digits, dots, colons, underscores, or hyphens");
+    }
+    const initialActor = new actorClass("__solid_objects_definition__");
+    const state = actorState(initialActor);
+    const stateKeys = Object.keys(state);
+    const operations = [];
+    const queries = [...stateKeys];
+    const reservedNames = actorPrototypeNames();
+    const referenceNames = new Set([
+        "actorClass",
+        "actorId",
+        "actorType",
+        "destroy",
+        "operations",
+        "queries",
+        "runtime",
+        "send",
+        "snapshot",
+        "then",
+        "with",
+    ]);
+    let prototype = actorClass.prototype;
+    while (prototype && prototype !== Actor.prototype) {
+        for (const name of Object.getOwnPropertyNames(prototype)) {
+            if (name === "constructor" || reservedNames.has(name))
+                continue;
+            const descriptor = Object.getOwnPropertyDescriptor(prototype, name);
+            if (!descriptor)
+                continue;
+            validateOperationName(name);
+            validateReferenceName(name, referenceNames);
+            if (typeof descriptor.get === "function") {
+                if (!queries.includes(name))
+                    queries.push(name);
+                continue;
+            }
+            if (typeof descriptor.value === "function" && !operations.includes(name)) {
+                operations.push(name);
+            }
+        }
+        prototype = Object.getPrototypeOf(prototype);
+    }
+    for (const stateKey of stateKeys) {
+        validateOperationName(stateKey);
+        validateReferenceName(stateKey, referenceNames);
+        if (reservedNames.has(stateKey) || operations.includes(stateKey)) {
+            throw new InvalidActor(`state field ${stateKey} conflicts with an actor operation`);
+        }
+    }
+    const stateVersion = actorClass.stateVersion ?? 1;
+    if (!Number.isSafeInteger(stateVersion) || stateVersion < 1) {
+        throw new InvalidActor("stateVersion must be a positive safe integer");
+    }
+    const migrations = actorClass.migrations ?? [];
+    const migrationStarts = new Set();
+    for (const migration of migrations) {
+        if (migration.to !== migration.from + 1) {
+            throw new InvalidActor("state migrations must advance exactly one version");
+        }
+        if (migrationStarts.has(migration.from)) {
+            throw new InvalidActor(`state migration from ${migration.from} is defined more than once`);
+        }
+        migrationStarts.add(migration.from);
+    }
+    const payloads = validatePayloads(actorClass);
+    return Object.freeze({
+        actorClass,
+        type,
+        stateKeys: Object.freeze(stateKeys),
+        operations: Object.freeze(operations),
+        queries: Object.freeze(queries),
+        stateVersion,
+        migrations: Object.freeze([...migrations]),
+        payloads,
+    });
+}
+export function initialStateFor(definition) {
+    return actorState(new definition.actorClass("__solid_objects_defaults__"), definition.stateKeys);
+}
+export function actorState(actor, stateKeys) {
+    const keys = stateKeys ?? Object.keys(actor);
+    const state = {};
+    for (const key of keys)
+        state[key] = actor[key];
+    return jsonObject(state);
+}
+export function hydrateActor(options) {
+    const { definition, actorId, state } = options;
+    const actor = new definition.actorClass(actorId);
+    actor.prepare(new Set(definition.operations));
+    const target = actor;
+    for (const key of definition.stateKeys)
+        target[key] = deepCopy(state[key]);
+    return actor;
+}
+export function migrateState(options) {
+    const { definition, storedVersion, storedState } = options;
+    if (storedVersion > definition.stateVersion) {
+        throw new StateMigrationError(`stored state version ${storedVersion} is newer than code version ${definition.stateVersion}`);
+    }
+    try {
+        let state = deepCopy(storedState);
+        let version = storedVersion;
+        while (version < definition.stateVersion) {
+            const migration = definition.migrations.find((candidate) => candidate.from === version);
+            if (!migration)
+                throw new StateMigrationError(`missing state migration from version ${version}`);
+            state = jsonObject(withApplicationWritesForbidden(() => migration.migrate(deepCopy(state))));
+            version = migration.to;
+        }
+        const defaults = initialStateFor(definition);
+        for (const [key, value] of Object.entries(defaults)) {
+            if (!(key in state))
+                state[key] = normalizeJson(value);
+        }
+        return state;
+    }
+    catch (error) {
+        if (error instanceof StateMigrationError || error instanceof ApplicationWriteForbidden) {
+            throw error;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        throw new StateMigrationError(`state migration failed: ${message}`, { cause: error });
+    }
+}
+function actorPrototypeNames() {
+    const names = new Set();
+    let prototype = Actor.prototype;
+    while (prototype && prototype !== Object.prototype) {
+        for (const name of Object.getOwnPropertyNames(prototype))
+            names.add(name);
+        prototype = Object.getPrototypeOf(prototype);
+    }
+    return names;
+}
+function validateOperationName(name) {
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name)) {
+        throw new InvalidActor(`invalid actor member name ${JSON.stringify(name)}`);
+    }
+}
+function validateReferenceName(name, reservedNames) {
+    if (reservedNames.has(name)) {
+        throw new InvalidActor(`actor member ${JSON.stringify(name)} conflicts with the reference API`);
+    }
+}
+function validatePayloads(actorClass) {
+    const configured = actorClass.payloads ?? {};
+    if (!isRecord(configured))
+        throw new InvalidActor("actor payloads must be an object");
+    const payloads = {};
+    for (const [name, handler] of Object.entries(configured)) {
+        validateOperationName(name);
+        if (typeof handler !== "function") {
+            throw new InvalidActor(`actor payload ${JSON.stringify(name)} must be a function`);
+        }
+        payloads[name] = handler;
+    }
+    return Object.freeze(payloads);
+}
+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=definition.js.map

package/dist/definition.js.map

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

package/dist/doctor.d.ts

@@ -0,0 +1,32 @@
+import type { SolidObjectsRuntime } from "./runtime.js";
+import type { DeepReadonly, JsonObject } from "./types.js";
+export type DoctorStatus = "pass" | "warn" | "fail" | "info" | "skip";
+export interface DoctorCheck {
+    readonly name: string;
+    readonly status: DoctorStatus;
+    readonly message: string;
+    readonly details?: DeepReadonly<JsonObject>;
+}
+export interface DoctorReport {
+    readonly healthy: boolean;
+    readonly checks: readonly DoctorCheck[];
+}
+export interface DoctorOptions {
+    roundTrip?: "run" | "skip";
+}
+export declare class Doctor {
+    private readonly runtime;
+    constructor(runtime: SolidObjectsRuntime);
+    run(options?: DoctorOptions): Promise<DoctorReport>;
+    private checkConfiguration;
+    private checkSchema;
+    private checkAuthorization;
+    private authorizationProbes;
+    private checkDatabase;
+    private checkPostgreSQL;
+    private checkMySQL;
+    private checkRuntime;
+    private checkRoundTrip;
+    private removeProbe;
+}
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE1D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;AAErE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAA;CAC5C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAA;CACxC;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;CAC3B;AAmED,qBAAa,MAAM;IACL,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,mBAAmB;IAEnD,GAAG,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAoC7D,OAAO,CAAC,kBAAkB;YAYZ,WAAW;YAuEX,kBAAkB;IA+DhC,OAAO,CAAC,mBAAmB;YA8Bb,aAAa;YA6Bb,eAAe;YAqBf,UAAU;YAkCV,YAAY;YA+BZ,cAAc;YAiDd,WAAW;CAsB1B"}