@struktoai/mirage-browser 0.0.5 → 0.0.7-alpha.1

package/dist/resource/opfs/opfs.js

@@ -0,0 +1,236 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { makeResolveGlob } from '@struktoai/mirage-core/commands/builtin/generic_bind/index';
+import { BaseResource } from '@struktoai/mirage-core/resource/base';
+import { ResourceName } from '@struktoai/mirage-core/types';
+import { lstripSlash } from '@struktoai/mirage-core/utils/slash';
+import { compareCodePoints } from '@struktoai/mirage-core/utils/sort';
+import { OPFSAccessor } from "../../accessor/opfs.js";
+import { OPFS_COMMANDS } from "../../commands/builtin/opfs/index.js";
+import { appendBytes as appendCore } from "../../core/opfs/append.js";
+import { SCOPE_ERROR } from "../../core/opfs/constants.js";
+import { copy as copyCore } from "../../core/opfs/copy.js";
+import { size as duSizeCore } from "../../core/opfs/du/index.js";
+import { exists as existsCore } from "../../core/opfs/exists.js";
+import { find as findCore } from "../../core/opfs/find.js";
+import { mkdir as mkdirCore } from "../../core/opfs/mkdir.js";
+import { read as readCoreFn } from "../../core/opfs/read.js";
+import { readdir as readdirCore } from "../../core/opfs/readdir.js";
+import { rename as renameCore } from "../../core/opfs/rename.js";
+import { rmR as rmRCore } from "../../core/opfs/rm.js";
+import { rmdir as rmdirCore } from "../../core/opfs/rmdir.js";
+import { stat as statCore } from "../../core/opfs/stat.js";
+import { stream as streamCore } from "../../core/opfs/stream.js";
+import { truncate as truncateCore } from "../../core/opfs/truncate.js";
+import { unlink as unlinkCore } from "../../core/opfs/unlink.js";
+import { iterEntries, toWritableChunk } from "../../core/opfs/utils.js";
+import { writeBytes as writeCore } from "../../core/opfs/write.js";
+import { OPFS_OPS } from "../../ops/opfs/index.js";
+import { OPFS_PROMPT } from "./prompt.js";
+const globCore = makeResolveGlob(readdirCore, SCOPE_ERROR);
+async function walkFiles(dir, currentPath, files) {
+    for await (const [name, handle] of iterEntries(dir)) {
+        const childPath = currentPath === '' ? name : `${currentPath}/${name}`;
+        if (handle.kind === 'file') {
+            const fh = await dir.getFileHandle(name, { create: false });
+            const file = await fh.getFile();
+            files[childPath] = new Uint8Array(await file.arrayBuffer());
+        }
+        else {
+            const child = await dir.getDirectoryHandle(name, { create: false });
+            await walkFiles(child, childPath, files);
+        }
+    }
+}
+async function walkDirs(dir, currentPath, dirs) {
+    for await (const [name, handle] of iterEntries(dir)) {
+        if (handle.kind !== 'directory')
+            continue;
+        const childPath = currentPath === '' ? `/${name}` : `${currentPath}/${name}`;
+        dirs.push(childPath);
+        const child = await dir.getDirectoryHandle(name, { create: false });
+        await walkDirs(child, childPath, dirs);
+    }
+}
+async function splitAndCreate(root, relativePath) {
+    let handle = root;
+    for (const seg of relativePath.split('/')) {
+        if (seg === '' || seg === '.')
+            continue;
+        handle = await handle.getDirectoryHandle(seg, { create: true });
+    }
+    return handle;
+}
+export class OPFSResource extends BaseResource {
+    kind = ResourceName.OPFS;
+    // OPFS is a real filesystem: getFile().size is the exact byte count a
+    // read returns.
+    sizesAlwaysKnown = true;
+    prompt = OPFS_PROMPT;
+    rootName;
+    accessor;
+    rootHandle = null;
+    openPromise = null;
+    constructor(options = {}) {
+        super();
+        this.rootName = options.root ?? '';
+        this.accessor = new OPFSAccessor(this);
+    }
+    open() {
+        return this.ensureOpen().then(() => undefined);
+    }
+    async close() {
+        this.rootHandle = null;
+        this.openPromise = null;
+        await super.close();
+    }
+    /**
+     * Lazily resolve to a usable root handle. Memoizes `navigator.storage`
+     * traversal so the resource self-initializes on first method call without
+     * relying on an external orchestrator.
+     */
+    ensureOpen() {
+        if (this.rootHandle !== null)
+            return Promise.resolve(this.rootHandle);
+        this.openPromise ??= (async () => {
+            const origin = await navigator.storage.getDirectory();
+            let handle = origin;
+            for (const seg of this.rootName.split('/')) {
+                if (seg === '' || seg === '.')
+                    continue;
+                handle = await handle.getDirectoryHandle(seg, { create: true });
+            }
+            this.rootHandle = handle;
+            return handle;
+        })();
+        return this.openPromise;
+    }
+    requireHandle() {
+        if (this.rootHandle === null) {
+            throw new Error('OPFSResource is not open — call open() first');
+        }
+        return this.rootHandle;
+    }
+    ops() {
+        return OPFS_OPS;
+    }
+    commands() {
+        return OPFS_COMMANDS;
+    }
+    async *streamPath(p) {
+        await this.ensureOpen();
+        yield* streamCore(this.accessor, p);
+    }
+    async readFile(p) {
+        await this.ensureOpen();
+        return readCoreFn(this.accessor, p);
+    }
+    async writeFile(p, data) {
+        await this.ensureOpen();
+        return writeCore(this.accessor, p, data);
+    }
+    async appendFile(p, data) {
+        await this.ensureOpen();
+        return appendCore(this.accessor, p, data);
+    }
+    async readdir(p) {
+        await this.ensureOpen();
+        return readdirCore(this.accessor, p);
+    }
+    async stat(p) {
+        await this.ensureOpen();
+        return statCore(this.accessor, p);
+    }
+    async exists(p) {
+        await this.ensureOpen();
+        return existsCore(this.accessor, p);
+    }
+    async mkdir(p, options) {
+        await this.ensureOpen();
+        return mkdirCore(this.accessor, p, options?.recursive === true);
+    }
+    async rmdir(p) {
+        await this.ensureOpen();
+        return rmdirCore(this.accessor, p);
+    }
+    async unlink(p) {
+        await this.ensureOpen();
+        return unlinkCore(this.accessor, p);
+    }
+    async rename(src, dst) {
+        await this.ensureOpen();
+        return renameCore(this.accessor, src, dst);
+    }
+    async truncate(p, length) {
+        await this.ensureOpen();
+        return truncateCore(this.accessor, p, length);
+    }
+    async copy(src, dst) {
+        await this.ensureOpen();
+        return copyCore(this.accessor, src, dst);
+    }
+    async rmR(p) {
+        await this.ensureOpen();
+        return rmRCore(this.accessor, p);
+    }
+    async du(p) {
+        await this.ensureOpen();
+        return duSizeCore(this.accessor, p);
+    }
+    async find(p, options = {}) {
+        await this.ensureOpen();
+        return findCore(this.accessor, p, options);
+    }
+    async glob(paths) {
+        await this.ensureOpen();
+        return globCore(this.accessor, paths);
+    }
+    async getState() {
+        const handle = await this.ensureOpen();
+        const files = {};
+        await walkFiles(handle, '', files);
+        const dirs = [];
+        await walkDirs(handle, '', dirs);
+        dirs.sort(compareCodePoints);
+        return {
+            type: this.kind,
+            files,
+            dirs,
+        };
+    }
+    async loadState(state) {
+        const handle = await this.ensureOpen();
+        for (const dir of state.dirs) {
+            const rel = lstripSlash(dir);
+            if (rel === '')
+                continue;
+            await splitAndCreate(handle, rel);
+        }
+        for (const [rel, data] of Object.entries(state.files)) {
+            const segs = rel.split('/').filter((s) => s !== '' && s !== '.');
+            const fileName = segs.pop();
+            if (fileName === undefined)
+                continue;
+            let dir = handle;
+            for (const seg of segs) {
+                dir = await dir.getDirectoryHandle(seg, { create: true });
+            }
+            const fh = await dir.getFileHandle(fileName, { create: true });
+            const writable = await fh.createWritable();
+            await writable.write(toWritableChunk(data));
+            await writable.close();
+        }
+    }
+}
+//# sourceMappingURL=opfs.js.map

package/dist/resource/opfs/opfs.js.map

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

package/dist/resource/opfs/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const OPFS_PROMPT = "{prefix}\n  Browser Origin Private File System. Persistent per-origin storage that survives page reloads.\n  Standard commands: ls, cat, head, tail, grep, wc, find, tree, mkdir, touch, cp, mv, rm, tee.";
+//# sourceMappingURL=prompt.d.ts.map

package/dist/resource/opfs/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/resource/opfs/prompt.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,WAAW,8MAEuE,CAAA"}

package/dist/resource/opfs/prompt.js

@@ -0,0 +1,17 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+export const OPFS_PROMPT = `{prefix}
+  Browser Origin Private File System. Persistent per-origin storage that survives page reloads.
+  Standard commands: ls, cat, head, tail, grep, wc, find, tree, mkdir, touch, cp, mv, rm, tee.`;
+//# sourceMappingURL=prompt.js.map

package/dist/resource/opfs/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/resource/opfs/prompt.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,MAAM,CAAC,MAAM,WAAW,GAAG;;+FAEoE,CAAA"}

package/dist/resource/postgres/neon_driver.d.ts

@@ -0,0 +1,8 @@
+import type { PgDriver, PgQueryResult } from '@struktoai/mirage-core/core/postgres/_driver';
+export declare class NeonPgDriver implements PgDriver {
+    private readonly sql;
+    constructor(dsn: string);
+    query<R = Record<string, unknown>>(text: string, params?: readonly unknown[]): Promise<PgQueryResult<R>>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=neon_driver.d.ts.map

package/dist/resource/postgres/neon_driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neon_driver.d.ts","sourceRoot":"","sources":["../../../src/resource/postgres/neon_driver.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAA;AAO3F,qBAAa,YAAa,YAAW,QAAQ;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgC;gBAExC,GAAG,EAAE,MAAM;IAIjB,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAC1B,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAQ5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAGvB"}

package/dist/resource/postgres/neon_driver.js

@@ -0,0 +1,28 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { neon } from '@neondatabase/serverless';
+export class NeonPgDriver {
+    sql;
+    constructor(dsn) {
+        this.sql = neon(dsn, { fullResults: true });
+    }
+    async query(text, params) {
+        const result = (await this.sql.query(text, params));
+        return { rows: result.rows, rowCount: result.rowCount ?? result.rows.length };
+    }
+    close() {
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=neon_driver.js.map

package/dist/resource/postgres/neon_driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neon_driver.js","sourceRoot":"","sources":["../../../src/resource/postgres/neon_driver.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EAAE,IAAI,EAA0B,MAAM,0BAA0B,CAAA;AAQvE,MAAM,OAAO,YAAY;IACN,GAAG,CAAgC;IAEpD,YAAY,GAAW;QACrB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7C,CAAC;IAED,KAAK,CAAC,KAAK,CACT,IAAY,EACZ,MAA2B;QAE3B,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAClC,IAAI,EACJ,MAA+B,CAChC,CAAiC,CAAA;QAClC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAA;IAC/E,CAAC;IAED,KAAK;QACH,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAC1B,CAAC;CACF"}

package/dist/resource/postgres/postgres.d.ts

@@ -0,0 +1,40 @@
+import { PostgresAccessor } from '@struktoai/mirage-core/accessor/postgres';
+import type { RegisteredCommand } from '@struktoai/mirage-core/commands/config';
+import type { PgDriver } from '@struktoai/mirage-core/core/postgres/_driver';
+import type { RegisteredOp } from '@struktoai/mirage-core/ops/registry';
+import { BaseResource } from '@struktoai/mirage-core/resource/base';
+import type { Resource } from '@struktoai/mirage-core/resource/base';
+import type { PostgresConfig, PostgresConfigRedacted, PostgresConfigResolved } from '@struktoai/mirage-core/resource/postgres/config';
+import { PathSpec } from '@struktoai/mirage-core/types';
+import type { FileStat } from '@struktoai/mirage-core/types';
+export interface PostgresResourceOptions {
+    config: PostgresConfig;
+    prefix?: string;
+    driver?: PgDriver;
+}
+export interface PostgresResourceState {
+    type: string;
+    config: PostgresConfigRedacted;
+    needs_override: true;
+}
+export declare class PostgresResource extends BaseResource implements Resource {
+    readonly kind: string;
+    readonly cachesReads: boolean;
+    readonly indexTtl: number;
+    readonly prompt: string;
+    readonly config: PostgresConfigResolved;
+    readonly driver: PgDriver;
+    readonly accessor: PostgresAccessor;
+    constructor(options: PostgresResourceOptions | PostgresConfig);
+    getState(): PostgresResourceState;
+    loadState(_state: PostgresResourceState): Promise<void>;
+    open(): Promise<void>;
+    close(): Promise<void>;
+    ops(): readonly RegisteredOp[];
+    commands(): readonly RegisteredCommand[];
+    readFile(p: PathSpec): Promise<Uint8Array>;
+    readdir(p: PathSpec): Promise<string[]>;
+    stat(p: PathSpec): Promise<FileStat>;
+    glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
+}
+//# sourceMappingURL=postgres.d.ts.map

package/dist/resource/postgres/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../../src/resource/postgres/postgres.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAA;AAG3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAC/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8CAA8C,CAAA;AAK5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAA;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAA;AAKpE,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,iDAAiD,CAAA;AAExD,OAAO,EAAE,QAAQ,EAAgB,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAM5D,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,cAAc,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,QAAQ,CAAA;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,sBAAsB,CAAA;IAC9B,cAAc,EAAE,IAAI,CAAA;CACrB;AAED,qBAAa,gBAAiB,SAAQ,YAAa,YAAW,QAAQ;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAwB;IAC7C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAQ;IACrC,SAAkB,QAAQ,EAAE,MAAM,CAAI;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;gBAEvB,OAAO,EAAE,uBAAuB,GAAG,cAAc;IAUpD,QAAQ,IAAI,qBAAqB;IAejC,SAAS,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIN,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrC,GAAG,IAAI,SAAS,YAAY,EAAE;IAI9B,QAAQ,IAAI,SAAS,iBAAiB,EAAE;IAIxC,QAAQ,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAI1C,OAAO,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIvC,IAAI,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIpC,IAAI,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAAE,MAAM,SAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAiBnE"}

package/dist/resource/postgres/postgres.js

@@ -0,0 +1,98 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { PostgresAccessor } from '@struktoai/mirage-core/accessor/postgres';
+import { makeResolveGlob } from '@struktoai/mirage-core/commands/builtin/generic_bind/index';
+import { POSTGRES_COMMANDS } from '@struktoai/mirage-core/commands/builtin/postgres/index';
+import { read as postgresRead } from '@struktoai/mirage-core/core/postgres/read';
+import { readdir as postgresReaddir } from '@struktoai/mirage-core/core/postgres/readdir';
+import { stat as postgresStat } from '@struktoai/mirage-core/core/postgres/stat';
+import { POSTGRES_OPS } from '@struktoai/mirage-core/ops/postgres/index';
+import { BaseResource } from '@struktoai/mirage-core/resource/base';
+import { redactPostgresConfig, resolvePostgresConfig, } from '@struktoai/mirage-core/resource/postgres/config';
+import { POSTGRES_PROMPT } from '@struktoai/mirage-core/resource/postgres/prompt';
+import { PathSpec, ResourceName } from '@struktoai/mirage-core/types';
+import { mountKey, mountPrefixOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { NeonPgDriver } from "./neon_driver.js";
+const resolvePostgresGlob = makeResolveGlob(postgresReaddir);
+export class PostgresResource extends BaseResource {
+    kind = ResourceName.POSTGRES;
+    cachesReads = false;
+    indexTtl = 0;
+    prompt;
+    config;
+    driver;
+    accessor;
+    constructor(options) {
+        super();
+        const { config, prefix, driver } = 'config' in options ? options : { config: options, prefix: undefined, driver: undefined };
+        this.config = resolvePostgresConfig(config);
+        this.driver = driver ?? new NeonPgDriver(this.config.dsn);
+        this.accessor = new PostgresAccessor(this.driver, this.config);
+        this.prompt = POSTGRES_PROMPT.replace('{prefix}', prefix ?? '');
+    }
+    getState() {
+        return {
+            type: this.kind,
+            config: redactPostgresConfig(this.config),
+            // TypeScript cannot rebuild a config-backed mount from state:
+            // `buildMountArgs` substitutes a RAMResource for anything it was
+            // not handed. Saying so out loud turns a silently empty mount
+            // into a refusal to load. Python rebuilds via its registry, so it
+            // writes this on only four resources and reads it nowhere.
+            needs_override: true,
+        };
+    }
+    // The rows live in the database, so a restored mount reaches them
+    // through its config alone — there is nothing to take back.
+    loadState(_state) {
+        return Promise.resolve();
+    }
+    open() {
+        return Promise.resolve();
+    }
+    async close() {
+        await this.driver.close();
+        await super.close();
+    }
+    ops() {
+        return POSTGRES_OPS;
+    }
+    commands() {
+        return POSTGRES_COMMANDS;
+    }
+    readFile(p) {
+        return postgresRead(this.accessor, p, this.index);
+    }
+    readdir(p) {
+        return postgresReaddir(this.accessor, p, this.index);
+    }
+    stat(p) {
+        return postgresStat(this.accessor, p, this.index);
+    }
+    glob(paths, prefix = '') {
+        const effective = prefix !== ''
+            ? paths.map((p) => mountPrefixOf(p.virtual, p.resourcePath) !== ''
+                ? p
+                : new PathSpec({
+                    virtual: p.virtual,
+                    directory: p.directory,
+                    ...(p.pattern !== null ? { pattern: p.pattern } : {}),
+                    resolved: p.resolved,
+                    resourcePath: mountKey(p.virtual, prefix),
+                }))
+            : paths;
+        return resolvePostgresGlob(this.accessor, effective, this.index);
+    }
+}
+//# sourceMappingURL=postgres.js.map

package/dist/resource/postgres/postgres.js.map

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

package/dist/resource/qingstor/config.d.ts

@@ -0,0 +1,17 @@
+import type { ConfigOf, RedactedConfig } from '@struktoai/mirage-core/resource/secrets';
+declare const QingStorConfigSchema: import("zod").ZodObject<{
+    bucket: import("zod").ZodString;
+    presignedUrlProvider: import("zod").ZodCustom<import("@struktoai/mirage-core/resource/s3/config").S3BrowserPresignedUrlProvider, import("@struktoai/mirage-core/resource/s3/config").S3BrowserPresignedUrlProvider>;
+    region: import("zod").ZodOptional<import("zod").ZodString>;
+    endpoint: import("zod").ZodOptional<import("zod").ZodString>;
+    defaultContentType: import("zod").ZodOptional<import("zod").ZodString>;
+    keyPrefix: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>;
+export type QingStorConfig = ConfigOf<typeof QingStorConfigSchema>;
+export type QingStorConfigRedacted = RedactedConfig<QingStorConfig, 'presignedUrlProvider'>;
+export declare const resolvedQingStorEndpoint: (config: QingStorConfig) => string | undefined;
+export declare const qingStorToS3Config: (config: QingStorConfig) => import("@struktoai/mirage-core/resource/s3/config").S3Config;
+export declare const redactQingStorConfig: (config: QingStorConfig) => QingStorConfigRedacted;
+export declare const normalizeQingStorConfig: (input: Record<string, unknown>) => QingStorConfig;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/resource/qingstor/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/resource/qingstor/config.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAA;AAGvF,QAAA,MAAM,oBAAoB;;;;;;;gCAAyB,CAAA;AAEnD,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAElE,MAAM,MAAM,sBAAsB,GAAG,cAAc,CAAC,cAAc,EAAE,sBAAsB,CAAC,CAAA;AAO3F,eAAO,MAAM,wBAAwB,gDAAyB,CAAA;AAC9D,eAAO,MAAM,kBAAkB,0FAAmB,CAAA;AAClD,eAAO,MAAM,oBAAoB,oDAAe,CAAA;AAChD,eAAO,MAAM,uBAAuB,oDAAkB,CAAA"}

package/dist/resource/qingstor/config.js

@@ -0,0 +1,24 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { browserAliasSchema, derivedEndpoint, makeBrowserS3Alias } from "../s3_alias.js";
+const QingStorConfigSchema = browserAliasSchema({});
+const alias = makeBrowserS3Alias({
+    schema: QingStorConfigSchema,
+    endpointFor: derivedEndpoint('region', (region) => `https://s3.${region}.qingstor.com`),
+});
+export const resolvedQingStorEndpoint = alias.resolvedEndpoint;
+export const qingStorToS3Config = alias.toS3Config;
+export const redactQingStorConfig = alias.redact;
+export const normalizeQingStorConfig = alias.normalize;
+//# sourceMappingURL=config.js.map

package/dist/resource/qingstor/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/resource/qingstor/config.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAGvE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAExF,MAAM,oBAAoB,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAA;AAMnD,MAAM,KAAK,GAAG,kBAAkB,CAAyC;IACvE,MAAM,EAAE,oBAAoB;IAC5B,WAAW,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,MAAM,eAAe,CAAC;CACxF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,CAAC,gBAAgB,CAAA;AAC9D,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC,UAAU,CAAA;AAClD,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC,MAAM,CAAA;AAChD,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC,SAAS,CAAA"}

package/dist/resource/qingstor/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const QINGSTOR_BROWSER_PROMPT = "{prefix}\n  Remote QingStor bucket (S3-compatible) accessed via presigned URLs (browser runtime).\n  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.\n  Listing operations require the presigner to sign LIST/COPY operations in\n  addition to GET/PUT/HEAD/DELETE \u2014 see S3BrowserPresignedUrlProvider docs.";
+//# sourceMappingURL=prompt.d.ts.map

package/dist/resource/qingstor/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/resource/qingstor/prompt.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,uBAAuB,wVAIwC,CAAA"}

package/dist/resource/qingstor/prompt.js

@@ -0,0 +1,19 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+export const QINGSTOR_BROWSER_PROMPT = `{prefix}
+  Remote QingStor bucket (S3-compatible) accessed via presigned URLs (browser runtime).
+  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.
+  Listing operations require the presigner to sign LIST/COPY operations in
+  addition to GET/PUT/HEAD/DELETE — see S3BrowserPresignedUrlProvider docs.`;
+//# sourceMappingURL=prompt.js.map

package/dist/resource/qingstor/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/resource/qingstor/prompt.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;4EAIqC,CAAA"}

package/dist/resource/qingstor/qingstor.d.ts

@@ -0,0 +1,8 @@
+import { S3AliasResource, type S3AliasResourceState } from '../s3_alias.ts';
+import { type QingStorConfig, type QingStorConfigRedacted } from './config.ts';
+export type QingStorResourceState = S3AliasResourceState<QingStorConfigRedacted>;
+export declare class QingStorResource extends S3AliasResource<QingStorConfig, QingStorConfigRedacted> {
+    readonly prompt: string;
+    constructor(config: QingStorConfig);
+}
+//# sourceMappingURL=qingstor.d.ts.map

package/dist/resource/qingstor/qingstor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qingstor.d.ts","sourceRoot":"","sources":["../../../src/resource/qingstor/qingstor.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAC3E,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC5B,MAAM,aAAa,CAAA;AAGpB,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,CAAC,sBAAsB,CAAC,CAAA;AAEhF,qBAAa,gBAAiB,SAAQ,eAAe,CAAC,cAAc,EAAE,sBAAsB,CAAC;IAC3F,SAAkB,MAAM,EAAE,MAAM,CAA0B;gBAE9C,MAAM,EAAE,cAAc;CAGnC"}

package/dist/resource/qingstor/qingstor.js

@@ -0,0 +1,24 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { ResourceName } from '@struktoai/mirage-core/types';
+import { S3AliasResource } from "../s3_alias.js";
+import { qingStorToS3Config, redactQingStorConfig, } from "./config.js";
+import { QINGSTOR_BROWSER_PROMPT } from "./prompt.js";
+export class QingStorResource extends S3AliasResource {
+    prompt = QINGSTOR_BROWSER_PROMPT;
+    constructor(config) {
+        super(ResourceName.QINGSTOR, config, qingStorToS3Config(config), redactQingStorConfig);
+    }
+}
+//# sourceMappingURL=qingstor.js.map

package/dist/resource/qingstor/qingstor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qingstor.js","sourceRoot":"","sources":["../../../src/resource/qingstor/qingstor.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,EAAE,eAAe,EAA6B,MAAM,gBAAgB,CAAA;AAC3E,OAAO,EACL,kBAAkB,EAClB,oBAAoB,GAGrB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAIrD,MAAM,OAAO,gBAAiB,SAAQ,eAAuD;IACzE,MAAM,GAAW,uBAAuB,CAAA;IAE1D,YAAY,MAAsB;QAChC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC,CAAA;IACxF,CAAC;CACF"}

package/dist/resource/r2/config.d.ts

@@ -0,0 +1,20 @@
+import { z } from '@struktoai/mirage-core/resource/secrets';
+import type { ConfigOf, RedactedConfig } from '@struktoai/mirage-core/resource/secrets';
+declare const R2ConfigSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    presignedUrlProvider: z.ZodCustom<import("@struktoai/mirage-core/resource/s3/config").S3BrowserPresignedUrlProvider, import("@struktoai/mirage-core/resource/s3/config").S3BrowserPresignedUrlProvider>;
+    region: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    defaultContentType: z.ZodOptional<z.ZodString>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+} & {
+    accountId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type R2Config = ConfigOf<typeof R2ConfigSchema>;
+export type R2ConfigRedacted = RedactedConfig<R2Config, 'presignedUrlProvider'>;
+export declare const resolvedR2Endpoint: (config: R2Config) => string | undefined;
+export declare const r2ToS3Config: (config: R2Config) => import("@struktoai/mirage-core/resource/s3/config").S3Config;
+export declare const redactR2Config: (config: R2Config) => R2ConfigRedacted;
+export declare const normalizeR2Config: (input: Record<string, unknown>) => R2Config;
+export {};
+//# sourceMappingURL=config.d.ts.map