@selvajs/local-provider 0.11.0

package/dist/definitions/providers/filesystem-files.js

@@ -0,0 +1,170 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import sharp from 'sharp';
+import { GH_EXTENSIONS, COVER_IMAGE_EXTENSIONS as ALLOWED_IMAGE_EXTENSIONS } from '@selva/platform/definitions';
+export class LocalDefinitionFileProvider {
+    definitionsPath;
+    imageUrlPrefix;
+    constructor(definitionsPath, imageUrlPrefix = '/api/definitions') {
+        this.definitionsPath = definitionsPath;
+        this.imageUrlPrefix = imageUrlPrefix;
+    }
+    guidPath(guid) {
+        return path.join(this.definitionsPath, guid);
+    }
+    oldFilesDir(guid) {
+        return path.join(this.guidPath(guid), 'old_files');
+    }
+    // ── IDefinitionFileProvider ─────────────────────────────────────────────
+    async getFile(guid) {
+        const guidDir = this.guidPath(guid);
+        for (const ext of GH_EXTENSIONS) {
+            const filePath = path.join(guidDir, `definition${ext}`);
+            try {
+                const buffer = await fs.readFile(filePath);
+                return new Uint8Array(buffer);
+            }
+            catch {
+                // try next extension
+            }
+        }
+        return null;
+    }
+    async getPreviewImage(guid) {
+        // Read the coverImage field from the config to find the stored filename
+        const configPath = path.join(this.definitionsPath, 'definitions-config.json');
+        let coverImage;
+        try {
+            const content = await fs.readFile(configPath, 'utf-8');
+            const config = JSON.parse(content);
+            coverImage = config.definitions[guid]?.coverImage;
+        }
+        catch {
+            return null;
+        }
+        if (!coverImage)
+            return null;
+        // Extract filename from the coverImage URL or path
+        const imageFilename = coverImage.split('/').pop();
+        if (!imageFilename)
+            return null;
+        const guidDir = this.guidPath(guid);
+        // Try the stored filename, then fall back to the .webp variant
+        const webpFilename = imageFilename.replace(/\.[^.]+$/, '.webp');
+        const candidates = imageFilename === webpFilename ? [imageFilename] : [imageFilename, webpFilename];
+        for (const candidate of candidates) {
+            try {
+                const buffer = await fs.readFile(path.join(guidDir, candidate));
+                return new Uint8Array(buffer);
+            }
+            catch {
+                // try next candidate
+            }
+        }
+        return null;
+    }
+    async getArchivedFile(guid, ref) {
+        const filePath = path.join(this.oldFilesDir(guid), ref);
+        try {
+            const buffer = await fs.readFile(filePath);
+            return new Uint8Array(buffer);
+        }
+        catch {
+            return null;
+        }
+    }
+    async saveFile(guid, data, ext) {
+        const guidDir = this.guidPath(guid);
+        await fs.mkdir(guidDir, { recursive: true });
+        // Delete any existing GH file with a different extension
+        for (const existingExt of GH_EXTENSIONS) {
+            if (existingExt !== `.${ext}`) {
+                try {
+                    await fs.unlink(path.join(guidDir, `definition${existingExt}`));
+                }
+                catch {
+                    // Non-fatal — file may not exist
+                }
+            }
+        }
+        await fs.writeFile(path.join(guidDir, `definition.${ext}`), Buffer.from(data));
+    }
+    async archiveCurrentFile(guid, originalName) {
+        const guidDir = this.guidPath(guid);
+        let currentFile = null;
+        try {
+            const entries = await fs.readdir(guidDir);
+            for (const entry of entries) {
+                const entryExt = path.extname(entry).toLowerCase();
+                if (entry !== 'old_files' && GH_EXTENSIONS.includes(entryExt)) {
+                    currentFile = entry;
+                    break;
+                }
+            }
+        }
+        catch {
+            return null;
+        }
+        if (!currentFile)
+            return null;
+        const oldDir = this.oldFilesDir(guid);
+        await fs.mkdir(oldDir, { recursive: true });
+        const now = new Date();
+        const timestamp = now.toISOString().replace(/[:.]/g, '-');
+        const backupName = `${timestamp}_${currentFile}`;
+        const data = await fs.readFile(path.join(guidDir, currentFile));
+        await fs.writeFile(path.join(oldDir, backupName), data);
+        await fs.unlink(path.join(guidDir, currentFile));
+        return {
+            ref: backupName,
+            originalName,
+            archivedAt: now.toISOString()
+        };
+    }
+    async deleteArchivedFile(guid, ref) {
+        try {
+            await fs.unlink(path.join(this.oldFilesDir(guid), ref));
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+    /**
+     * Save a preview image compressed to WebP.
+     * Returns the public URL for the stored image (used by callers to update meta.coverImage).
+     * The return type is void per IDefinitionFileProvider — callers read the URL via getImageUrl().
+     */
+    async saveImage(guid, data) {
+        const guidDir = this.guidPath(guid);
+        await fs.mkdir(guidDir, { recursive: true });
+        // Always store as WebP
+        const filename = 'cover.webp';
+        const filePath = path.join(guidDir, filename);
+        const compressed = await sharp(Buffer.from(data))
+            .resize({ width: 1200, withoutEnlargement: true })
+            .webp({ quality: 85 })
+            .toBuffer();
+        await fs.writeFile(filePath, compressed);
+        // Delete any old image files (different name or extension)
+        try {
+            const entries = await fs.readdir(guidDir);
+            for (const entry of entries) {
+                if (entry !== filename &&
+                    ALLOWED_IMAGE_EXTENSIONS.includes(path.extname(entry).toLowerCase())) {
+                    await fs.rm(path.join(guidDir, entry), { force: true });
+                }
+            }
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+    /** Returns the public URL for the stored cover image (always cover.webp). */
+    getCoverImageUrl(guid) {
+        return `${this.imageUrlPrefix}/${guid}/image/cover.webp`;
+    }
+    async deleteFiles(guid) {
+        await fs.rm(this.guidPath(guid), { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=filesystem-files.js.map

package/dist/definitions/providers/filesystem-files.js.map

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

package/dist/definitions/providers/filesystem-meta.d.ts

@@ -0,0 +1,17 @@
+import type { IDefinitionMetaProvider, DefinitionRecord, DefinitionMeta, HistoryEntry } from '@selva/platform/definitions';
+export declare class LocalDefinitionMetaProvider implements IDefinitionMetaProvider {
+    private readonly configPath;
+    constructor(definitionsPath: string);
+    private readConfig;
+    private writeConfig;
+    list(): Promise<DefinitionRecord[]>;
+    listByProject(projectId: string): Promise<DefinitionRecord[]>;
+    listPublic(): Promise<DefinitionRecord[]>;
+    get(guid: string): Promise<DefinitionRecord | null>;
+    create(record: DefinitionRecord): Promise<void>;
+    update(guid: string, patch: Partial<DefinitionMeta>): Promise<void>;
+    addHistoryEntry(guid: string, entry: HistoryEntry): Promise<void>;
+    removeHistoryEntry(guid: string, ref: string): Promise<void>;
+    delete(guid: string): Promise<void>;
+}
+//# sourceMappingURL=filesystem-meta.d.ts.map

package/dist/definitions/providers/filesystem-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-meta.d.ts","sourceRoot":"","sources":["../../../src/definitions/providers/filesystem-meta.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,uBAAuB,EACvB,gBAAgB,EAChB,cAAc,EAEd,YAAY,EACZ,MAAM,6BAA6B,CAAC;AAuFrC,qBAAa,2BAA4B,YAAW,uBAAuB;IAC1E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,eAAe,EAAE,MAAM;YAMrB,UAAU;YAYV,WAAW;IAQnB,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAanC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAK7D,UAAU,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAMzC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAOnD,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB/C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA4CnE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBjE,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKzC"}

package/dist/definitions/providers/filesystem-meta.js

@@ -0,0 +1,216 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+// Normalize admin image URLs to public URLs
+function normalizeCoverImage(url) {
+    if (!url?.startsWith('/admin/api/definitions/'))
+        return url;
+    const match = url.match(/\/admin\/api\/definitions\/(.+?)\/(image\/.+)/);
+    if (match)
+        return `/api/definitions/${match[1]}/${match[2]}`;
+    return url;
+}
+// Map stored history entry (legacy filename/date fields) to platform HistoryEntry (ref/archivedAt)
+function toHistoryEntry(stored) {
+    return {
+        ref: stored.filename,
+        originalName: stored.originalName,
+        archivedAt: stored.date
+    };
+}
+// Map platform HistoryEntry back to stored shape
+function toStoredHistoryEntry(entry) {
+    return {
+        filename: entry.ref,
+        originalName: entry.originalName,
+        date: entry.archivedAt
+    };
+}
+function deriveFileExt(file) {
+    if (file?.endsWith('.ghx'))
+        return 'ghx';
+    return 'gh';
+}
+function toDefinitionRecord(guid, stored) {
+    const history = (stored.history ?? []).map(toHistoryEntry);
+    // Sort newest first
+    history.sort((a, b) => b.archivedAt.localeCompare(a.archivedAt));
+    return {
+        guid,
+        projectId: stored.projectId ?? '',
+        ownerId: stored.ownerId ?? '',
+        computeServerId: stored.computeServerId,
+        fileExt: deriveFileExt(stored.file),
+        meta: {
+            displayName: stored.displayName,
+            description: stored.description,
+            coverImage: normalizeCoverImage(stored.coverImage),
+            category: stored.category,
+            tags: stored.tags,
+            originalFilename: stored.originalFilename
+        },
+        history,
+        maxHistory: stored.maxHistory ?? 0,
+        createdAt: stored.createdAt ?? new Date(0).toISOString(),
+        updatedAt: stored.updatedAt ?? new Date(0).toISOString()
+    };
+}
+export class LocalDefinitionMetaProvider {
+    configPath;
+    constructor(definitionsPath) {
+        this.configPath = path.join(definitionsPath, 'definitions-config.json');
+    }
+    // ── Config helpers ──────────────────────────────────────────────────────
+    async readConfig() {
+        try {
+            const content = await fs.readFile(this.configPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                return { definitions: {} };
+            }
+            throw err;
+        }
+    }
+    async writeConfig(config) {
+        const tmpPath = `${this.configPath}.tmp`;
+        await fs.writeFile(tmpPath, JSON.stringify(config, null, '\t'), 'utf-8');
+        await fs.rename(tmpPath, this.configPath);
+    }
+    // ── IDefinitionMetaProvider ─────────────────────────────────────────────
+    async list() {
+        const config = await this.readConfig();
+        const records = [];
+        for (const [guid, stored] of Object.entries(config.definitions)) {
+            if (!stored.displayName)
+                continue;
+            records.push(toDefinitionRecord(guid, stored));
+        }
+        records.sort((a, b) => a.meta.displayName.localeCompare(b.meta.displayName));
+        return records;
+    }
+    async listByProject(projectId) {
+        const all = await this.list();
+        return all.filter((r) => r.projectId === projectId);
+    }
+    async listPublic() {
+        // Local provider has no project visibility concept — return all records.
+        // A real multi-tenant provider would join against project visibility here.
+        return this.list();
+    }
+    async get(guid) {
+        const config = await this.readConfig();
+        const stored = config.definitions[guid];
+        if (!stored)
+            return null;
+        return toDefinitionRecord(guid, stored);
+    }
+    async create(record) {
+        const config = await this.readConfig();
+        const entry = {
+            displayName: record.meta.displayName,
+            file: `definition.${record.fileExt}`,
+            originalFilename: record.meta.originalFilename,
+            history: [],
+            projectId: record.projectId,
+            ownerId: record.ownerId,
+            createdAt: record.createdAt,
+            updatedAt: record.updatedAt
+        };
+        if (record.computeServerId)
+            entry.computeServerId = record.computeServerId;
+        if (record.meta.description)
+            entry.description = record.meta.description;
+        if (record.meta.category)
+            entry.category = record.meta.category;
+        if (record.meta.tags && record.meta.tags.length > 0)
+            entry.tags = record.meta.tags;
+        if (record.meta.coverImage)
+            entry.coverImage = record.meta.coverImage;
+        if (record.maxHistory > 0)
+            entry.maxHistory = record.maxHistory;
+        config.definitions[record.guid] = entry;
+        await this.writeConfig(config);
+    }
+    async update(guid, patch) {
+        const config = await this.readConfig();
+        const existing = config.definitions[guid];
+        if (!existing)
+            throw new Error(`Definition '${guid}' not found`);
+        const updated = {
+            displayName: patch.displayName ?? existing.displayName,
+            file: existing.file || ''
+        };
+        if (existing.originalFilename)
+            updated.originalFilename = existing.originalFilename;
+        // String fields: patch overrides if provided; preserve existing otherwise
+        if (patch.description !== undefined) {
+            if (patch.description)
+                updated.description = patch.description;
+        }
+        else if (existing.description) {
+            updated.description = existing.description;
+        }
+        if (patch.category !== undefined) {
+            if (patch.category)
+                updated.category = patch.category;
+        }
+        else if (existing.category) {
+            updated.category = existing.category;
+        }
+        if (patch.tags !== undefined) {
+            if (patch.tags && patch.tags.length > 0)
+                updated.tags = patch.tags;
+        }
+        else if (existing.tags) {
+            updated.tags = existing.tags;
+        }
+        if (patch.coverImage !== undefined) {
+            if (patch.coverImage)
+                updated.coverImage = patch.coverImage;
+        }
+        else if (existing.coverImage) {
+            updated.coverImage = existing.coverImage;
+        }
+        if (existing.history !== undefined)
+            updated.history = existing.history;
+        if (existing.maxHistory !== undefined)
+            updated.maxHistory = existing.maxHistory;
+        config.definitions[guid] = updated;
+        await this.writeConfig(config);
+    }
+    async addHistoryEntry(guid, entry) {
+        const config = await this.readConfig();
+        const existing = config.definitions[guid];
+        if (!existing)
+            throw new Error(`Definition '${guid}' not found`);
+        const storedEntry = toStoredHistoryEntry(entry);
+        const history = [storedEntry, ...(existing.history ?? [])];
+        // Prune if maxHistory set — caller is responsible for deleting archived files
+        if (existing.maxHistory && existing.maxHistory > 0) {
+            existing.history = history.slice(0, existing.maxHistory);
+        }
+        else {
+            existing.history = history;
+        }
+        // Update originalFilename to reflect the new file being uploaded
+        // (caller should also update this via update() if needed)
+        config.definitions[guid] = existing;
+        await this.writeConfig(config);
+    }
+    async removeHistoryEntry(guid, ref) {
+        const config = await this.readConfig();
+        const existing = config.definitions[guid];
+        if (!existing)
+            throw new Error(`Definition '${guid}' not found`);
+        existing.history = (existing.history ?? []).filter((e) => e.filename !== ref);
+        config.definitions[guid] = existing;
+        await this.writeConfig(config);
+    }
+    async delete(guid) {
+        const config = await this.readConfig();
+        delete config.definitions[guid];
+        await this.writeConfig(config);
+    }
+}
+//# sourceMappingURL=filesystem-meta.js.map

package/dist/definitions/providers/filesystem-meta.js.map

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

package/dist/fsJson.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Read a JSON file, returning a fallback if the file does not exist.
+ * Any other error propagates.
+ */
+export declare function readJsonFile<T>(filePath: string, fallback: T): Promise<T>;
+/**
+ * Atomically write JSON: ensure the parent directory exists, write to a
+ * sibling .tmp file, then rename into place. Prevents partial writes from
+ * corrupting the target on crash or interrupt.
+ */
+export declare function writeJsonFile<T>(filePath: string, data: T): Promise<void>;
+//# sourceMappingURL=fsJson.d.ts.map

package/dist/fsJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsJson.d.ts","sourceRoot":"","sources":["../src/fsJson.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQ/E;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAK/E"}

package/dist/fsJson.js

@@ -0,0 +1,29 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+/**
+ * Read a JSON file, returning a fallback if the file does not exist.
+ * Any other error propagates.
+ */
+export async function readJsonFile(filePath, fallback) {
+    try {
+        const raw = await fs.readFile(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return fallback;
+        throw err;
+    }
+}
+/**
+ * Atomically write JSON: ensure the parent directory exists, write to a
+ * sibling .tmp file, then rename into place. Prevents partial writes from
+ * corrupting the target on crash or interrupt.
+ */
+export async function writeJsonFile(filePath, data) {
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    const tmp = `${filePath}.tmp`;
+    await fs.writeFile(tmp, JSON.stringify(data, null, '\t'), 'utf-8');
+    await fs.rename(tmp, filePath);
+}
+//# sourceMappingURL=fsJson.js.map

package/dist/fsJson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsJson.js","sourceRoot":"","sources":["../src/fsJson.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,QAAgB,EAAE,QAAW;IAClE,IAAI,CAAC;QACJ,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,QAAQ,CAAC;QACtE,MAAM,GAAG,CAAC;IACX,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAI,QAAgB,EAAE,IAAO;IAC/D,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAG,GAAG,QAAQ,MAAM,CAAC;IAC9B,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IACnE,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAChC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { LocalAuthProvider } from './auth/LocalAuthProvider.js';
+export type { LocalAuthProviderConfig } from './auth/LocalAuthProvider.js';
+export { signHmacToken, verifyHmacToken } from './auth/hmac.js';
+export { hashPassword, verifyPasswordHash, createLocalAuthUserStore } from './auth/users.js';
+export type { StoredAuthUser, AuthUsersFile, LocalAuthUserStore } from './auth/users.js';
+export { LocalDataProvider, LocalOrgStore, LocalOrgStoreLoader, LocalProjectStore, LocalDefinitionStore, LocalInviteStore, LocalComputeServerStore, LocalShareLinkStore, LocalPlatformProjectGrantStore } from './data/index.js';
+export type { LocalOrgStoreData, LocalOrgStoreOptions, LocalProjectStoreOptions, LocalShareLinkStoreOptions, SecretVerificationFailure, SecretVerificationFailureReason, SecretVerificationReport } from './data/index.js';
+export { createLocalUserDataStore } from './data/userData.js';
+export type { LocalUserDataStore, StoredUserData, UserDataFile } from './data/userData.js';
+export { LocalStorageProvider } from './storage/LocalStorageProvider.js';
+export { LocalUserProfileProvider } from './userProfile/LocalUserProfileProvider.js';
+export { LocalPlatformPermissionStore } from './permissions/LocalPlatformPermissionStore.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,YAAY,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC7F,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGzF,OAAO,EACN,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACnB,8BAA8B,EAC9B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACX,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,yBAAyB,EACzB,+BAA+B,EAC/B,wBAAwB,EACxB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAGzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAGrF,OAAO,EAAE,4BAA4B,EAAE,MAAM,+CAA+C,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+// Auth — identity-only (auth-users.json)
+export { LocalAuthProvider } from './auth/LocalAuthProvider.js';
+export { signHmacToken, verifyHmacToken } from './auth/hmac.js';
+export { hashPassword, verifyPasswordHash, createLocalAuthUserStore } from './auth/users.js';
+// Data — class names use the `*Store` suffix to match the Supabase provider.
+export { LocalDataProvider, LocalOrgStore, LocalOrgStoreLoader, LocalProjectStore, LocalDefinitionStore, LocalInviteStore, LocalComputeServerStore, LocalShareLinkStore, LocalPlatformProjectGrantStore } from './data/index.js';
+// Per-user data layer (user-data.json) — keyed by user ID, paired with any
+// auth provider. The permission and profile stores both read/write here.
+export { createLocalUserDataStore } from './data/userData.js';
+// Storage
+export { LocalStorageProvider } from './storage/LocalStorageProvider.js';
+// User profile
+export { LocalUserProfileProvider } from './userProfile/LocalUserProfileProvider.js';
+// Platform permissions (data-layer authorization store)
+export { LocalPlatformPermissionStore } from './permissions/LocalPlatformPermissionStore.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAG7F,6EAA6E;AAC7E,OAAO,EACN,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACnB,8BAA8B,EAC9B,MAAM,iBAAiB,CAAC;AAWzB,2EAA2E;AAC3E,yEAAyE;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,UAAU;AACV,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAEzE,eAAe;AACf,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAErF,wDAAwD;AACxD,OAAO,EAAE,4BAA4B,EAAE,MAAM,+CAA+C,CAAC"}

package/dist/invites/LocalInviteProvider.d.ts

@@ -0,0 +1,24 @@
+import type { IInviteStore, Invite, RequestContext, ListOptions, Page } from '@selva/platform';
+/**
+ * Filesystem-backed invite store (invites.json in DATA_PATH).
+ *
+ * Notes:
+ * - No explicit per-call scoping by ctx.userId — the route layer gates
+ *   admin actions (manage_users + correct org). `getByToken` is the one
+ *   unauthenticated read and is implicitly scoped by the secret token.
+ * - Expired or already-accepted invites are hidden from `getByToken` so
+ *   a reused link returns null and the public route surfaces a clean error.
+ */
+export declare class LocalInviteProvider implements IInviteStore {
+    private readonly filePath;
+    static fromEnv(env: Record<string, string | undefined>): LocalInviteProvider;
+    constructor(dataPath: string);
+    private load;
+    private save;
+    create(_ctx: RequestContext, invite: Invite): Promise<void>;
+    getByToken(_ctx: RequestContext, token: string): Promise<Invite | null>;
+    listByOrg(_ctx: RequestContext, orgId: string, opts?: ListOptions): Promise<Page<Invite>>;
+    markAccepted(_ctx: RequestContext, id: string, userId: string): Promise<void>;
+    revoke(_ctx: RequestContext, id: string): Promise<void>;
+}
+//# sourceMappingURL=LocalInviteProvider.d.ts.map

package/dist/invites/LocalInviteProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalInviteProvider.d.ts","sourceRoot":"","sources":["../../src/invites/LocalInviteProvider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,YAAY,EACZ,MAAM,EACN,cAAc,EACd,WAAW,EACX,IAAI,EACJ,MAAM,iBAAiB,CAAC;AA+BzB;;;;;;;;;GASG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,mBAAmB;gBAKhE,QAAQ,EAAE,MAAM;YAId,IAAI;YAIJ,IAAI;IAIZ,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3D,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASvE,SAAS,CACd,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAMlB,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7E,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAM7D"}

package/dist/invites/LocalInviteProvider.js

@@ -0,0 +1,89 @@
+import * as path from 'node:path';
+import { paginate, applyOrder } from '../pagination.js';
+import { readJsonFile, writeJsonFile } from '../fsJson.js';
+const EMPTY = { invites: [] };
+/**
+ * Pre-§1g invite records carried a flat `permissions` array. Drop any entry
+ * that isn't a valid OrgPermission (including the legacy `platform_admin`,
+ * which is no longer invite-grantable) and store the result under
+ * `orgPermissions`.
+ */
+const VALID_ORG_PERMS = new Set([
+    'manage_users',
+    'manage_compute',
+    'manage_definitions',
+    'manage_projects'
+]);
+function migrateInvite(i) {
+    if (i.orgPermissions === undefined) {
+        const legacy = i.permissions ?? [];
+        i.orgPermissions = legacy.filter((p) => VALID_ORG_PERMS.has(p));
+        delete i.permissions;
+    }
+    return i;
+}
+/**
+ * Filesystem-backed invite store (invites.json in DATA_PATH).
+ *
+ * Notes:
+ * - No explicit per-call scoping by ctx.userId — the route layer gates
+ *   admin actions (manage_users + correct org). `getByToken` is the one
+ *   unauthenticated read and is implicitly scoped by the secret token.
+ * - Expired or already-accepted invites are hidden from `getByToken` so
+ *   a reused link returns null and the public route surfaces a clean error.
+ */
+export class LocalInviteProvider {
+    filePath;
+    static fromEnv(env) {
+        if (!env.DATA_PATH)
+            throw new Error('Missing required env var: DATA_PATH');
+        return new LocalInviteProvider(env.DATA_PATH);
+    }
+    constructor(dataPath) {
+        this.filePath = path.join(dataPath, 'invites.json');
+    }
+    async load() {
+        return readJsonFile(this.filePath, EMPTY);
+    }
+    async save(file) {
+        await writeJsonFile(this.filePath, file);
+    }
+    async create(_ctx, invite) {
+        const file = await this.load();
+        file.invites.push(invite);
+        await this.save(file);
+    }
+    async getByToken(_ctx, token) {
+        const { invites } = await this.load();
+        const invite = invites.find((i) => i.token === token);
+        if (!invite)
+            return null;
+        if (invite.acceptedAt)
+            return null;
+        if (Date.parse(invite.expiresAt) <= Date.now())
+            return null;
+        return migrateInvite(invite);
+    }
+    async listByOrg(_ctx, orgId, opts) {
+        const { invites } = await this.load();
+        const filtered = invites.filter((i) => i.orgId === orgId).map(migrateInvite);
+        return paginate(applyOrder(filtered, opts), opts);
+    }
+    async markAccepted(_ctx, id, userId) {
+        const file = await this.load();
+        const invite = file.invites.find((i) => i.id === id);
+        if (!invite || invite.acceptedAt)
+            return;
+        invite.acceptedAt = new Date().toISOString();
+        invite.acceptedByUserId = userId;
+        await this.save(file);
+    }
+    async revoke(_ctx, id) {
+        const file = await this.load();
+        const before = file.invites.length;
+        file.invites = file.invites.filter((i) => i.id !== id || i.acceptedAt);
+        if (file.invites.length !== before)
+            await this.save(file);
+    }
+}
+//# sourceMappingURL=LocalInviteProvider.js.map