@farm.js/content 0.1.0-beta.0 → 0.1.0-beta.2

package/dist/config.d.ts

@@ -1,4 +1,4 @@
-import type { ContentAssetsInput, ContentCollection, ContentCollectionInput, ContentDataWithAssets, ContentFileSource, ContentSchema, InferContentSchema } from "./types.js";
+import type { ContentAssetsInput, ContentCollection, ContentCollectionInput, ContentDataWithAssets, ContentFileSource, ContentRemoteDocument, ContentRemoteSource, ContentSchema, InferContentSchema } from "./types.js";
 export interface ContentFilesOptions {
     /** Ignore globs, evaluated relative to the Farm project root. */
     ignore?: string | readonly string[];
@@ -6,6 +6,18 @@ export interface ContentFilesOptions {
     base?: string;
 }
 export declare function files(patterns: string | readonly string[], options?: ContentFilesOptions): ContentFileSource;
+export interface ContentRemoteOptions {
+    /** Names the source in error messages, e.g. "sanity:posts". */
+    name: string;
+    fetch(): Promise<readonly ContentRemoteDocument[]>;
+    /** Development re-fetch cadence in milliseconds. */
+    refreshInterval?: number;
+    create?: ContentRemoteSource["create"];
+    update?: ContentRemoteSource["update"];
+    delete?: ContentRemoteSource["delete"];
+}
+/** A content source that fetches documents instead of reading local files. */
+export declare function remote(options: ContentRemoteOptions): ContentRemoteSource;
 export declare function collection<TSchema extends ContentSchema<any>, const TAssets extends ContentAssetsInput = undefined, TTransformed = ContentDataWithAssets<InferContentSchema<TSchema>, TAssets>>(input: ContentCollectionInput<TSchema, TTransformed, TAssets>): ContentCollection<TTransformed, InferContentSchema<TSchema>>;
 export declare function isSupportedContentFile(filePath: string): boolean;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACpC,gGAAgG;IAChG,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,KAAK,CACnB,QAAQ,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EACpC,OAAO,GAAE,mBAAwB,GAChC,iBAAiB,CAWnB;AAED,wBAAgB,UAAU,CACxB,OAAO,SAAS,aAAa,CAAC,GAAG,CAAC,EAClC,KAAK,CAAC,OAAO,SAAS,kBAAkB,GAAG,SAAS,EACpD,YAAY,GAAG,qBAAqB,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,EAE1E,KAAK,EAAE,sBAAsB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,GAC5D,iBAAiB,CAAC,YAAY,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAgC9D;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEhE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACpC,gGAAgG;IAChG,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,KAAK,CACnB,QAAQ,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EACpC,OAAO,GAAE,mBAAwB,GAChC,iBAAiB,CAWnB;AAED,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,OAAO,CAAC,SAAS,qBAAqB,EAAE,CAAC,CAAC;IACnD,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;CACxC;AAED,8EAA8E;AAC9E,wBAAgB,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CAmCzE;AAED,wBAAgB,UAAU,CACxB,OAAO,SAAS,aAAa,CAAC,GAAG,CAAC,EAClC,KAAK,CAAC,OAAO,SAAS,kBAAkB,GAAG,SAAS,EACpD,YAAY,GAAG,qBAAqB,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,EAE1E,KAAK,EAAE,sBAAsB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,GAC5D,iBAAiB,CAAC,YAAY,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAuC9D;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEhE"}

package/dist/config.js

@@ -12,12 +12,48 @@ export function files(patterns, options = {}) {
         ...(base ? { base } : {}),
     });
 }
+/** A content source that fetches documents instead of reading local files. */
+export function remote(options) {
+    if (!options || typeof options !== "object") {
+        throw new TypeError("remote() requires an options object");
+    }
+    const name = typeof options.name === "string" ? options.name.trim() : "";
+    if (!name) {
+        throw new TypeError("remote() requires a non-empty name for error messages");
+    }
+    if (typeof options.fetch !== "function") {
+        throw new TypeError(`remote(${JSON.stringify(name)}) requires a fetch() function`);
+    }
+    if (options.refreshInterval !== undefined &&
+        (!Number.isFinite(options.refreshInterval) || options.refreshInterval < 100)) {
+        throw new TypeError(`remote(${JSON.stringify(name)}) refreshInterval must be at least 100 milliseconds`);
+    }
+    for (const verb of ["create", "update", "delete"]) {
+        if (options[verb] !== undefined && typeof options[verb] !== "function") {
+            throw new TypeError(`remote(${JSON.stringify(name)}) ${verb} must be a function`);
+        }
+    }
+    return Object.freeze({
+        kind: "remote",
+        name,
+        fetch: options.fetch,
+        ...(options.refreshInterval !== undefined ? { refreshInterval: options.refreshInterval } : {}),
+        ...(options.create ? { create: options.create } : {}),
+        ...(options.update ? { update: options.update } : {}),
+        ...(options.delete ? { delete: options.delete } : {}),
+    });
+}
 export function collection(input) {
     if (!input || typeof input !== "object") {
         throw new TypeError("Content collection must be an object");
     }
-    if (input.source?.kind !== "files") {
-        throw new TypeError("Content collection source must come from files()");
+    if (input.source?.kind !== "files" && input.source?.kind !== "remote") {
+        throw new TypeError("Content collection source must come from files() or remote()");
+    }
+    if (input.source.kind === "remote" && input.assets && input.assets !== true) {
+        // Typed asset fields resolve files next to the entry on disk; a remote
+        // document has no directory for them to live in.
+        throw new TypeError(`Content collection with remote source ${JSON.stringify(input.source.name)} cannot declare asset fields`);
     }
     if (!isContentSchema(input.schema)) {
         throw new TypeError("Content collection schema must implement Standard Schema, parseAsync, or parse");

package/dist/index.d.ts

@@ -2,8 +2,10 @@ import { asset } from "./assets.js";
 import { collection, files } from "./config.js";
 import type { ContentCollections, ContentOptions, ContentPlugin } from "./types.js";
 export { asset, collection, files };
+export { remote } from "./config.js";
+export type { ContentRemoteOptions } from "./config.js";
 export type { ContentFilesOptions } from "./config.js";
-export type { AppContentEntry, AppContentRegistry, ContentAssetField, ContentAssetFields, ContentAssetsInput, ContentAssetValue, ContentCollection, ContentCollectionInput, ContentCollectionName, ContentCollections, ContentEntry, ContentFileAsset, ContentFileSource, ContentImageAsset, ContentOptions, ContentPlugin, ContentSchema, ContentTransformContext, InferContentCollectionEntry, InferContentAssetFields, InferContentRegistry, InferContentSchema, } from "./types.js";
+export type { AppContentEntry, AppContentRegistry, ContentAssetField, ContentAssetFields, ContentAssetsInput, ContentAssetValue, ContentCollection, ContentCollectionInput, ContentCollectionName, ContentCollections, ContentEntry, ContentFileAsset, ContentFileSource, ContentRemoteDocument, ContentRemoteSource, ContentSource, ContentImageAsset, ContentOptions, ContentPlugin, ContentSchema, ContentTransformContext, InferContentCollectionEntry, InferContentAssetFields, InferContentRegistry, InferContentSchema, } from "./types.js";
 /** Load schema-validated local content as a typed server-only collection registry. */
 export declare function content<const TCollections extends ContentCollections>(options: ContentOptions<TCollections>): ContentPlugin<TCollections>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,KAAK,EAA0B,MAAM,aAAa,CAAC;AAExE,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIpF,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AACpC,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,aAAa,EACb,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,sFAAsF;AACtF,wBAAgB,OAAO,CAAC,KAAK,CAAC,YAAY,SAAS,kBAAkB,EACnE,OAAO,EAAE,cAAc,CAAC,YAAY,CAAC,GACpC,aAAa,CAAC,YAAY,CAAC,CA4G7B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,KAAK,EAA0B,MAAM,aAAa,CAAC;AAGxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIpF,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,aAAa,EACb,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,sFAAsF;AACtF,wBAAgB,OAAO,CAAC,KAAK,CAAC,YAAY,SAAS,kBAAkB,EACnE,OAAO,EAAE,cAAc,CAAC,YAAY,CAAC,GACpC,aAAa,CAAC,YAAY,CAAC,CAoM7B"}

package/dist/index.js

@@ -1,14 +1,27 @@
 import path from "node:path";
+import { lstat, realpath } from "node:fs/promises";
 import { definePlugin } from "@farm.js/core/plugin";
 import fg from "fast-glob";
 import { asset } from "./assets.js";
 import { collection, files, isSupportedContentFile } from "./config.js";
 import { loadContentCollections, writeContentServerModule } from "./loader.js";
+import { registerContentWriteRuntime, setContentAfterWrite } from "./runtime.js";
 const CONTENT_SERVER_ID = "@farm.js/content/server";
 export { asset, collection, files };
+export { remote } from "./config.js";
 /** Load schema-validated local content as a typed server-only collection registry. */
 export function content(options) {
     validateOptions(options);
+    // Writes need the live sources and schemas; the snapshot module carries
+    // only data. Registered here so both dev and the production runtime (where
+    // the config module is evaluated too) can reach them.
+    const unregisterWriteRuntime = registerContentWriteRuntime(Object.fromEntries(Object.entries(options.collections).map(([name, definition]) => [
+        name,
+        {
+            ...(definition.source.kind === "remote" ? { source: definition.source } : {}),
+            schema: definition.schema,
+        },
+    ])));
     let root = process.cwd();
     let generatedFile = "";
     let sourceFiles = new Set();
@@ -39,9 +52,11 @@ export function content(options) {
     async function rebuild() {
         const attemptedSourceFiles = new Set();
         try {
+            await assertGeneratedOutputInsideRoot(root, generatedFile);
             const loaded = await loadContentCollections(root, options.collections, attemptedSourceFiles);
-            await writeContentServerModule(generatedFile, loaded.collections, loaded.assetImports);
+            const changed = await writeContentServerModule(generatedFile, loaded.collections, loaded.assetImports);
             sourceFiles = new Set(loaded.sourceFiles);
+            return changed;
         }
         catch (error) {
             sourceFiles = new Set([...sourceFiles, ...attemptedSourceFiles]);
@@ -89,11 +104,116 @@ export function content(options) {
                 };
                 server.watcher.on("all", onFile);
                 server.httpServer?.once("close", () => server.watcher.off?.("all", onFile));
+                // A successful write refreshes the snapshot immediately in development.
+                // The stored chain must always settle: a rejected tail would swallow
+                // the next watcher rebuild entirely, so the error report lives inside
+                // the chain and the queue continues past it.
+                const disposeAfterWrite = setContentAfterWrite(async () => {
+                    const settled = (rebuildQueue = rebuildQueue
+                        .then(async () => {
+                        if (!(await rebuild()))
+                            return;
+                        const modules = server.moduleGraph.getModulesByFile?.(generatedFile);
+                        for (const module of modules ?? [])
+                            server.moduleGraph.invalidateModule(module);
+                        server.ws.send({ type: "full-reload" });
+                    })
+                        .catch((error) => {
+                        const message = error instanceof Error ? error.message : String(error);
+                        server.ws.send({
+                            type: "error",
+                            err: { message, stack: error instanceof Error ? error.stack : undefined },
+                        });
+                    }));
+                    await settled;
+                });
+                // Vite restart creates the replacement server before closing this one;
+                // the scoped disposers only clear registrations this server owns.
+                server.httpServer?.once("close", () => {
+                    disposeAfterWrite();
+                    unregisterWriteRuntime();
+                });
+                // Remote sources have no file events; poll the ones that asked for it.
+                // One timer at the smallest requested cadence keeps ordering simple,
+                // and a reload only goes out when the generated module actually changed.
+                const intervals = Object.values(options.collections)
+                    .map((definition) => definition.source)
+                    .filter((candidate) => candidate.kind === "remote")
+                    .map((candidate) => candidate.refreshInterval)
+                    .filter((value) => typeof value === "number");
+                if (intervals.length > 0) {
+                    // A persistently failing remote fetch reports once per distinct
+                    // message, not once per tick - the overlay is a signal, not a log.
+                    let lastPollError;
+                    const timer = setInterval(() => {
+                        rebuildQueue = rebuildQueue
+                            .then(async () => {
+                            if (!(await rebuild()))
+                                return;
+                            lastPollError = undefined;
+                            const modules = server.moduleGraph.getModulesByFile?.(generatedFile);
+                            for (const module of modules ?? [])
+                                server.moduleGraph.invalidateModule(module);
+                            server.ws.send({ type: "full-reload" });
+                        })
+                            .catch((error) => {
+                            const message = error instanceof Error ? error.message : String(error);
+                            if (message === lastPollError)
+                                return;
+                            lastPollError = message;
+                            server.ws.send({
+                                type: "error",
+                                err: { message, stack: error instanceof Error ? error.stack : undefined },
+                            });
+                        });
+                    }, Math.min(...intervals));
+                    timer.unref?.();
+                    server.httpServer?.once("close", () => clearInterval(timer));
+                }
             },
         };
     }
     return plugin;
 }
+async function assertGeneratedOutputInsideRoot(root, outputFile) {
+    const actualRoot = await realpath(root);
+    const missingSegments = [];
+    let existingAncestor = outputFile;
+    const unsafeOutput = () => new Error("[farm:content] Generated content output must stay inside the Farm project root, including through symlinks");
+    // Check the prospective destination before mkdir or writeFile can follow a link.
+    while (true) {
+        let actualAncestor;
+        try {
+            actualAncestor = await realpath(existingAncestor);
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+            const entry = await lstat(existingAncestor).catch((statError) => {
+                if (statError.code !== "ENOENT")
+                    throw statError;
+                return undefined;
+            });
+            if (entry)
+                throw unsafeOutput(); // A dangling symlink is not a missing directory.
+            const parent = path.dirname(existingAncestor);
+            if (parent === existingAncestor)
+                throw error;
+            missingSegments.unshift(path.basename(existingAncestor));
+            existingAncestor = parent;
+            continue;
+        }
+        const destination = path.join(actualAncestor, ...missingSegments);
+        const relative = path.relative(actualRoot, destination);
+        if (!relative ||
+            relative === ".." ||
+            relative.startsWith(`..${path.sep}`) ||
+            path.isAbsolute(relative)) {
+            throw unsafeOutput();
+        }
+        return;
+    }
+}
 async function shouldRebuildForFile(root, filePath, event, sourceFiles, collections) {
     if (sourceFiles.has(filePath))
         return true;
@@ -106,6 +226,8 @@ async function shouldRebuildForFile(root, filePath, event, sourceFiles, collecti
         return false;
     }
     for (const definition of Object.values(collections)) {
+        if (definition.source.kind !== "files")
+            continue;
         const matches = await fg([...definition.source.patterns], {
             cwd: root,
             absolute: true,

package/dist/loader.d.ts

@@ -6,7 +6,7 @@ export interface LoadedContent {
     readonly assetImports: ReadonlyMap<string, ContentAssetImport>;
 }
 export declare function loadContentCollections(root: string, collections: ContentCollections, sourceFiles?: Set<string>): Promise<LoadedContent>;
-export declare function writeContentServerModule(outputFile: string, collections: Readonly<Record<string, readonly ContentEntry<any>[]>>, assetImports?: ReadonlyMap<string, ContentAssetImport>): Promise<void>;
+export declare function writeContentServerModule(outputFile: string, collections: Readonly<Record<string, readonly ContentEntry<any>[]>>, assetImports?: ReadonlyMap<string, ContentAssetImport>): Promise<boolean>;
 type EncodedContentValue = null | boolean | number | string | ["undefined"] | ["date", string] | ["bigint", string] | ["array", EncodedContentValue[]] | ["object", Array<[string, EncodedContentValue]>];
 export declare function encodeContentValue(value: unknown, seen?: Set<object>): EncodedContentValue;
 export {};

package/dist/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAEV,kBAAkB,EAClB,YAAY,EAIb,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7E,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAChE;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,kBAAkB,EAC/B,WAAW,GAAE,GAAG,CAAC,MAAM,CAAa,GACnC,OAAO,CAAC,aAAa,CAAC,CAexB;AAED,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EACnE,YAAY,GAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAa,GAChE,OAAO,CAAC,IAAI,CAAC,CAgCf;AAoPD,KAAK,mBAAmB,GACpB,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,CAAC,WAAW,CAAC,GACb,CAAC,MAAM,EAAE,MAAM,CAAC,GAChB,CAAC,QAAQ,EAAE,MAAM,CAAC,GAClB,CAAC,OAAO,EAAE,mBAAmB,EAAE,CAAC,GAChC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAErD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,cAAoB,GAAG,mBAAmB,CAmChG"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAMA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAKV,kBAAkB,EAClB,YAAY,EAIb,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7E,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAChE;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,kBAAkB,EAC/B,WAAW,GAAE,GAAG,CAAC,MAAM,CAAa,GACnC,OAAO,CAAC,aAAa,CAAC,CAuBxB;AAED,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EACnE,YAAY,GAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAa,GAChE,OAAO,CAAC,OAAO,CAAC,CAsClB;AA+XD,KAAK,mBAAmB,GACpB,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,CAAC,WAAW,CAAC,GACb,CAAC,MAAM,EAAE,MAAM,CAAC,GAChB,CAAC,QAAQ,EAAE,MAAM,CAAC,GAClB,CAAC,OAAO,EAAE,mBAAmB,EAAE,CAAC,GAChC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAErD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,cAAoB,GAAG,mBAAmB,CAmChG"}

package/dist/loader.js

@@ -1,4 +1,5 @@
-import { mkdir, readFile, realpath, writeFile } from "node:fs/promises";
+import { createHash } from "node:crypto";
+import { lstat, mkdir, readFile, realpath, writeFile } from "node:fs/promises";
 import path from "node:path";
 import fg from "fast-glob";
 import matter from "gray-matter";
@@ -9,9 +10,10 @@ import { resolveMarkdownAssets } from "./markdown-assets.js";
 export async function loadContentCollections(root, collections, sourceFiles = new Set()) {
     const loaded = Object.create(null);
     const assetImports = new Map();
+    const actualRoot = await realpath(root);
     for (const [name, definition] of Object.entries(collections)) {
         validateCollectionName(name);
-        const entries = await loadCollection(root, name, definition, sourceFiles, assetImports);
+        const entries = await loadCollection(root, actualRoot, name, definition, sourceFiles, assetImports);
         loaded[name] = Object.freeze(entries);
     }
     return {
@@ -26,9 +28,17 @@ export async function writeContentServerModule(outputFile, collections, assetImp
     const actualOutputDirectory = await realpath(outputDirectory);
     const encoded = encodeContentValue(collections);
     const imports = [...assetImports.values()].sort((left, right) => left.token.localeCompare(right.token));
-    const importSource = imports
-        .map((asset, index) => `import farmContentAsset${index} from ${JSON.stringify(`${toViteImportSpecifier(actualOutputDirectory, asset.filePath)}?url`)};`)
-        .join("\n");
+    const importLines = [];
+    for (const [index, asset] of imports.entries()) {
+        const relativePath = toViteImportSpecifier(actualOutputDirectory, asset.filePath);
+        // Vite treats these characters as URL syntax, even in resolved filesystem IDs.
+        // Only stage affected assets; ordinary files keep their direct ?url imports.
+        const importPath = /[?#%]/.test(relativePath)
+            ? await stageContentAsset(actualOutputDirectory, asset.filePath)
+            : relativePath;
+        importLines.push(`import farmContentAsset${index} from ${JSON.stringify(`${importPath}?url`)};`);
+    }
+    const importSource = importLines.join("\n");
     const assetUrls = imports.length
         ? `, { ${imports
             .map((asset, index) => `${JSON.stringify(asset.token)}: farmContentAsset${index}`)
@@ -43,11 +53,40 @@ const runtime = createContentRuntime(decodeContentValue(${JSON.stringify(encoded
 export const getCollection = runtime.getCollection;
 export const getEntry = runtime.getEntry;
 export const getEntryOrThrow = runtime.getEntryOrThrow;
+export const collections = runtime.collections;
 `;
-    await writeFileIfChanged(outputFile, source);
+    return writeFileIfChanged(outputFile, source);
+}
+async function stageContentAsset(outputDirectory, filePath) {
+    const bytes = await readFile(filePath);
+    const digest = createHash("sha256").update(bytes).digest("hex");
+    const extension = path.extname(filePath);
+    const filename = `${digest}${/^\.[a-z\d]+$/i.test(extension) ? extension : ".bin"}`;
+    const directory = path.join(outputDirectory, "assets");
+    await mkdir(directory, { recursive: true });
+    if ((await realpath(directory)) !== directory) {
+        throw new Error("[farm:content] Generated asset directory cannot be a symlink");
+    }
+    const target = path.join(directory, filename);
+    try {
+        // Never overwrite an existing file or follow a pre-existing destination symlink.
+        await writeFile(target, bytes, { flag: "wx" });
+    }
+    catch (error) {
+        if (error.code !== "EEXIST")
+            throw error;
+        if (!(await lstat(target)).isFile() || !(await readFile(target)).equals(bytes)) {
+            throw new Error(`[farm:content] Generated asset ${filename} is not a matching regular file`);
+        }
+    }
+    // Content-addressing changes the import on edits, avoiding stale Vite module URLs.
+    return `./assets/${filename}`;
 }
-async function loadCollection(root, name, definition, sourceFiles, assetImports) {
+async function loadCollection(root, actualRoot, name, definition, sourceFiles, assetImports) {
     const source = definition.source;
+    if (source.kind === "remote") {
+        return loadRemoteCollection(name, definition, source);
+    }
     const relativeFiles = await fg([...source.patterns], {
         cwd: root,
         absolute: false,
@@ -72,7 +111,15 @@ async function loadCollection(root, name, definition, sourceFiles, assetImports)
         }
         ids.set(id, relativeFile);
         sourceFiles.add(absoluteFile);
-        const parsed = await parseContentFile(absoluteFile, relativeFile);
+        const actualFile = await realpath(absoluteFile);
+        const relativeToRoot = path.relative(actualRoot, actualFile);
+        if (relativeToRoot === ".." ||
+            relativeToRoot.startsWith(`..${path.sep}`) ||
+            path.isAbsolute(relativeToRoot)) {
+            throw new Error(`[farm:content] Collection "${name}" source ${relativeFile} cannot leave the Farm project root`);
+        }
+        sourceFiles.add(actualFile);
+        const parsed = await parseContentFile(actualFile, relativeFile);
         const assetContext = {
             root,
             collectionName: name,
@@ -121,12 +168,79 @@ async function loadCollection(root, name, definition, sourceFiles, assetImports)
     }
     return entries;
 }
+/**
+ * A remote collection goes through the same validation and transform pipeline
+ * as files; only acquisition differs. Documents are sorted by ID so the
+ * generated module is stable across fetches that return in a different order.
+ */
+async function loadRemoteCollection(name, definition, source) {
+    let documents;
+    try {
+        documents = await source.fetch();
+    }
+    catch (error) {
+        throw new Error(`[farm:content] Collection ${JSON.stringify(name)} failed to fetch from ${JSON.stringify(source.name)}: ${errorMessage(error)}`, { cause: error });
+    }
+    if (!Array.isArray(documents)) {
+        throw new Error(`[farm:content] Collection ${JSON.stringify(name)}: source ${JSON.stringify(source.name)} must resolve to an array of documents`);
+    }
+    const ids = new Set();
+    const sorted = [...documents].sort((left, right) => String(left?.id ?? "").localeCompare(String(right?.id ?? "")));
+    const entries = [];
+    for (const document of sorted) {
+        if (!document ||
+            typeof document !== "object" ||
+            typeof document.id !== "string" ||
+            !document.id) {
+            throw new Error(`[farm:content] Collection ${JSON.stringify(name)}: every document from ${JSON.stringify(source.name)} needs a non-empty string id`);
+        }
+        if (ids.has(document.id)) {
+            throw new Error(`[farm:content] Collection ${JSON.stringify(name)} has duplicate entry ID ${JSON.stringify(document.id)} from ${JSON.stringify(source.name)}`);
+        }
+        ids.add(document.id);
+        if (!document.data || typeof document.data !== "object" || Array.isArray(document.data)) {
+            throw new Error(`[farm:content] Collection ${JSON.stringify(name)}: document ${JSON.stringify(document.id)} from ${JSON.stringify(source.name)} needs an object \`data\``);
+        }
+        const reference = `${source.name}/${document.id}`;
+        const validatedData = await validateContentData(definition.schema, document.data, name, reference);
+        const body = typeof document.body === "string" ? document.body : "";
+        const baseEntry = {
+            id: document.id,
+            data: validatedData,
+            body,
+            bodyAssets: Object.freeze([]),
+            filePath: reference,
+            words: countWords(body),
+        };
+        const transformed = definition.transform
+            ? await definition.transform(baseEntry)
+            : baseEntry.data;
+        entries.push(Object.freeze({
+            id: document.id,
+            data: freezeContentValue(transformed),
+            body,
+            bodyAssets: freezeContentValue([]),
+            filePath: reference,
+        }));
+    }
+    return entries;
+}
 async function parseContentFile(absoluteFile, relativeFile) {
     const source = await readFile(absoluteFile, "utf8");
     const extension = path.extname(relativeFile).toLowerCase();
     try {
         if (extension === ".md" || extension === ".mdx") {
-            const parsed = matter(source);
+            // Check the same delimiter/language that gray-matter will parse, before
+            // its default engines can evaluate executable frontmatter.
+            const normalizedSource = source.replace(/^\uFEFF/, "");
+            if (normalizedSource.startsWith("---") && normalizedSource[3] !== "-") {
+                const language = matter.language(normalizedSource).name.toLowerCase();
+                if (language && language !== "yaml" && language !== "yml" && language !== "json") {
+                    throw new Error("Only YAML and JSON frontmatter are supported");
+                }
+            }
+            // Explicit options also avoid gray-matter's process-global parsed cache.
+            const parsed = matter(source, {});
             return { data: parsed.data, body: parsed.content };
         }
         if (extension === ".json") {
@@ -347,13 +461,14 @@ function freezeContentValue(value, ancestors = new Set()) {
 async function writeFileIfChanged(filePath, source) {
     try {
         if ((await readFile(filePath, "utf8")) === source)
-            return;
+            return false;
     }
     catch (error) {
         if (error.code !== "ENOENT")
             throw error;
     }
     await writeFile(filePath, source, "utf8");
+    return true;
 }
 function errorMessage(error) {
     return error instanceof Error ? error.message : String(error);

package/dist/markdown-assets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-assets.d.ts","sourceRoot":"","sources":["../src/markdown-assets.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA8BpD,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAAE,CAAC,CAsCjE"}
+{"version":3,"file":"markdown-assets.d.ts","sourceRoot":"","sources":["../src/markdown-assets.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA8BpD,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAAE,CAAC,CAkDjE"}

package/dist/markdown-assets.js

@@ -6,7 +6,20 @@ export async function resolveMarkdownAssets(body, context) {
         return { body, assets: Object.freeze([]) };
     let tree;
     try {
-        tree = fromMarkdown(body);
+        if (context.sourceFile.toLowerCase().endsWith(".mdx")) {
+            // Parse MDX without evaluating it. Only Markdown children own assets.
+            const [{ mdxFromMarkdown }, { mdxjs }] = await Promise.all([
+                import("mdast-util-mdx"),
+                import("micromark-extension-mdxjs"),
+            ]);
+            tree = fromMarkdown(body, {
+                extensions: [mdxjs()],
+                mdastExtensions: [mdxFromMarkdown()],
+            });
+        }
+        else {
+            tree = fromMarkdown(body);
+        }
     }
     catch (error) {
         throw new Error(`[farm:content] Could not inspect Markdown assets in ${context.sourceFile}: ${errorMessage(error)}`, { cause: error });
@@ -39,7 +52,9 @@ function collectCandidates(tree) {
     const references = new Map();
     visit(tree, (node) => {
         if (node.type === "definition" && node.identifier) {
-            definitions.set(node.identifier, node);
+            // CommonMark resolves duplicate reference labels to their first definition.
+            if (!definitions.has(node.identifier))
+                definitions.set(node.identifier, node);
             return;
         }
         if (node.type === "imageReference" && node.identifier) {

package/dist/runtime.d.ts

@@ -1,11 +1,24 @@
-import type { ContentEntry } from "./types.js";
+import type { ContentEntry, ContentRemoteSource, ContentSchema } from "./types.js";
 type RuntimeCollections = Readonly<Record<string, readonly ContentEntry<any>[]>>;
 type EncodedContentValue = null | boolean | number | string | ["undefined"] | ["date", string] | ["bigint", string] | ["array", EncodedContentValue[]] | ["object", Array<[string, EncodedContentValue]>];
 export declare function decodeContentValue(value: EncodedContentValue, assetUrls?: Readonly<Record<string, string>>): any;
+/**
+ * Live write runtime, shared between the config-time plugin and the generated
+ * server module through globalThis so bundle-copy duplication cannot split it.
+ * The plugin registers each collection's source and schema when the factory
+ * runs; the generated module's `collections` handle reads them for writes.
+ */
+interface ContentWriteRegistration {
+    source?: ContentRemoteSource;
+    schema?: ContentSchema<any>;
+}
+export declare function registerContentWriteRuntime(registrations: Record<string, ContentWriteRegistration>): () => void;
+export declare function setContentAfterWrite(afterWrite: (() => Promise<void>) | undefined): () => void;
 export declare function createContentRuntime(collections: RuntimeCollections): Readonly<{
     getCollection: (name: string) => Promise<readonly ContentEntry<any>[]>;
     getEntry: (name: string, id: string) => Promise<ContentEntry<any> | undefined>;
     getEntryOrThrow: (name: string, id: string) => Promise<ContentEntry<any>>;
+    collections: Record<string, unknown>;
 }>;
 export {};
 //# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,KAAK,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAEjF,KAAK,mBAAmB,GACpB,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,CAAC,WAAW,CAAC,GACb,CAAC,MAAM,EAAE,MAAM,CAAC,GAChB,CAAC,QAAQ,EAAE,MAAM,CAAC,GAClB,CAAC,OAAO,EAAE,mBAAmB,EAAE,CAAC,GAChC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAErD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,mBAAmB,EAC1B,SAAS,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,GAC/C,GAAG,CAwBL;AAUD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,kBAAkB;0BAkB/B,MAAM;qBACX,MAAM,MAAM,MAAM;4BAQX,MAAM,MAAM,MAAM;GASxD"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEnF,KAAK,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAEjF,KAAK,mBAAmB,GACpB,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,CAAC,WAAW,CAAC,GACb,CAAC,MAAM,EAAE,MAAM,CAAC,GAChB,CAAC,QAAQ,EAAE,MAAM,CAAC,GAClB,CAAC,OAAO,EAAE,mBAAmB,EAAE,CAAC,GAChC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAErD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,mBAAmB,EAC1B,SAAS,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,GAC/C,GAAG,CAwBL;AAUD;;;;;GAKG;AACH,UAAU,wBAAwB;IAChC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,MAAM,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;CAC7B;AA2BD,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,GACtD,MAAM,IAAI,CAiBZ;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,GAAG,MAAM,IAAI,CAS9F;AA6DD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,kBAAkB;0BAkB/B,MAAM;qBACX,MAAM,MAAM,MAAM;4BAQX,MAAM,MAAM,MAAM;;GAwExD"}

package/dist/runtime.js

@@ -34,6 +34,100 @@ function replaceAssetUrls(value, assetUrls) {
     }
     return result;
 }
+const WRITE_RUNTIME_KEY = "__FARM_CONTENT_WRITE_RUNTIME__";
+function writeRuntime() {
+    const scope = globalThis;
+    return (scope[WRITE_RUNTIME_KEY] ??= { registrations: Object.create(null) });
+}
+const RESERVED_REGISTRATION_NAMES = new Set(["__proto__", "constructor", "prototype"]);
+const PROTOCOL_PROBE_KEYS = new Set([
+    "then",
+    "toJSON",
+    "constructor",
+    "$$typeof",
+    "nodeType",
+    "asymmetricMatch",
+    "@@__IMMUTABLE_ITERABLE__@@",
+]);
+export function registerContentWriteRuntime(registrations) {
+    const target = writeRuntime().registrations;
+    const names = [];
+    // Own keys assigned one by one onto a null-prototype record: a collection
+    // literally named __proto__ must become data, never the record's prototype.
+    for (const name of Object.keys(registrations)) {
+        if (RESERVED_REGISTRATION_NAMES.has(name)) {
+            throw new Error(`[farm:content] Collection name ${JSON.stringify(name)} is reserved`);
+        }
+        target[name] = registrations[name];
+        names.push(name);
+    }
+    return () => {
+        for (const name of names) {
+            if (target[name] === registrations[name])
+                delete target[name];
+        }
+    };
+}
+export function setContentAfterWrite(afterWrite) {
+    const state = writeRuntime();
+    state.afterWrite = afterWrite;
+    // Vite's restart creates the new server (registering its hook) BEFORE it
+    // closes the old one, so an unconditional clear in the old server's close
+    // handler would disarm the replacement. Only the current owner may clear.
+    return () => {
+        if (state.afterWrite === afterWrite)
+            state.afterWrite = undefined;
+    };
+}
+function requireWritableSource(name, verb) {
+    const registration = writeRuntime().registrations[name];
+    if (!registration?.source) {
+        throw new Error(`[farm:content] Collection "${name}" is read-only: only a remote() source can write. ` +
+            "Local file collections are edited on disk.");
+    }
+    const callback = registration.source[verb];
+    if (!callback) {
+        throw new Error(`[farm:content] Collection "${name}": source ${JSON.stringify(registration.source.name)} ` +
+            `does not implement ${verb}(). Add the callback to the source, or perform the write ` +
+            "with the provider's own SDK in a server function.");
+    }
+    return { callback: callback.bind(registration.source), registration };
+}
+async function validateAgainstSchema(schema, data) {
+    if (!schema)
+        return;
+    if (typeof schema.parseAsync === "function") {
+        await schema.parseAsync(data);
+        return;
+    }
+    if (typeof schema.parse === "function") {
+        schema.parse(data);
+        return;
+    }
+    const standard = schema["~standard"];
+    if (standard) {
+        const result = await standard.validate(data);
+        if (result && "issues" in result && result.issues?.length) {
+            throw new Error(`[farm:content] The written document failed validation: ${result.issues
+                .map((issue) => issue.message)
+                .join("; ")}`);
+        }
+    }
+}
+async function settleWrite(result) {
+    // The CMS accepted the write; refresh the local snapshot where a dev server
+    // is present. In production the snapshot is bundled, so the change becomes
+    // visible on the next build - pair writes with a deploy hook. A failing
+    // refresh must not report the persisted write as failed: the dev pipeline
+    // surfaces its own errors.
+    try {
+        await writeRuntime().afterWrite?.();
+    }
+    catch {
+        // reported by the dev pipeline's own channel
+    }
+    return result;
+}
 export function createContentRuntime(collections) {
     const indexes = new Map();
     function collection(name) {
@@ -62,5 +156,67 @@ export function createContentRuntime(collections) {
         }
         return entry;
     };
-    return Object.freeze({ getCollection, getEntry, getEntryOrThrow });
+    const handles = new Map();
+    const collectionHandle = (name) => {
+        let handle = handles.get(name);
+        if (!handle) {
+            collection(name); // unknown names fail here with the available list
+            handle = Object.freeze({
+                all: () => getCollection(name),
+                get: (id) => getEntry(name, id),
+                getOrThrow: (id) => getEntryOrThrow(name, id),
+                create: async (input) => {
+                    const { callback, registration } = requireWritableSource(name, "create");
+                    const document = await callback(input);
+                    // The source of truth answered; make sure what it stored still
+                    // satisfies the collection's schema before anyone trusts it.
+                    // The CMS changed either way, so the snapshot refreshes even when
+                    // validation rejects - readers should see the CMS's real state.
+                    try {
+                        await validateAgainstSchema(registration.schema, document.data);
+                    }
+                    catch (error) {
+                        await settleWrite(undefined);
+                        throw error;
+                    }
+                    return settleWrite(document);
+                },
+                update: async (id, patch) => {
+                    const { callback, registration } = requireWritableSource(name, "update");
+                    const document = await callback(id, patch);
+                    try {
+                        await validateAgainstSchema(registration.schema, document.data);
+                    }
+                    catch (error) {
+                        await settleWrite(undefined);
+                        throw error;
+                    }
+                    return settleWrite(document);
+                },
+                delete: async (id) => {
+                    const { callback } = requireWritableSource(name, "delete");
+                    await callback(id);
+                    await settleWrite(undefined);
+                },
+            });
+            handles.set(name, handle);
+        }
+        return handle;
+    };
+    // Runtimes probe objects with protocol keys: await checks `then`,
+    // JSON.stringify checks `toJSON`, test matchers poke a few more. Those
+    // probes must see undefined; only a real unknown collection name throws.
+    const collectionsProxy = new Proxy(Object.create(null), {
+        get(_target, property) {
+            if (typeof property !== "string")
+                return undefined;
+            if (!(property in collections) && PROTOCOL_PROBE_KEYS.has(property))
+                return undefined;
+            return collectionHandle(property);
+        },
+        has: (_target, property) => typeof property === "string" && property in collections,
+        ownKeys: () => Object.keys(collections),
+        getOwnPropertyDescriptor: () => ({ enumerable: true, configurable: true }),
+    });
+    return Object.freeze({ getCollection, getEntry, getEntryOrThrow, collections: collectionsProxy });
 }

package/dist/server.d.ts

@@ -1,9 +1,18 @@
-import type { AppContentEntry, ContentCollectionName } from "./types.js";
+import type { AppContentEntry, ContentCollectionHandle, ContentCollectionName } from "./types.js";
 /** Return every entry in a configured collection, ordered by entry ID. */
 export declare function getCollection<TName extends ContentCollectionName>(_name: TName): Promise<readonly AppContentEntry<TName>[]>;
 /** Find one entry by its path-derived ID. */
 export declare function getEntry<TName extends ContentCollectionName>(_name: TName, _id: string): Promise<AppContentEntry<TName> | undefined>;
 /** Find one entry by ID or throw an actionable error. */
 export declare function getEntryOrThrow<TName extends ContentCollectionName>(_name: TName, _id: string): Promise<AppContentEntry<TName>>;
-export type { AppContentEntry, AppContentRegistry, ContentCollectionName, ContentEntry, } from "./types.js";
+/**
+ * The per-collection handle: reads from the validated snapshot, writes
+ * through the source's create/update/delete callbacks. Development rebuilds
+ * the snapshot after a write; production serves the bundled snapshot until
+ * the next build, so pair writes with a deploy hook.
+ */
+export declare const collections: {
+    readonly [TName in ContentCollectionName]: ContentCollectionHandle<AppContentEntry<TName>["data"]>;
+};
+export type { AppContentEntry, AppContentRegistry, ContentCollectionHandle, ContentCollectionName, ContentEntry, } from "./types.js";
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAQzE,0EAA0E;AAC1E,wBAAsB,aAAa,CAAC,KAAK,SAAS,qBAAqB,EACrE,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,SAAS,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAE5C;AAED,6CAA6C;AAC7C,wBAAsB,QAAQ,CAAC,KAAK,SAAS,qBAAqB,EAChE,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,CAE7C;AAED,yDAAyD;AACzD,wBAAsB,eAAe,CAAC,KAAK,SAAS,qBAAqB,EACvE,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAEjC;AAED,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,GACb,MAAM,YAAY,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAQlG,0EAA0E;AAC1E,wBAAsB,aAAa,CAAC,KAAK,SAAS,qBAAqB,EACrE,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,SAAS,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAE5C;AAED,6CAA6C;AAC7C,wBAAsB,QAAQ,CAAC,KAAK,SAAS,qBAAqB,EAChE,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,CAE7C;AAED,yDAAyD;AACzD,wBAAsB,eAAe,CAAC,KAAK,SAAS,qBAAqB,EACvE,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAEjC;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE;IACxB,QAAQ,EAAE,KAAK,IAAI,qBAAqB,GAAG,uBAAuB,CAChE,eAAe,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAC/B;CAC+D,CAAC;AAEnE,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/server.js

@@ -13,3 +13,10 @@ export async function getEntry(_name, _id) {
 export async function getEntryOrThrow(_name, _id) {
     return missingPlugin();
 }
+/**
+ * The per-collection handle: reads from the validated snapshot, writes
+ * through the source's create/update/delete callbacks. Development rebuilds
+ * the snapshot after a write; production serves the bundled snapshot until
+ * the next build, so pair writes with a deploy hook.
+ */
+export const collections = new Proxy(Object.create(null), { get: () => missingPlugin() });

package/dist/types.d.ts

@@ -6,6 +6,48 @@ export interface ContentFileSource {
     readonly ignore: readonly string[];
     readonly base?: string;
 }
+/** One document delivered by a remote source, before validation. */
+export interface ContentRemoteDocument {
+    /** Stable route-friendly identifier, unique within the collection. */
+    readonly id: string;
+    /** Structured data; goes through the collection schema like frontmatter. */
+    readonly data: Record<string, unknown>;
+    /** Optional Markdown body. Defaults to an empty string. */
+    readonly body?: string;
+}
+/**
+ * A source that fetches documents instead of reading local files - a CMS, an
+ * API, a database. Fetched while the configuration loads, validated through
+ * the same schema pipeline as files, and bundled into production output as
+ * the same build-time snapshot. The shape is structural on purpose: an
+ * integration can return it without importing this package at runtime.
+ */
+/** The document fields a write sends to a remote source. */
+export interface ContentRemoteWrite {
+    readonly data: Record<string, unknown>;
+    readonly body?: string;
+}
+export interface ContentRemoteSource {
+    readonly kind: "remote";
+    /** Names the source in error messages, e.g. "sanity:posts". */
+    readonly name: string;
+    fetch(): Promise<readonly ContentRemoteDocument[]>;
+    /**
+     * Development only: re-fetch this often (milliseconds) and reload when the
+     * documents changed. Leave unset for fetch-on-rebuild only.
+     */
+    readonly refreshInterval?: number;
+    /**
+     * Optional write callbacks, mirroring fetch: the callback is the entire
+     * provider-specific surface. A source that omits them is read-only, and
+     * `collections.<name>.create/update/delete` reports which verb is missing.
+     * The CMS stays the source of truth: each returns the confirmed document.
+     */
+    create?(input: ContentRemoteWrite): Promise<ContentRemoteDocument>;
+    update?(id: string, patch: Partial<ContentRemoteWrite>): Promise<ContentRemoteDocument>;
+    delete?(id: string): Promise<void>;
+}
+export type ContentSource = ContentFileSource | ContentRemoteSource;
 export interface ContentSchemaIssue {
     readonly message: string;
     readonly path?: readonly unknown[];
@@ -98,12 +140,33 @@ export interface ContentEntry<TData = Record<string, unknown>> {
     /** Project-relative source path with POSIX separators. */
     readonly filePath: string;
 }
+/**
+ * The server-side handle for one collection: reads from the validated
+ * snapshot, writes through the source's callbacks. In development a write
+ * rebuilds the snapshot immediately; in production the write lands in the
+ * CMS and the running deployment serves the bundled snapshot until the
+ * next build, so pair writes with a deploy hook.
+ */
+export interface ContentCollectionHandle<TData = Record<string, unknown>> {
+    all(): Promise<readonly ContentEntry<TData>[]>;
+    get(id: string): Promise<ContentEntry<TData> | undefined>;
+    getOrThrow(id: string): Promise<ContentEntry<TData>>;
+    create(input: {
+        data: Record<string, unknown>;
+        body?: string;
+    }): Promise<ContentRemoteDocument>;
+    update(id: string, patch: {
+        data?: Partial<TData> & Record<string, unknown>;
+        body?: string;
+    }): Promise<ContentRemoteDocument>;
+    delete(id: string): Promise<void>;
+}
 export interface ContentTransformContext<TData> extends ContentEntry<TData> {
     /** Number of whitespace-delimited words in body. */
     readonly words: number;
 }
 export interface ContentCollectionInput<TSchema extends ContentSchema<any>, TTransformed = InferContentSchema<TSchema>, TAssets extends ContentAssetsInput = undefined> {
-    source: ContentFileSource;
+    source: ContentSource;
     schema: TSchema;
     /**
      * Process relative assets. `true` manages Markdown/MDX body references. An object also declares
@@ -114,7 +177,7 @@ export interface ContentCollectionInput<TSchema extends ContentSchema<any>, TTra
     transform?: (entry: ContentTransformContext<ContentDataWithAssets<InferContentSchema<TSchema>, TAssets>>) => TTransformed | Promise<TTransformed>;
 }
 export interface ContentCollection<TData = unknown, TSchemaData = TData> {
-    readonly source: ContentFileSource;
+    readonly source: ContentSource;
     readonly schema: ContentSchema<TSchemaData>;
     readonly assets?: true | ContentAssetFields;
     readonly transform?: (entry: ContentTransformContext<any>) => unknown | Promise<unknown>;

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farm.js/content",
-  "version": "0.1.0-beta.0",
+  "version": "0.1.0-beta.2",
   "description": "Typed local content collections for Farm.js applications",
   "keywords": [
     "content",
@@ -42,14 +42,17 @@
   "dependencies": {
     "fast-glob": "^3.3.2",
     "gray-matter": "^4.0.3",
-    "image-size": "^2.0.2",
+    "image-size": "^2.0.4",
     "mdast-util-from-markdown": "^2.0.2",
+    "mdast-util-mdx": "^3.0.0",
+    "micromark-extension-mdxjs": "^3.0.0",
     "yaml": "^2.8.0",
-    "@farm.js/core": "0.1.0-beta.92"
+    "@farm.js/core": "0.1.0"
   },
   "devDependencies": {
     "@types/node": "^20.10.5",
     "typescript": "^5.3.3",
+    "vite": "5.4.20",
     "vitest": "^3.2.7"
   },
   "engines": {