@selvajs/local-provider 0.11.0

package/dist/data/LocalDataProvider.d.ts

@@ -0,0 +1,47 @@
+import type { IDataProvider, IOrgStore, IProjectStore, IDefinitionStore, IComputeServerStore, IInviteStore, IShareLinkStore, IUserProfileStore, IPlatformPermissionStore, IPlatformProjectGrantStore, IEventSink, RequestContext } from '@selvajs/platform';
+/**
+ * Composition of every local-provider data store. One `LocalOrgStoreLoader`
+ * is shared across org + project stores so they see the same cache and
+ * atomic write path.
+ *
+ * The `LocalUserDataStore` is similarly shared across the permissions and
+ * profile stores: both write to `user-data.json`, and `ensureUser` seeds
+ * exactly the same row both stores read from. This is the local equivalent
+ * of Supabase's `handle_new_auth_user` trigger.
+ *
+ * Stores are passed as a record so adding a new store doesn't ripple through
+ * test fixtures and call sites.
+ */
+export declare class LocalDataProvider implements IDataProvider {
+    readonly orgs: IOrgStore;
+    readonly projects: IProjectStore;
+    readonly definitions: IDefinitionStore;
+    readonly computeServer: IComputeServerStore;
+    readonly invites: IInviteStore;
+    readonly shareLinks: IShareLinkStore;
+    readonly userProfile: IUserProfileStore;
+    readonly permissions: IPlatformPermissionStore;
+    readonly platformProjectGrants: IPlatformProjectGrantStore;
+    private readonly userData;
+    private constructor();
+    /**
+     * Idempotently register a user in the data layer. Called from
+     * `hooks.server.ts` on every authed request — the local equivalent of
+     * Supabase's `handle_new_auth_user` trigger. After this completes the
+     * user has an empty row in `user-data.json` that the permissions and
+     * profile stores can read and update.
+     *
+     * `ctx` is unused — registration runs as a system operation regardless of
+     * the calling user. Argument is kept for interface symmetry with adapters
+     * that need it.
+     */
+    ensureUser(_ctx: RequestContext, userId: string): Promise<void>;
+    /**
+     * Cascade hook called after the auth provider deletes a user. Removes the
+     * matching `user-data.json` row so the data layer doesn't accumulate
+     * orphans. Tolerates missing rows.
+     */
+    onUserDeleted(_ctx: RequestContext, userId: string): Promise<void>;
+    static fromEnv(env: Record<string, string | undefined>, events?: IEventSink): LocalDataProvider;
+}
+//# sourceMappingURL=LocalDataProvider.d.ts.map

package/dist/data/LocalDataProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalDataProvider.d.ts","sourceRoot":"","sources":["../../src/data/LocalDataProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,aAAa,EACb,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,0BAA0B,EAC1B,UAAU,EACV,cAAc,EACd,MAAM,mBAAmB,CAAC;AAc3B;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACtD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;IAC/C,QAAQ,CAAC,qBAAqB,EAAE,0BAA0B,CAAC;IAE3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAE9C,OAAO;IAgBP;;;;;;;;;;OAUG;IACG,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE;;;;OAIG;IACG,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxE,MAAM,CAAC,OAAO,CACb,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,MAAM,GAAE,UAAgC,GACtC,iBAAiB;CA+CpB"}

package/dist/data/LocalDataProvider.js

@@ -0,0 +1,118 @@
+import { NoopEventSink } from '@selvajs/platform';
+import * as path from 'node:path';
+import { LocalOrgStore, LocalOrgStoreLoader } from './LocalOrgStore.js';
+import { LocalProjectStore } from './LocalProjectStore.js';
+import { LocalDefinitionStore } from './LocalDefinitionStore.js';
+import { LocalComputeServerStore } from './LocalComputeServerStore.js';
+import { LocalInviteStore } from './LocalInviteStore.js';
+import { LocalShareLinkStore } from './LocalShareLinkStore.js';
+import { LocalPlatformProjectGrantStore } from './LocalPlatformProjectGrantStore.js';
+import { LocalUserProfileProvider } from '../userProfile/LocalUserProfileProvider.js';
+import { LocalPlatformPermissionStore } from '../permissions/LocalPlatformPermissionStore.js';
+import { createLocalUserDataStore } from './userData.js';
+/**
+ * Composition of every local-provider data store. One `LocalOrgStoreLoader`
+ * is shared across org + project stores so they see the same cache and
+ * atomic write path.
+ *
+ * The `LocalUserDataStore` is similarly shared across the permissions and
+ * profile stores: both write to `user-data.json`, and `ensureUser` seeds
+ * exactly the same row both stores read from. This is the local equivalent
+ * of Supabase's `handle_new_auth_user` trigger.
+ *
+ * Stores are passed as a record so adding a new store doesn't ripple through
+ * test fixtures and call sites.
+ */
+export class LocalDataProvider {
+    orgs;
+    projects;
+    definitions;
+    computeServer;
+    invites;
+    shareLinks;
+    userProfile;
+    permissions;
+    platformProjectGrants;
+    userData;
+    constructor(stores, userData) {
+        this.orgs = stores.orgs;
+        this.projects = stores.projects;
+        this.definitions = stores.definitions;
+        this.computeServer = stores.computeServer;
+        this.invites = stores.invites;
+        this.shareLinks = stores.shareLinks;
+        this.userProfile = stores.userProfile;
+        this.permissions = stores.permissions;
+        this.platformProjectGrants = stores.platformProjectGrants;
+        this.userData = userData;
+    }
+    /**
+     * Idempotently register a user in the data layer. Called from
+     * `hooks.server.ts` on every authed request — the local equivalent of
+     * Supabase's `handle_new_auth_user` trigger. After this completes the
+     * user has an empty row in `user-data.json` that the permissions and
+     * profile stores can read and update.
+     *
+     * `ctx` is unused — registration runs as a system operation regardless of
+     * the calling user. Argument is kept for interface symmetry with adapters
+     * that need it.
+     */
+    async ensureUser(_ctx, userId) {
+        await this.userData.ensure(userId);
+    }
+    /**
+     * Cascade hook called after the auth provider deletes a user. Removes the
+     * matching `user-data.json` row so the data layer doesn't accumulate
+     * orphans. Tolerates missing rows.
+     */
+    async onUserDeleted(_ctx, userId) {
+        try {
+            await this.userData.deleteUser(userId);
+        }
+        catch {
+            // Already absent — nothing to clean up.
+        }
+    }
+    static fromEnv(env, events = new NoopEventSink()) {
+        if (!env.DATA_PATH)
+            throw new Error('Missing required env var: DATA_PATH');
+        const dataPath = env.DATA_PATH;
+        const userDataFilePath = path.join(dataPath, 'user-data.json');
+        const loader = new LocalOrgStoreLoader(dataPath);
+        const platformProjectGrants = LocalPlatformProjectGrantStore.fromEnv(env);
+        const invites = LocalInviteStore.fromEnv(env, events);
+        const computeServer = LocalComputeServerStore.fromEnv(env);
+        const projects = new LocalProjectStore({ loader, grants: platformProjectGrants, events });
+        const definitions = new LocalDefinitionStore(dataPath, undefined, events);
+        const shareLinks = new LocalShareLinkStore({
+            filePath: path.join(dataPath, 'share-links.json'),
+            events
+        });
+        const orgs = new LocalOrgStore({
+            loader,
+            invites,
+            computeServer,
+            grants: platformProjectGrants,
+            events
+        });
+        // Wire cross-store deps that aren't constructor-injected:
+        // - canEditDefinition needs the project store for `listPublic`
+        // - share-link resolution needs the definition store to enforce the §7
+        //   soft-delete cascade (Supabase does the equivalent via JOIN)
+        definitions.setProjectProvider(projects);
+        shareLinks.setDefinitionProvider(definitions);
+        const userData = createLocalUserDataStore(userDataFilePath);
+        return new LocalDataProvider({
+            orgs,
+            projects,
+            definitions,
+            computeServer,
+            invites,
+            shareLinks,
+            userProfile: new LocalUserProfileProvider(userDataFilePath),
+            permissions: new LocalPlatformPermissionStore(userDataFilePath),
+            platformProjectGrants
+        }, userData);
+    }
+}
+//# sourceMappingURL=LocalDataProvider.js.map

package/dist/data/LocalDataProvider.js.map

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

package/dist/data/LocalDefinitionMetaProvider.d.ts

@@ -0,0 +1,22 @@
+import type { IDefinitionStore, DefinitionRecord, DefinitionRecordPatch, HistoryEntry, RequestContext, ListOptions, Page } from '@selva/platform';
+export declare class LocalDefinitionMetaProvider implements IDefinitionStore {
+    private readonly configPath;
+    static fromEnv(env: Record<string, string | undefined>): LocalDefinitionMetaProvider;
+    constructor(definitionsPath: string);
+    private readConfig;
+    private writeConfig;
+    private sortedRecords;
+    /** Apply the default 'ready' filter, respecting ListOptions.includePending. */
+    private visibleRecords;
+    list(_ctx: RequestContext, opts?: ListOptions): Promise<Page<DefinitionRecord>>;
+    listByProject(_ctx: RequestContext, projectId: string, opts?: ListOptions): Promise<Page<DefinitionRecord>>;
+    listPublic(ctx: RequestContext, opts?: ListOptions): Promise<Page<DefinitionRecord>>;
+    get(_ctx: RequestContext, guid: string): Promise<DefinitionRecord | null>;
+    create(_ctx: RequestContext, record: DefinitionRecord): Promise<void>;
+    update(_ctx: RequestContext, guid: string, patch: DefinitionRecordPatch): Promise<void>;
+    addHistoryEntry(_ctx: RequestContext, guid: string, entry: HistoryEntry): Promise<void>;
+    removeHistoryEntry(_ctx: RequestContext, guid: string, ref: string): Promise<void>;
+    delete(_ctx: RequestContext, guid: string): Promise<void>;
+    listStalePending(_ctx: RequestContext, olderThanIso: string): Promise<DefinitionRecord[]>;
+}
+//# sourceMappingURL=LocalDefinitionMetaProvider.d.ts.map

package/dist/data/LocalDefinitionMetaProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalDefinitionMetaProvider.d.ts","sourceRoot":"","sources":["../../src/data/LocalDefinitionMetaProvider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,IAAI,EACJ,MAAM,iBAAiB,CAAC;AAQzB,qBAAa,2BAA4B,YAAW,gBAAgB;IACnE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,2BAA2B;gBAKxE,eAAe,EAAE,MAAM;YAIrB,UAAU;YAgBV,WAAW;IAOzB,OAAO,CAAC,aAAa;IAgBrB,+EAA+E;IAC/E,OAAO,CAAC,cAAc;IAMhB,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAM/E,aAAa,CAClB,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAS5B,UAAU,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAIpF,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAKzE,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrE,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBvF,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvF,kBAAkB,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASlF,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzD,gBAAgB,CACrB,IAAI,EAAE,cAAc,EACpB,YAAY,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAM9B"}

package/dist/data/LocalDefinitionMetaProvider.js

@@ -0,0 +1,131 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { ProviderError } from '@selva/platform';
+import { paginate } from '../pagination.js';
+export class LocalDefinitionMetaProvider {
+    configPath;
+    static fromEnv(env) {
+        if (!env.DATA_PATH)
+            throw new Error('Missing required env var: DATA_PATH');
+        return new LocalDefinitionMetaProvider(env.DATA_PATH);
+    }
+    constructor(definitionsPath) {
+        this.configPath = path.join(definitionsPath, 'definitions-config.json');
+    }
+    async readConfig() {
+        try {
+            const content = await fs.readFile(this.configPath, 'utf-8');
+            const parsed = JSON.parse(content);
+            // Backfill status for records written before Phase 4 landed.
+            // Anything on disk is by definition fully written, so treat as 'ready'.
+            for (const record of Object.values(parsed.definitions)) {
+                if (record && !record.status)
+                    record.status = 'ready';
+            }
+            return parsed;
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return { definitions: {} };
+            throw err;
+        }
+    }
+    async writeConfig(config) {
+        await fs.mkdir(path.dirname(this.configPath), { recursive: true });
+        const tmpPath = `${this.configPath}.tmp`;
+        await fs.writeFile(tmpPath, JSON.stringify(config, null, '\t'), 'utf-8');
+        await fs.rename(tmpPath, this.configPath);
+    }
+    sortedRecords(records, opts) {
+        const field = opts?.orderBy ?? 'name';
+        const dir = opts?.orderDir ?? 'asc';
+        const mul = dir === 'asc' ? 1 : -1;
+        return [...records].sort((a, b) => {
+            if (field === 'name') {
+                return a.meta.displayName.localeCompare(b.meta.displayName) * mul;
+            }
+            const av = a[field] ?? '';
+            const bv = b[field] ?? '';
+            if (av < bv)
+                return -1 * mul;
+            if (av > bv)
+                return 1 * mul;
+            return 0;
+        });
+    }
+    /** Apply the default 'ready' filter, respecting ListOptions.includePending. */
+    visibleRecords(records, opts) {
+        const filtered = records.filter((r) => r?.meta?.displayName);
+        if (opts?.includePending)
+            return filtered;
+        return filtered.filter((r) => r.status === 'ready');
+    }
+    async list(_ctx, opts) {
+        const config = await this.readConfig();
+        const records = this.visibleRecords(Object.values(config.definitions), opts);
+        return paginate(this.sortedRecords(records, opts), opts);
+    }
+    async listByProject(_ctx, projectId, opts) {
+        const config = await this.readConfig();
+        const records = this.visibleRecords(Object.values(config.definitions).filter((r) => r?.projectId === projectId), opts);
+        return paginate(this.sortedRecords(records, opts), opts);
+    }
+    async listPublic(ctx, opts) {
+        return this.list(ctx, opts);
+    }
+    async get(_ctx, guid) {
+        const config = await this.readConfig();
+        return config.definitions[guid] ?? null;
+    }
+    async create(_ctx, record) {
+        const config = await this.readConfig();
+        config.definitions[record.guid] = record;
+        await this.writeConfig(config);
+    }
+    async update(_ctx, guid, patch) {
+        const config = await this.readConfig();
+        const existing = config.definitions[guid];
+        if (!existing)
+            throw new ProviderError(`Definition '${guid}' not found`, 404);
+        config.definitions[guid] = {
+            ...existing,
+            ...(patch.fileExt !== undefined && { fileExt: patch.fileExt }),
+            ...(patch.maxHistory !== undefined && { maxHistory: patch.maxHistory }),
+            ...(patch.projectId !== undefined && { projectId: patch.projectId }),
+            ...(patch.computeServerId !== undefined && {
+                computeServerId: patch.computeServerId ?? undefined
+            }),
+            ...(patch.status !== undefined && { status: patch.status }),
+            meta: patch.meta ? { ...existing.meta, ...patch.meta } : existing.meta,
+            updatedAt: new Date().toISOString()
+        };
+        await this.writeConfig(config);
+    }
+    async addHistoryEntry(_ctx, guid, entry) {
+        const config = await this.readConfig();
+        const existing = config.definitions[guid];
+        if (!existing)
+            throw new ProviderError(`Definition '${guid}' not found`, 404);
+        const history = [entry, ...existing.history];
+        existing.history = existing.maxHistory > 0 ? history.slice(0, existing.maxHistory) : history;
+        await this.writeConfig(config);
+    }
+    async removeHistoryEntry(_ctx, guid, ref) {
+        const config = await this.readConfig();
+        const existing = config.definitions[guid];
+        if (!existing)
+            throw new ProviderError(`Definition '${guid}' not found`, 404);
+        existing.history = existing.history.filter((e) => e.ref !== ref);
+        await this.writeConfig(config);
+    }
+    async delete(_ctx, guid) {
+        const config = await this.readConfig();
+        delete config.definitions[guid];
+        await this.writeConfig(config);
+    }
+    async listStalePending(_ctx, olderThanIso) {
+        const config = await this.readConfig();
+        return Object.values(config.definitions).filter((r) => r?.status === 'pending' && r.createdAt <= olderThanIso);
+    }
+}
+//# sourceMappingURL=LocalDefinitionMetaProvider.js.map

package/dist/data/LocalDefinitionMetaProvider.js.map

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

package/dist/data/LocalDefinitionStore.d.ts

@@ -0,0 +1,33 @@
+import type { IDefinitionStore, IProjectStore, IEventSink, DefinitionRecord, DefinitionRecordPatch, DefinitionVersion, RequestContext, DefinitionListOptions, ListOptions, Page } from '@selvajs/platform';
+export declare class LocalDefinitionStore implements IDefinitionStore {
+    private readonly configPath;
+    private readonly events;
+    private projectProvider?;
+    static fromEnv(env: Record<string, string | undefined>): LocalDefinitionStore;
+    constructor(definitionsPath: string, projectProvider?: IProjectStore, events?: IEventSink);
+    setProjectProvider(projectProvider: IProjectStore): void;
+    private readConfig;
+    private live;
+    private writeConfig;
+    private sortedRecords;
+    private visibleRecords;
+    list(_ctx: RequestContext, opts?: DefinitionListOptions): Promise<Page<DefinitionRecord>>;
+    listByProject(_ctx: RequestContext, projectId: string, opts?: DefinitionListOptions): Promise<Page<DefinitionRecord>>;
+    listPublic(ctx: RequestContext, opts?: DefinitionListOptions & {
+        orgId?: string;
+    }): Promise<Page<DefinitionRecord>>;
+    get(_ctx: RequestContext, guid: string): Promise<DefinitionRecord | null>;
+    create(ctx: RequestContext, record: DefinitionRecord): Promise<void>;
+    update(ctx: RequestContext, guid: string, patch: DefinitionRecordPatch): Promise<void>;
+    delete(ctx: RequestContext, guid: string): Promise<void>;
+    incrementSolveCount(_ctx: RequestContext, guid: string): Promise<void>;
+    createVersion(ctx: RequestContext, version: DefinitionVersion): Promise<void>;
+    listVersions(_ctx: RequestContext, definitionId: string, opts?: ListOptions): Promise<Page<DefinitionVersion>>;
+    getVersion(_ctx: RequestContext, versionId: string): Promise<DefinitionVersion | null>;
+    deleteVersion(ctx: RequestContext, versionId: string): Promise<void>;
+    setLiveVersion(ctx: RequestContext, definitionId: string, versionId: string): Promise<void>;
+    setDraftVersion(ctx: RequestContext, definitionId: string, versionId: string): Promise<void>;
+    attachInitialVersion(ctx: RequestContext, definitionId: string, versionId: string): Promise<void>;
+    private repoint;
+}
+//# sourceMappingURL=LocalDefinitionStore.d.ts.map

package/dist/data/LocalDefinitionStore.d.ts.map

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