@telepath-computer/autofile 0.0.0-stage → 0.3.0

package/dist/config.d.ts

@@ -0,0 +1,31 @@
+/** Reads, validates, and writes Autofile's process-wide settings. */
+declare const settingNames: readonly ["storage", "http.host", "http.port", "http.origins"];
+export type SettingName = typeof settingNames[number];
+export interface HttpSettings {
+    host: string;
+    port: number;
+    origins: string[];
+}
+export interface Settings {
+    storage: string;
+    http: HttpSettings;
+}
+/** Returns whether a command argument names one of Autofile's settings. */
+export declare function isSettingName(value: string): value is SettingName;
+/** Returns the path shared stores use to serialize writes between processes. */
+export declare function getWriteLockPath(): string;
+/** Returns every effective setting, applying defaults to settings that are absent. */
+export declare function getSettings(): Promise<Settings>;
+/** Returns the configured data folder, or the default folder when unset. */
+export declare function getStorage(): Promise<string>;
+/** Returns a setting as the lines its CLI `get` command prints. */
+export declare function getSetting(name: SettingName): Promise<string[]>;
+/** Validates and stores one setting while preserving every other setting. */
+export declare function setSetting(name: SettingName, values: string[]): Promise<void>;
+/** Removes one setting so its default applies, preserving its siblings. */
+export declare function unsetSetting(name: SettingName): Promise<void>;
+/** Parses a CLI port value and rejects anything outside the TCP port range. */
+export declare function parsePort(value: string): number;
+/** Returns the URL-normalized form of a strict HTTP origin, or undefined when invalid. */
+export declare function normalizeHttpOrigin(value: string): string | undefined;
+export {};

package/dist/config.js

@@ -0,0 +1,258 @@
+/** Reads, validates, and writes Autofile's process-wide settings. */
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+const DEFAULT_HTTP_HOST = "127.0.0.1";
+const DEFAULT_HTTP_PORT = 7319;
+const settingNames = ["storage", "http.host", "http.port", "http.origins"];
+function getAutofileHome() {
+    return resolve(process.env.AUTOFILE_HOME ?? join(homedir(), ".autofile"));
+}
+/** Returns whether a command argument names one of Autofile's settings. */
+export function isSettingName(value) {
+    return settingNames.includes(value);
+}
+/** Returns the path shared stores use to serialize writes between processes. */
+export function getWriteLockPath() {
+    return join(getAutofileHome(), "write.lock");
+}
+async function readConfig() {
+    const configPath = join(getAutofileHome(), "config.json");
+    let text;
+    try {
+        text = await readFile(configPath, "utf8");
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT")
+            return {};
+        throw error;
+    }
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch {
+        throw new Error(`${configPath}: invalid JSON`);
+    }
+    if (!isObject(value))
+        throw new Error(`${configPath}: must contain a JSON object`);
+    const storage = "storage" in value ? value.storage : undefined;
+    if (storage !== undefined && typeof storage !== "string") {
+        throw new Error(`${configPath}: storage must be a string`);
+    }
+    const httpValue = "http" in value ? value.http : undefined;
+    if (httpValue !== undefined && !isObject(httpValue)) {
+        throw new Error(`${configPath}: http must be a JSON object`);
+    }
+    const host = httpValue === undefined || !("host" in httpValue) ? undefined : httpValue.host;
+    if (host !== undefined && (typeof host !== "string" || host.length === 0)) {
+        throw new Error(`${configPath}: http.host must be a non-empty string`);
+    }
+    const port = httpValue === undefined || !("port" in httpValue) ? undefined : httpValue.port;
+    if (port !== undefined && !isPort(port)) {
+        throw new Error(`${configPath}: http.port must be an integer from 1 to 65535`);
+    }
+    const originsValue = httpValue === undefined || !("origins" in httpValue)
+        ? undefined
+        : httpValue.origins;
+    let origins;
+    if (originsValue !== undefined && !Array.isArray(originsValue)) {
+        throw new Error(`${configPath}: http.origins must contain only http or https origins without paths`);
+    }
+    if (originsValue !== undefined) {
+        origins = [];
+        for (const origin of originsValue) {
+            const normalized = typeof origin === "string" ? normalizeHttpOrigin(origin) : undefined;
+            if (normalized === undefined) {
+                throw new Error(`${configPath}: http.origins must contain only http or https origins without paths`);
+            }
+            origins.push(normalized);
+        }
+    }
+    return {
+        ...(storage === undefined ? {} : { storage }),
+        ...(host === undefined && port === undefined && origins === undefined
+            ? {}
+            : {
+                http: {
+                    ...(host === undefined ? {} : { host }),
+                    ...(port === undefined ? {} : { port }),
+                    ...(origins === undefined ? {} : { origins }),
+                },
+            }),
+    };
+}
+async function writeConfig(config) {
+    const autofileHome = getAutofileHome();
+    await mkdir(autofileHome, { recursive: true });
+    await writeFile(join(autofileHome, "config.json"), `${JSON.stringify(canonicalConfig(config), null, 2)}\n`, "utf8");
+}
+/** Returns every effective setting, applying defaults to settings that are absent. */
+export async function getSettings() {
+    const config = await readConfig();
+    return {
+        storage: config.storage ?? join(getAutofileHome(), "data"),
+        http: {
+            host: config.http?.host ?? DEFAULT_HTTP_HOST,
+            port: config.http?.port ?? DEFAULT_HTTP_PORT,
+            origins: [...(config.http?.origins ?? [])],
+        },
+    };
+}
+/** Returns the configured data folder, or the default folder when unset. */
+export async function getStorage() {
+    return (await getSettings()).storage;
+}
+/** Returns a setting as the lines its CLI `get` command prints. */
+export async function getSetting(name) {
+    const settings = await getSettings();
+    switch (name) {
+        case "storage": return [settings.storage];
+        case "http.host": return [settings.http.host];
+        case "http.port": return [String(settings.http.port)];
+        case "http.origins": return settings.http.origins;
+    }
+}
+/** Validates and stores one setting while preserving every other setting. */
+export async function setSetting(name, values) {
+    const config = await readConfig();
+    switch (name) {
+        case "storage": {
+            const [folder] = values;
+            if (values.length !== 1 || folder === undefined || folder === "") {
+                throw new Error("storage must be a non-empty folder");
+            }
+            config.storage = resolveStorage(folder);
+            break;
+        }
+        case "http.host": {
+            const [host] = values;
+            if (values.length !== 1 || host === undefined || host === "") {
+                throw new Error("http.host must be a non-empty string");
+            }
+            config.http = { ...config.http, host };
+            break;
+        }
+        case "http.port": {
+            const [value] = values;
+            if (values.length !== 1 || value === undefined) {
+                throw new Error("http.port must be an integer from 1 to 65535");
+            }
+            config.http = { ...config.http, port: parsePort(value) };
+            break;
+        }
+        case "http.origins": {
+            if (values.length === 0) {
+                throw new Error("http.origins must contain at least one origin");
+            }
+            config.http = { ...config.http, origins: values.map(parseOrigin) };
+            break;
+        }
+    }
+    await writeConfig(config);
+}
+/** Removes one setting so its default applies, preserving its siblings. */
+export async function unsetSetting(name) {
+    const config = await readConfig();
+    let changed = false;
+    if (name === "storage") {
+        changed = config.storage !== undefined;
+        delete config.storage;
+    }
+    else if (config.http !== undefined) {
+        const key = name.slice("http.".length);
+        changed = config.http[key] !== undefined;
+        delete config.http[key];
+        if (Object.keys(config.http).length === 0)
+            delete config.http;
+    }
+    if (changed)
+        await writeConfig(config);
+}
+/** Parses a CLI port value and rejects anything outside the TCP port range. */
+export function parsePort(value) {
+    if (!/^\d+$/u.test(value)) {
+        throw new Error("http.port must be an integer from 1 to 65535");
+    }
+    const port = Number(value);
+    if (!isPort(port))
+        throw new Error("http.port must be an integer from 1 to 65535");
+    return port;
+}
+function resolveStorage(folder) {
+    if (folder === "~")
+        return homedir();
+    return folder.startsWith("~/") ? resolve(homedir(), folder.slice(2)) : resolve(folder);
+}
+function parseOrigin(value) {
+    const origin = normalizeHttpOrigin(value);
+    if (origin === undefined) {
+        throw new Error("http.origins must contain only http or https origins without paths");
+    }
+    return origin;
+}
+/** Returns the URL-normalized form of a strict HTTP origin, or undefined when invalid. */
+export function normalizeHttpOrigin(value) {
+    const match = /^https?:\/\/(.+)$/iu.exec(value);
+    if (match === null)
+        return undefined;
+    const authority = match[1];
+    if (authority === undefined
+        || authority.trim() !== authority
+        || /[\s/\\?#@]/u.test(authority)) {
+        return undefined;
+    }
+    if (authority.startsWith("[")) {
+        const closingBracket = authority.indexOf("]");
+        if (closingBracket <= 1
+            || (authority.slice(closingBracket + 1) !== ""
+                && !/^:\d+$/u.test(authority.slice(closingBracket + 1)))) {
+            return undefined;
+        }
+    }
+    else {
+        const firstColon = authority.indexOf(":");
+        if (firstColon !== -1
+            && (firstColon !== authority.lastIndexOf(":")
+                || !/^\d+$/u.test(authority.slice(firstColon + 1)))) {
+            return undefined;
+        }
+    }
+    try {
+        const url = new URL(value);
+        if ((url.protocol !== "http:" && url.protocol !== "https:")
+            || url.hostname === ""
+            || url.username !== ""
+            || url.password !== "") {
+            return undefined;
+        }
+        return url.origin;
+    }
+    catch {
+        return undefined;
+    }
+}
+function isPort(value) {
+    return typeof value === "number" && Number.isInteger(value) && value >= 1 && value <= 65_535;
+}
+function canonicalConfig(config) {
+    const host = config.http?.host;
+    const port = config.http?.port;
+    const origins = config.http?.origins;
+    return {
+        ...(config.storage === undefined ? {} : { storage: config.storage }),
+        ...(host === undefined && port === undefined && origins === undefined
+            ? {}
+            : {
+                http: {
+                    ...(host === undefined ? {} : { host }),
+                    ...(port === undefined ? {} : { port }),
+                    ...(origins === undefined ? {} : { origins }),
+                },
+            }),
+    };
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,10 @@
+/** Mounts Autofile's transport-independent MCP server on Node's HTTP server. */
+import { type HttpSettings } from "./config.js";
+import type { Store } from "./store.js";
+export interface RunningHttpServer {
+    endpoint: URL;
+    closed: Promise<void>;
+    close(): Promise<void>;
+}
+/** Starts one modern-only Streamable HTTP endpoint around a process-shared store. */
+export declare function startHttpServer(store: Store, dataFolder: string, settings: HttpSettings, onError: (error: Error) => void): Promise<RunningHttpServer>;

package/dist/http.js

@@ -0,0 +1,152 @@
+/** Mounts Autofile's transport-independent MCP server on Node's HTTP server. */
+import { createServer } from "node:http";
+import { toNodeHandler } from "@modelcontextprotocol/node";
+import { createMcpHandler } from "@modelcontextprotocol/server";
+import { normalizeHttpOrigin } from "./config.js";
+import { buildServer } from "./server.js";
+import { resourceNotificationUris, watchStore } from "./watch.js";
+const MAX_REQUEST_BODY_BYTES = 64 * 1024 * 1024;
+const CORS_ALLOW_HEADERS = "Content-Type, MCP-Protocol-Version, Mcp-Method, Mcp-Name";
+/** Starts one modern-only Streamable HTTP endpoint around a process-shared store. */
+export async function startHttpServer(store, dataFolder, settings, onError) {
+    const handler = createMcpHandler(() => buildServer(store), {
+        legacy: "reject",
+        maxRequestBodySize: MAX_REQUEST_BODY_BYTES,
+        onerror: onError,
+    });
+    const watcher = await watchStore(dataFolder, store, (batch) => {
+        const uris = new Set(batch.changes.flatMap(({ uri }) => resourceNotificationUris(uri)));
+        for (const uri of uris) {
+            handler.notify.resourceUpdated(uri);
+        }
+        if (batch.listChanged)
+            handler.notify.resourcesChanged();
+    }, onError);
+    const serveMcp = toNodeHandler(handler, { maxRequestBodySize: MAX_REQUEST_BODY_BYTES });
+    const allowedOrigins = new Set(settings.origins);
+    const allowedHosts = new Set([
+        "localhost",
+        "127.0.0.1",
+        "[::1]",
+        ...settings.origins.map((origin) => new URL(origin).hostname.toLowerCase()),
+    ]);
+    const httpServer = createServer((request, response) => {
+        void routeRequest(request, response, allowedOrigins, allowedHosts, serveMcp);
+    });
+    const closed = new Promise((resolveClosed) => httpServer.once("close", resolveClosed));
+    try {
+        await new Promise((resolveListening, reject) => {
+            const onError = (error) => reject(error);
+            httpServer.once("error", onError);
+            httpServer.listen(settings.port, settings.host, () => {
+                httpServer.off("error", onError);
+                resolveListening();
+            });
+        });
+    }
+    catch (error) {
+        await Promise.all([watcher.close(), handler.close()]);
+        throw error;
+    }
+    const endpoint = new URL(`http://${urlHost(settings.host)}:${settings.port}/mcp`);
+    let closing;
+    return {
+        endpoint,
+        closed,
+        close() {
+            closing ??= closeHttpServer();
+            return closing;
+        },
+    };
+    async function closeHttpServer() {
+        httpServer.close();
+        httpServer.closeAllConnections();
+        await Promise.all([watcher.close(), handler.close(), closed]);
+    }
+}
+async function routeRequest(request, response, allowedOrigins, allowedHosts, serveMcp) {
+    if (!isAllowedHost(request.headers.host, allowedHosts)) {
+        refuse(response, 403, "Forbidden\n");
+        return;
+    }
+    const origin = request.headers.origin;
+    if (origin !== undefined && !isAllowedOrigin(origin, allowedOrigins)) {
+        refuse(response, 403, "Forbidden\n");
+        return;
+    }
+    if (requestPath(request) !== "/mcp") {
+        refuse(response, 404, "Not Found\n");
+        return;
+    }
+    if (origin !== undefined)
+        setCorsHeaders(response, origin);
+    if (request.method === "OPTIONS") {
+        response.setHeader("Connection", "close");
+        response.writeHead(204, {
+            "Access-Control-Allow-Methods": "POST, OPTIONS",
+            "Access-Control-Allow-Headers": CORS_ALLOW_HEADERS,
+        }).end();
+        return;
+    }
+    await serveMcp(request, response);
+}
+function requestPath(request) {
+    try {
+        return new URL(request.url ?? "", "http://autofile.local").pathname;
+    }
+    catch {
+        return undefined;
+    }
+}
+function isAllowedOrigin(origin, allowedOrigins) {
+    const normalized = normalizeHttpOrigin(origin);
+    if (normalized === undefined)
+        return false;
+    const hostname = new URL(normalized).hostname.toLowerCase();
+    return hostname === "localhost"
+        || hostname === "127.0.0.1"
+        || hostname === "[::1]"
+        || allowedOrigins.has(normalized);
+}
+function isAllowedHost(host, allowedHosts) {
+    const hostname = host === undefined ? undefined : hostHeaderName(host);
+    return hostname !== undefined && allowedHosts.has(hostname);
+}
+function hostHeaderName(host) {
+    if (host === "" || host.trim() !== host || /[\s/\\?#@,]/u.test(host))
+        return undefined;
+    if (host.startsWith("[")) {
+        const closingBracket = host.indexOf("]");
+        if (closingBracket <= 1
+            || (host.slice(closingBracket + 1) !== ""
+                && !/^:\d+$/u.test(host.slice(closingBracket + 1)))) {
+            return undefined;
+        }
+    }
+    else {
+        const firstColon = host.indexOf(":");
+        if (firstColon !== -1
+            && (firstColon !== host.lastIndexOf(":")
+                || !/^\d+$/u.test(host.slice(firstColon + 1)))) {
+            return undefined;
+        }
+    }
+    try {
+        return new URL(`http://${host}`).hostname.toLowerCase();
+    }
+    catch {
+        return undefined;
+    }
+}
+function refuse(response, status, body) {
+    response.setHeader("Connection", "close");
+    response.writeHead(status).end(body);
+}
+function setCorsHeaders(response, origin) {
+    response.setHeader("Access-Control-Allow-Origin", origin);
+    response.setHeader("Vary", "Origin");
+}
+function urlHost(host) {
+    return host.includes(":") && !host.startsWith("[") ? `[${host}]` : host;
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,OAAO,EAAE,YAAY,EAA6C,MAAM,WAAW,CAAC;AAEpF,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EAAE,mBAAmB,EAAqB,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAElE,MAAM,sBAAsB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAChD,MAAM,kBAAkB,GAAG,0DAA0D,CAAC;AAQtF,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAY,EACZ,UAAkB,EAClB,QAAsB,EACtB,OAA+B;IAE/B,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE;QACzD,MAAM,EAAE,QAAQ;QAChB,kBAAkB,EAAE,sBAAsB;QAC1C,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE;QAC5D,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACxF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,KAAK,CAAC,WAAW;YAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;IAC3D,CAAC,EAAE,OAAO,CAAC,CAAC;IACZ,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,EAAE,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,CAAC,CAAC;IACxF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;QAC3B,WAAW;QACX,WAAW;QACX,OAAO;QACP,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;KAC5E,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,YAAY,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;QACpD,KAAK,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,OAAO,CAAO,CAAC,aAAa,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;IAE7F,IAAI,CAAC;QACH,MAAM,IAAI,OAAO,CAAO,CAAC,gBAAgB,EAAE,MAAM,EAAE,EAAE;YACnD,MAAM,OAAO,GAAG,CAAC,KAAY,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAChD,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAClC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE;gBACnD,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACjC,gBAAgB,EAAE,CAAC;YACrB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACtD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,UAAU,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,MAAM,CAAC,CAAC;IAClF,IAAI,OAAkC,CAAC;IACvC,OAAO;QACL,QAAQ;QACR,MAAM;QACN,KAAK;YACH,OAAO,KAAK,eAAe,EAAE,CAAC;YAC9B,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;IAEF,KAAK,UAAU,eAAe;QAC5B,UAAU,CAAC,KAAK,EAAE,CAAC;QACnB,UAAU,CAAC,mBAAmB,EAAE,CAAC;QACjC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,OAAwB,EACxB,QAAwB,EACxB,cAAmC,EACnC,YAAiC,EACjC,QAA0C;IAE1C,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC;QACvD,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;QACrC,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;IACtC,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,CAAC;QACrE,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;QACrC,OAAO;IACT,CAAC;IACD,IAAI,WAAW,CAAC,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC;QACpC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;QACrC,OAAO;IACT,CAAC;IACD,IAAI,MAAM,KAAK,SAAS;QAAE,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE3D,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,QAAQ,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC1C,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE;YACtB,8BAA8B,EAAE,eAAe;YAC/C,8BAA8B,EAAE,kBAAkB;SACnD,CAAC,CAAC,GAAG,EAAE,CAAC;QACT,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,WAAW,CAAC,OAAwB;IAC3C,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,uBAAuB,CAAC,CAAC,QAAQ,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,MAAc,EAAE,cAAmC;IAC1E,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC5D,OAAO,QAAQ,KAAK,WAAW;WAC1B,QAAQ,KAAK,WAAW;WACxB,QAAQ,KAAK,OAAO;WACpB,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,aAAa,CAAC,IAAwB,EAAE,YAAiC;IAChF,MAAM,QAAQ,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IACvE,OAAO,QAAQ,KAAK,SAAS,IAAI,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACvF,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACzC,IACE,cAAc,IAAI,CAAC;eAChB,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,KAAK,EAAE;mBACpC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,EACrD,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,IACE,UAAU,KAAK,CAAC,CAAC;eACd,CAAC,UAAU,KAAK,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;mBACnC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,EAChD,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,QAAwB,EAAE,MAAc,EAAE,IAAY;IACpE,QAAQ,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,cAAc,CAAC,QAAwB,EAAE,MAAc;IAC9D,QAAQ,CAAC,SAAS,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;IAC1D,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1E,CAAC"}

package/dist/json.d.ts

@@ -0,0 +1,9 @@
+/** Shared compile-time types for the plain JSON crossing store boundaries. */
+/** A scalar JSON value. */
+export type JsonPrimitive = string | number | boolean | null;
+/** Any value representable in JSON. */
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+/** A JSON object with string keys. */
+export interface JsonObject {
+    [key: string]: JsonValue;
+}

package/dist/json.js

@@ -0,0 +1,3 @@
+/** Shared compile-time types for the plain JSON crossing store boundaries. */
+export {};
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA,8EAA8E"}

package/dist/schema.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Registers and checks Autofile's JSON Schemas with the explicitly selected
+ * 2020-12 dialect. The registry is process-global, so schemas are addressed by
+ * content and compiled once even when several store instances read them.
+ */
+import "@hyperjump/json-schema/formats";
+import type { JsonObject, JsonValue } from "./json.js";
+/** A compiled schema that returns all readable validation problems. */
+export interface PreparedSchema {
+    validate(value: JsonValue): Promise<string[]>;
+    formatFields(value: JsonValue, format: "uri" | "blob"): FormatField[];
+}
+/** One instance value reached by a schema's `format` annotation. */
+export interface FormatField {
+    pointer: string;
+    location: string;
+    value: JsonValue;
+}
+/** Checks that a declaration schema is safe, valid 2020-12 JSON Schema. */
+export declare function prepareSchema(schema: JsonObject): Promise<PreparedSchema>;
+/** A user-correctable problem in a proposed schema declaration. */
+export declare class SchemaRefusal extends Error {
+    readonly messages: string[];
+    constructor(messages: string[]);
+}