@miadi/ncp-story-studio 0.1.0

package/dist/store/neon.js

@@ -0,0 +1,167 @@
+import { StoryStoreConflictError, StoryStoreReadOnlyError, summarizeProject, } from './index.js';
+function iso(value) {
+    if (value instanceof Date)
+        return Number.isNaN(value.getTime()) ? EPOCH : value.toISOString();
+    if (typeof value === 'string') {
+        const parsed = new Date(value);
+        return Number.isNaN(parsed.getTime()) ? EPOCH : parsed.toISOString();
+    }
+    return EPOCH;
+}
+/** Stand-in timestamp for a row whose own value cannot be read. */
+const EPOCH = '1970-01-01T00:00:00.000Z';
+function asJson(value) {
+    if (value === null || value === undefined)
+        return undefined;
+    return typeof value === 'string' ? JSON.parse(value) : value;
+}
+function rowToProject(row) {
+    const meta = asJson(row.meta);
+    const readOnly = meta?.['read_only'] === true;
+    return {
+        project_id: row.project_id,
+        document: asJson(row.document),
+        meta,
+        created_at: iso(row.created_at),
+        updated_at: iso(row.updated_at),
+        ...(readOnly ? { read_only: true } : {}),
+    };
+}
+function rowsOf(result) {
+    return Array.isArray(result) ? result : result.rows;
+}
+function safeTable(name) {
+    if (!/^[a-z_][a-z0-9_]{0,62}$/i.test(name))
+        throw new Error(`invalid table name \`${name}\``);
+    return name;
+}
+export class NeonStoryStore {
+    kind = 'neon';
+    table;
+    queryFn;
+    connectionString;
+    initialized = false;
+    /** Rows `list()` could not read, and why. */
+    unreadable = new Map();
+    /** What the last `list()` could not read. Empty when every row read cleanly. */
+    problems() {
+        return [...this.unreadable].map(([project_id, error]) => ({ project_id, error }));
+    }
+    constructor(options) {
+        this.table = safeTable(options.table ?? 'ncp_story_projects');
+        this.queryFn = options.query;
+        this.connectionString = options.connectionString;
+        if (!this.queryFn && !this.connectionString) {
+            throw new Error('NeonStoryStore needs a `connectionString` or a `query` function');
+        }
+    }
+    /** Host and database only: never the credentials. */
+    get location() {
+        if (!this.connectionString)
+            return `neon:${this.table}`;
+        try {
+            const url = new URL(this.connectionString);
+            return `neon:${url.host}${url.pathname}#${this.table}`;
+        }
+        catch {
+            return `neon:${this.table}`;
+        }
+    }
+    async query(text, values) {
+        if (!this.queryFn) {
+            // A literal specifier, so a bundler resolves it instead of failing at
+            // runtime with a message that blames a missing install.
+            let loaded;
+            try {
+                loaded = (await import('@neondatabase/serverless'));
+            }
+            catch (error) {
+                throw new Error('NeonStoryStore needs the optional peer dependency `@neondatabase/serverless`. Install it, or pass a `query` function.', { cause: error });
+            }
+            this.queryFn = loaded.neon(this.connectionString).query;
+        }
+        return rowsOf(await this.queryFn(text, values));
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        await this.query(`CREATE TABLE IF NOT EXISTS ${this.table} (
+         project_id text PRIMARY KEY,
+         document jsonb NOT NULL,
+         meta jsonb,
+         created_at timestamptz NOT NULL DEFAULT now(),
+         updated_at timestamptz NOT NULL DEFAULT now()
+       )`);
+        this.initialized = true;
+    }
+    async list() {
+        await this.init();
+        const rows = await this.query(`SELECT project_id, document, meta, created_at, updated_at FROM ${this.table} ORDER BY updated_at DESC`);
+        const summaries = [];
+        for (const row of rows) {
+            try {
+                summaries.push(summarizeProject(rowToProject(row)));
+            }
+            catch (error) {
+                this.unreadable.set(row.project_id, error instanceof Error ? error.message : String(error));
+            }
+        }
+        return summaries;
+    }
+    async get(projectId) {
+        await this.init();
+        const rows = await this.query(`SELECT project_id, document, meta, created_at, updated_at FROM ${this.table} WHERE project_id = $1 LIMIT 1`, [projectId]);
+        const row = rows[0];
+        return row ? rowToProject(row) : undefined;
+    }
+    /**
+     * The version guard is part of the statement, not a read before it: the
+     * `ON CONFLICT` update only fires while the stored `updated_at` still matches,
+     * so two concurrent writers cannot both succeed.
+     */
+    async save(project, options) {
+        await this.init();
+        const existing = options?.expected_updated_at ? await this.get(project.project_id) : undefined;
+        if (existing?.read_only)
+            throw new StoryStoreReadOnlyError(project.project_id);
+        if (options?.expected_updated_at && existing && existing.updated_at !== options.expected_updated_at) {
+            throw new StoryStoreConflictError(project.project_id, options.expected_updated_at, existing.updated_at);
+        }
+        const meta = project.read_only ? { ...(project.meta ?? {}), read_only: true } : project.meta;
+        const guarded = options?.expected_updated_at !== undefined;
+        const rows = await this.query(`INSERT INTO ${this.table} (project_id, document, meta, created_at, updated_at)
+       VALUES ($1, $2::jsonb, $3::jsonb, $4, now())
+       ON CONFLICT (project_id) DO UPDATE SET
+         document = EXCLUDED.document,
+         meta = EXCLUDED.meta,
+         updated_at = now()
+       ${guarded ? `WHERE ${this.table}.updated_at = $5::timestamptz` : ''}
+       RETURNING project_id, document, meta, created_at, updated_at`, guarded
+            ? [
+                project.project_id,
+                JSON.stringify(project.document),
+                meta ? JSON.stringify(meta) : null,
+                project.created_at,
+                options?.expected_updated_at,
+            ]
+            : [project.project_id, JSON.stringify(project.document), meta ? JSON.stringify(meta) : null, project.created_at]);
+        const row = rows[0];
+        if (!row) {
+            if (guarded) {
+                const current = await this.get(project.project_id);
+                throw new StoryStoreConflictError(project.project_id, options?.expected_updated_at, current?.updated_at ?? 'gone');
+            }
+            throw new Error(`save returned no row for project \`${project.project_id}\``);
+        }
+        return rowToProject(row);
+    }
+    async remove(projectId) {
+        await this.init();
+        const existing = await this.get(projectId);
+        if (existing?.read_only)
+            throw new StoryStoreReadOnlyError(projectId);
+        const rows = await this.query(`DELETE FROM ${this.table} WHERE project_id = $1 RETURNING project_id`, [projectId]);
+        return rows.length > 0;
+    }
+}
+//# sourceMappingURL=neon.js.map

package/dist/store/neon.js.map

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

package/dist/terminology/generated.d.ts

@@ -0,0 +1,3 @@
+import type { TerminologyIndex } from './types.js';
+export declare const TERMINOLOGY: TerminologyIndex;
+//# sourceMappingURL=generated.d.ts.map

package/dist/terminology/generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated.d.ts","sourceRoot":"","sources":["../../src/terminology/generated.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD,eAAO,MAAM,WAAW,EAAE,gBAs2FL,CAAA"}