@caretcms/core 0.1.0

package/dist/runtime/schema/template.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Build a default entry template from a JSON Schema.
+ *
+ * Used to seed initial data for new entries in dynamically-created
+ * collections. Pure JSON-Schema → value mapping; no validation library
+ * (schemas reach core as JSON Schema, e.g. via the caller's own
+ * `z.toJSONSchema()`), so core stays Zod-agnostic.
+ */
+import type { CollectionSchema } from "../../types.js";
+/**
+ * Generate a default template from a JSON Schema.
+ * Used to create initial data for new entries in dynamic collections.
+ */
+export declare function generateTemplateFromSchema(jsonSchema: CollectionSchema): Record<string, unknown>;
+//# sourceMappingURL=template.d.ts.map

package/dist/runtime/schema/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../src/runtime/schema/template.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAOvD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsBhG"}

package/dist/runtime/schema/template.js

@@ -0,0 +1,38 @@
+/**
+ * Build a default entry template from a JSON Schema.
+ *
+ * Used to seed initial data for new entries in dynamically-created
+ * collections. Pure JSON-Schema → value mapping; no validation library
+ * (schemas reach core as JSON Schema, e.g. via the caller's own
+ * `z.toJSONSchema()`), so core stays Zod-agnostic.
+ */
+/**
+ * Generate a default template from a JSON Schema.
+ * Used to create initial data for new entries in dynamic collections.
+ */
+export function generateTemplateFromSchema(jsonSchema) {
+    const template = {};
+    for (const [key, prop] of Object.entries(jsonSchema.properties)) {
+        const p = prop;
+        if (p.default !== undefined) {
+            template[key] = p.default;
+        }
+        else if (p.type === "string") {
+            template[key] = "";
+        }
+        else if (p.type === "number" || p.type === "integer") {
+            template[key] = 0;
+        }
+        else if (p.type === "boolean") {
+            template[key] = false;
+        }
+        else if (p.type === "array") {
+            template[key] = [];
+        }
+        else if (p.type === "object") {
+            template[key] = {};
+        }
+    }
+    return template;
+}
+//# sourceMappingURL=template.js.map

package/dist/runtime/schema/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../src/runtime/schema/template.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,UAA4B;IACrE,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAE7C,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAChE,MAAM,CAAC,GAAG,IAA0B,CAAC;QAErC,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC5B,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;QAC5B,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC/B,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACrB,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACvD,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAChC,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACxB,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC9B,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACrB,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC/B,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/runtime/schema-registry.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Schema registry for explicit Zod-derived JSON Schemas.
+ *
+ * When the user passes `schemas` in caret() options, the integration
+ * serializes them and injects them into a virtual module. The schema API
+ * route reads from this registry and falls back to inference only when
+ * no explicit schema is registered for a collection.
+ */
+import type { JsonSchemaNode } from "../schema-utils.js";
+type CollectionSchemaEntry = {
+    schema: JsonSchemaNode;
+    template: Record<string, unknown> | null;
+};
+export declare function registerCollectionSchema(collection: string, jsonSchema: JsonSchemaNode, template: Record<string, unknown> | null): void;
+export declare function getRegisteredSchema(collection: string): CollectionSchemaEntry | null;
+export {};
+//# sourceMappingURL=schema-registry.d.ts.map

package/dist/runtime/schema-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-registry.d.ts","sourceRoot":"","sources":["../../src/runtime/schema-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,KAAK,qBAAqB,GAAG;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1C,CAAC;AAIF,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,cAAc,EAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACvC,IAAI,CAEN;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,GACjB,qBAAqB,GAAG,IAAI,CAE9B"}

package/dist/runtime/schema-registry.js

@@ -0,0 +1,16 @@
+/**
+ * Schema registry for explicit Zod-derived JSON Schemas.
+ *
+ * When the user passes `schemas` in caret() options, the integration
+ * serializes them and injects them into a virtual module. The schema API
+ * route reads from this registry and falls back to inference only when
+ * no explicit schema is registered for a collection.
+ */
+const registry = new Map();
+export function registerCollectionSchema(collection, jsonSchema, template) {
+    registry.set(collection, { schema: jsonSchema, template });
+}
+export function getRegisteredSchema(collection) {
+    return registry.get(collection) ?? null;
+}
+//# sourceMappingURL=schema-registry.js.map

package/dist/runtime/schema-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-registry.js","sourceRoot":"","sources":["../../src/runtime/schema-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAiC,CAAC;AAE1D,MAAM,UAAU,wBAAwB,CACtC,UAAkB,EAClB,UAA0B,EAC1B,QAAwC;IAExC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,UAAkB;IAElB,OAAO,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;AAC1C,CAAC"}

package/dist/runtime/storage/filesystem-adapter.d.ts

@@ -0,0 +1,36 @@
+import type { CollectionMetadata, EntryData, HistoryEntry, StorageAdapter } from "../../types.js";
+export declare class FilesystemAdapter implements StorageAdapter {
+    private readonly dataRoot;
+    private readonly metaRoot;
+    constructor(options?: {
+        dataRoot?: string;
+        metaRoot?: string;
+    });
+    private collectionDir;
+    private revisionStorePath;
+    private revisionMapKey;
+    private historyFilePath;
+    private discoverFromDir;
+    discoverCollections(): Promise<string[]>;
+    isKnownCollection(collection: string): Promise<boolean>;
+    getEntry(collection: string, id: string): Promise<EntryData | null>;
+    listEntryIds(collection: string): Promise<string[]>;
+    listEntries(collection: string): Promise<EntryData[]>;
+    writeEntry(collection: string, id: string, data: Record<string, unknown>): Promise<void>;
+    deleteEntry(collection: string, id: string): Promise<void>;
+    private readRevisionMap;
+    private writeRevisionMap;
+    getRevision(collection: string, id: string): Promise<number>;
+    bumpRevision(collection: string, id: string): Promise<number>;
+    private readHistoryFile;
+    private writeHistoryFile;
+    getHistory(collection: string, id: string): Promise<HistoryEntry[]>;
+    appendHistory(collection: string, id: string, entry: HistoryEntry): Promise<void>;
+    private collectionsMetaDir;
+    private collectionMetaPath;
+    createCollection(metadata: CollectionMetadata): Promise<void>;
+    deleteCollection(collection: string): Promise<void>;
+    getCollectionMetadata(collection: string): Promise<CollectionMetadata | null>;
+    listCollectionMetadata(): Promise<CollectionMetadata[]>;
+}
+//# sourceMappingURL=filesystem-adapter.d.ts.map

package/dist/runtime/storage/filesystem-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-adapter.d.ts","sourceRoot":"","sources":["../../../src/runtime/storage/filesystem-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAiFlG,qBAAa,iBAAkB,YAAW,cAAc;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;IAM9D,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,eAAe;YAMT,eAAe;IAWvB,mBAAmB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IASxC,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQvD,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAanE,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAYnD,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAMrD,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxF,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAalD,eAAe;YAmBf,gBAAgB;IAMxB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM5D,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAcrD,eAAe;YAYf,gBAAgB;IAUxB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAInE,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvF,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,kBAAkB;IAIpB,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7D,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAenD,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAY7E,sBAAsB,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;CAiB9D"}

package/dist/runtime/storage/filesystem-adapter.js

@@ -0,0 +1,291 @@
+import { mkdir, readFile, readdir, rm, unlink, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+const COLLECTION_NAME_RE = /^[a-z][a-z0-9_-]*$/;
+const HISTORY_LIMIT = 50;
+/** workerd (incl. Astro 6's dev server) sets navigator.userAgent to this. */
+const WORKERD_USER_AGENT = "Cloudflare-Workers";
+/**
+ * Return a human-readable runtime name if filesystem storage cannot work here,
+ * or null when a real Node filesystem is available.
+ *
+ * Astro 6's dev server runs on the same workerd runtime as production, so a
+ * Workers-targeted project has no filesystem in dev *or* prod — the failure
+ * would otherwise surface as silently-empty reads and cryptic write errors.
+ */
+function detectUnsupportedRuntime() {
+    const g = globalThis;
+    // navigator.userAgent === "Cloudflare-Workers" only when the `global_navigator`
+    // compat flag is on, so also check WebSocketPair — a workerd global present
+    // regardless of compat flags — to detect Workers even on an old compat date.
+    if (g.navigator?.userAgent === WORKERD_USER_AGENT || typeof g.WebSocketPair === "function") {
+        return "Cloudflare Workers (workerd)";
+    }
+    if (typeof process === "undefined" || typeof process.cwd !== "function") {
+        return "a non-Node runtime";
+    }
+    return null;
+}
+function assertFilesystemRuntime() {
+    const runtime = detectUnsupportedRuntime();
+    if (!runtime)
+        return;
+    throw new Error(`[caretcms] Filesystem storage is not available on ${runtime}.\n` +
+        `Astro 6's dev server also runs on workerd, so this fails in dev as well as production.\n\n` +
+        `Targeting Cloudflare Workers? Use the KV adapter from @caretcms/cloudflare in BOTH dev and prod:\n\n` +
+        `  import { cloudflareStorage } from '@caretcms/cloudflare';\n` +
+        `  // caret({ storage: cloudflareStorage(), ... })\n\n` +
+        `Targeting a Node host? Filesystem storage works there — make sure you are not building for an edge runtime.`);
+}
+function asObjectRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    return value;
+}
+function isHistoryEntry(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const obj = value;
+    return (typeof obj.ts === "number" &&
+        Number.isFinite(obj.ts) &&
+        typeof obj.action === "string" &&
+        "data" in obj);
+}
+function isValidRevision(value) {
+    return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
+const revisionWriteChains = new Map();
+function serializeRevisionWrite(filePath, task) {
+    const previous = revisionWriteChains.get(filePath) ?? Promise.resolve();
+    const next = previous.then(task, task);
+    revisionWriteChains.set(filePath, next.finally(() => {
+        if (revisionWriteChains.get(filePath) === next) {
+            revisionWriteChains.delete(filePath);
+        }
+    }));
+    return next;
+}
+export class FilesystemAdapter {
+    dataRoot;
+    metaRoot;
+    constructor(options) {
+        assertFilesystemRuntime();
+        this.dataRoot = options?.dataRoot ?? join(process.cwd(), ".caret", "data");
+        this.metaRoot = options?.metaRoot ?? join(process.cwd(), ".caretcms");
+    }
+    collectionDir(collection) {
+        return join(this.dataRoot, collection);
+    }
+    revisionStorePath() {
+        return join(this.metaRoot, "revisions.json");
+    }
+    revisionMapKey(collection, id) {
+        return `${collection}::${id}`;
+    }
+    historyFilePath(collection, id) {
+        return join(this.metaRoot, "history", collection, `${id}.json`);
+    }
+    // --- Collections ---
+    async discoverFromDir(dir) {
+        try {
+            const entries = await readdir(dir, { withFileTypes: true });
+            return entries
+                .filter((e) => e.isDirectory() && COLLECTION_NAME_RE.test(e.name))
+                .map((e) => e.name);
+        }
+        catch {
+            return [];
+        }
+    }
+    async discoverCollections() {
+        const [fromData, fromMeta] = await Promise.all([
+            this.discoverFromDir(this.dataRoot),
+            this.discoverFromDir(join(this.metaRoot, "history")),
+        ]);
+        const merged = new Set([...fromData, ...fromMeta]);
+        return [...merged].sort((a, b) => a.localeCompare(b));
+    }
+    async isKnownCollection(collection) {
+        if (!COLLECTION_NAME_RE.test(collection))
+            return false;
+        const collections = await this.discoverCollections();
+        return collections.includes(collection);
+    }
+    // --- Entries ---
+    async getEntry(collection, id) {
+        const filePath = join(this.collectionDir(collection), `${id}.json`);
+        try {
+            const raw = await readFile(filePath, "utf8");
+            const parsed = JSON.parse(raw);
+            const data = asObjectRecord(parsed);
+            if (!data)
+                return null;
+            return { id, data };
+        }
+        catch {
+            return null;
+        }
+    }
+    async listEntryIds(collection) {
+        try {
+            const files = await readdir(this.collectionDir(collection), { withFileTypes: true });
+            return files
+                .filter((item) => item.isFile() && item.name.endsWith(".json"))
+                .map((item) => item.name.slice(0, -".json".length))
+                .sort((a, b) => a.localeCompare(b));
+        }
+        catch {
+            return [];
+        }
+    }
+    async listEntries(collection) {
+        const ids = await this.listEntryIds(collection);
+        const entries = await Promise.all(ids.map((id) => this.getEntry(collection, id)));
+        return entries.filter((entry) => Boolean(entry));
+    }
+    async writeEntry(collection, id, data) {
+        const dir = this.collectionDir(collection);
+        await mkdir(dir, { recursive: true });
+        const filePath = join(dir, `${id}.json`);
+        await writeFile(filePath, `${JSON.stringify(data, null, 2)}\n`, "utf8");
+    }
+    async deleteEntry(collection, id) {
+        const filePath = join(this.collectionDir(collection), `${id}.json`);
+        try {
+            await unlink(filePath);
+        }
+        catch (error) {
+            const maybeErr = error;
+            if (maybeErr?.code === "ENOENT")
+                return;
+            throw error;
+        }
+    }
+    // --- Revisions ---
+    async readRevisionMap() {
+        const filePath = this.revisionStorePath();
+        try {
+            const raw = await readFile(filePath, "utf8");
+            const parsed = JSON.parse(raw);
+            if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+                return {};
+            const map = parsed;
+            const out = {};
+            Object.entries(map).forEach(([key, value]) => {
+                if (isValidRevision(value)) {
+                    out[key] = value;
+                }
+            });
+            return out;
+        }
+        catch {
+            return {};
+        }
+    }
+    async writeRevisionMap(map) {
+        const filePath = this.revisionStorePath();
+        await mkdir(this.metaRoot, { recursive: true });
+        await writeFile(filePath, `${JSON.stringify(map, null, 2)}\n`, "utf8");
+    }
+    async getRevision(collection, id) {
+        const map = await this.readRevisionMap();
+        const value = map[this.revisionMapKey(collection, id)];
+        return isValidRevision(value) ? value : 0;
+    }
+    async bumpRevision(collection, id) {
+        return serializeRevisionWrite(this.revisionStorePath(), async () => {
+            const map = await this.readRevisionMap();
+            const key = this.revisionMapKey(collection, id);
+            const current = isValidRevision(map[key]) ? map[key] : 0;
+            const next = current + 1;
+            map[key] = next;
+            await this.writeRevisionMap(map);
+            return next;
+        });
+    }
+    // --- History ---
+    async readHistoryFile(collection, id) {
+        const filePath = this.historyFilePath(collection, id);
+        try {
+            const raw = await readFile(filePath, "utf8");
+            const parsed = JSON.parse(raw);
+            if (!Array.isArray(parsed))
+                return [];
+            return parsed.filter(isHistoryEntry);
+        }
+        catch {
+            return [];
+        }
+    }
+    async writeHistoryFile(collection, id, entries) {
+        const filePath = this.historyFilePath(collection, id);
+        await mkdir(join(this.metaRoot, "history", collection), { recursive: true });
+        await writeFile(filePath, `${JSON.stringify(entries, null, 2)}\n`, "utf8");
+    }
+    async getHistory(collection, id) {
+        return this.readHistoryFile(collection, id);
+    }
+    async appendHistory(collection, id, entry) {
+        const current = await this.readHistoryFile(collection, id);
+        const next = [entry, ...current].slice(0, HISTORY_LIMIT);
+        await this.writeHistoryFile(collection, id, next);
+    }
+    // --- Collection Management ---
+    collectionsMetaDir() {
+        return join(this.metaRoot, "collections");
+    }
+    collectionMetaPath(collection) {
+        return join(this.collectionsMetaDir(), `${collection}.json`);
+    }
+    async createCollection(metadata) {
+        const dir = this.collectionsMetaDir();
+        await mkdir(dir, { recursive: true });
+        const filePath = this.collectionMetaPath(metadata.id);
+        await writeFile(filePath, `${JSON.stringify(metadata, null, 2)}\n`, "utf8");
+        // Create empty collection directory
+        const collectionDir = this.collectionDir(metadata.id);
+        await mkdir(collectionDir, { recursive: true });
+    }
+    async deleteCollection(collection) {
+        // unlink has no `force` option, so guard the metadata file against ENOENT.
+        const metaPath = this.collectionMetaPath(collection);
+        try {
+            await unlink(metaPath);
+        }
+        catch (error) {
+            const maybeErr = error;
+            if (maybeErr?.code !== "ENOENT")
+                throw error;
+        }
+        // rm({ force: true }) is a no-op on missing paths and still throws real errors.
+        await rm(this.collectionDir(collection), { recursive: true, force: true });
+        await rm(join(this.metaRoot, "history", collection), { recursive: true, force: true });
+    }
+    async getCollectionMetadata(collection) {
+        const filePath = this.collectionMetaPath(collection);
+        try {
+            const raw = await readFile(filePath, "utf8");
+            const parsed = JSON.parse(raw);
+            if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+                return null;
+            return parsed;
+        }
+        catch {
+            return null;
+        }
+    }
+    async listCollectionMetadata() {
+        const dir = this.collectionsMetaDir();
+        try {
+            const files = await readdir(dir, { withFileTypes: true });
+            const metadataFiles = files
+                .filter((item) => item.isFile() && item.name.endsWith(".json"))
+                .map((item) => item.name.slice(0, -".json".length));
+            const metadata = await Promise.all(metadataFiles.map((name) => this.getCollectionMetadata(name)));
+            return metadata.filter((m) => Boolean(m));
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=filesystem-adapter.js.map

package/dist/runtime/storage/filesystem-adapter.js.map

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

package/dist/runtime/storage/filesystem-upload-handler.d.ts

@@ -0,0 +1,11 @@
+import type { UploadHandler } from "../../types.js";
+export declare class FilesystemUploadHandler implements UploadHandler {
+    private readonly uploadsDir;
+    constructor(options?: {
+        uploadsDir?: string;
+    });
+    upload(file: File): Promise<{
+        url: string;
+    }>;
+}
+//# sourceMappingURL=filesystem-upload-handler.d.ts.map

package/dist/runtime/storage/filesystem-upload-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-upload-handler.d.ts","sourceRoot":"","sources":["../../../src/runtime/storage/filesystem-upload-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAOpD,qBAAa,uBAAwB,YAAW,aAAa;IAC3D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAIvC,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAanD"}

package/dist/runtime/storage/filesystem-upload-handler.js

@@ -0,0 +1,20 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { IMAGE_KIND_TO_EXT, readAndValidateImage, sanitizeImageBaseName, } from "./image-validation.js";
+export class FilesystemUploadHandler {
+    uploadsDir;
+    constructor(options) {
+        this.uploadsDir = options?.uploadsDir ?? join(process.cwd(), "public", "uploads");
+    }
+    async upload(file) {
+        const { kind, bytes } = await readAndValidateImage(file);
+        const timestamp = Date.now().toString(36);
+        const stem = sanitizeImageBaseName(file.name) || `upload-${timestamp}`;
+        const ext = IMAGE_KIND_TO_EXT[kind];
+        const filename = `${timestamp}-${stem}.${ext}`;
+        await mkdir(this.uploadsDir, { recursive: true });
+        await writeFile(join(this.uploadsDir, filename), bytes);
+        return { url: `/uploads/${filename}` };
+    }
+}
+//# sourceMappingURL=filesystem-upload-handler.js.map

package/dist/runtime/storage/filesystem-upload-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-upload-handler.js","sourceRoot":"","sources":["../../../src/runtime/storage/filesystem-upload-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,OAAO,uBAAuB;IACjB,UAAU,CAAS;IAEpC,YAAY,OAAiC;QAC3C,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACpF,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAU;QACrB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAEzD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,UAAU,SAAS,EAAE,CAAC;QACvE,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,GAAG,SAAS,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;QAE/C,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC;QAExD,OAAO,EAAE,GAAG,EAAE,YAAY,QAAQ,EAAE,EAAE,CAAC;IACzC,CAAC;CACF"}

package/dist/runtime/storage/image-validation.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared image-upload validation primitives. Used by both the filesystem
+ * upload handler and adapter implementations (Cloudflare R2, etc.) so every
+ * handler treats the browser-supplied `file.type` as a hint and the bytes on
+ * disk as authoritative.
+ */
+export type AllowedImageKind = "jpeg" | "png" | "webp" | "avif";
+export declare const IMAGE_MIME_TO_KIND: Record<string, AllowedImageKind>;
+export declare const IMAGE_KIND_TO_EXT: Record<AllowedImageKind, string>;
+export declare const IMAGE_MAX_SIZE: number;
+export declare function detectImageKind(bytes: Uint8Array): AllowedImageKind | null;
+/**
+ * Strip the client-supplied extension entirely; callers re-derive it from the
+ * verified magic bytes. Blocks `evil.html` / `evil.svg` filenames from
+ * landing in storage even when their byte contents happen to match a
+ * permitted image format.
+ */
+export declare function sanitizeImageBaseName(name: string): string;
+/**
+ * Common validation pipeline: enforces size cap, declared MIME allowlist,
+ * magic-byte match against the declared type, and returns the kind + buffered
+ * bytes so the caller can stream them to the destination once.
+ */
+export declare function readAndValidateImage(file: File): Promise<{
+    kind: AllowedImageKind;
+    bytes: Uint8Array;
+}>;
+//# sourceMappingURL=image-validation.d.ts.map

package/dist/runtime/storage/image-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-validation.d.ts","sourceRoot":"","sources":["../../../src/runtime/storage/image-validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhE,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAK/D,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAK9D,CAAC;AAEF,eAAO,MAAM,cAAc,QAAmB,CAAC;AAE/C,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,GAAG,IAAI,CA6C1E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ1D;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;IAC9D,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,UAAU,CAAC;CACnB,CAAC,CAkBD"}

package/dist/runtime/storage/image-validation.js

@@ -0,0 +1,94 @@
+/**
+ * Shared image-upload validation primitives. Used by both the filesystem
+ * upload handler and adapter implementations (Cloudflare R2, etc.) so every
+ * handler treats the browser-supplied `file.type` as a hint and the bytes on
+ * disk as authoritative.
+ */
+export const IMAGE_MIME_TO_KIND = {
+    "image/jpeg": "jpeg",
+    "image/png": "png",
+    "image/webp": "webp",
+    "image/avif": "avif",
+};
+export const IMAGE_KIND_TO_EXT = {
+    jpeg: "jpg",
+    png: "png",
+    webp: "webp",
+    avif: "avif",
+};
+export const IMAGE_MAX_SIZE = 10 * 1024 * 1024;
+export function detectImageKind(bytes) {
+    if (bytes.length < 12)
+        return null;
+    if (bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff)
+        return "jpeg";
+    if (bytes[0] === 0x89 &&
+        bytes[1] === 0x50 &&
+        bytes[2] === 0x4e &&
+        bytes[3] === 0x47 &&
+        bytes[4] === 0x0d &&
+        bytes[5] === 0x0a &&
+        bytes[6] === 0x1a &&
+        bytes[7] === 0x0a) {
+        return "png";
+    }
+    if (bytes[0] === 0x52 &&
+        bytes[1] === 0x49 &&
+        bytes[2] === 0x46 &&
+        bytes[3] === 0x46 &&
+        bytes[8] === 0x57 &&
+        bytes[9] === 0x45 &&
+        bytes[10] === 0x42 &&
+        bytes[11] === 0x50) {
+        return "webp";
+    }
+    if (bytes[4] === 0x66 &&
+        bytes[5] === 0x74 &&
+        bytes[6] === 0x79 &&
+        bytes[7] === 0x70 &&
+        bytes[8] === 0x61 &&
+        bytes[9] === 0x76 &&
+        bytes[10] === 0x69 &&
+        (bytes[11] === 0x66 || bytes[11] === 0x73)) {
+        return "avif";
+    }
+    return null;
+}
+/**
+ * Strip the client-supplied extension entirely; callers re-derive it from the
+ * verified magic bytes. Blocks `evil.html` / `evil.svg` filenames from
+ * landing in storage even when their byte contents happen to match a
+ * permitted image format.
+ */
+export function sanitizeImageBaseName(name) {
+    const dot = name.lastIndexOf(".");
+    const stem = dot > 0 ? name.slice(0, dot) : name;
+    return stem
+        .replace(/[^a-zA-Z0-9_-]/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 80);
+}
+/**
+ * Common validation pipeline: enforces size cap, declared MIME allowlist,
+ * magic-byte match against the declared type, and returns the kind + buffered
+ * bytes so the caller can stream them to the destination once.
+ */
+export async function readAndValidateImage(file) {
+    if (!IMAGE_MIME_TO_KIND[file.type]) {
+        throw new Error("File type not allowed");
+    }
+    if (file.size > IMAGE_MAX_SIZE) {
+        throw new Error("File too large (max 10MB)");
+    }
+    const bytes = new Uint8Array(await file.arrayBuffer());
+    const detected = detectImageKind(bytes);
+    if (!detected) {
+        throw new Error("File contents do not match a supported image format");
+    }
+    if (detected !== IMAGE_MIME_TO_KIND[file.type]) {
+        throw new Error("File contents do not match the declared MIME type");
+    }
+    return { kind: detected, bytes };
+}
+//# sourceMappingURL=image-validation.js.map

package/dist/runtime/storage/image-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-validation.js","sourceRoot":"","sources":["../../../src/runtime/storage/image-validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAAqC;IAClE,YAAY,EAAE,MAAM;IACpB,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,MAAM;IACpB,YAAY,EAAE,MAAM;CACrB,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAqC;IACjE,IAAI,EAAE,KAAK;IACX,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAE/C,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC/C,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,IAAI,CAAC;IAEnC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAE/E,IACE,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EACjB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IACE,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI;QAClB,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,EAClB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IACE,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI;QAClB,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,EAC1C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjD,OAAO,IAAI;SACR,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC;SAC/B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAU;IAInD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,GAAG,cAAc,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,QAAQ,KAAK,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC"}