@struktoai/mirage-node 0.0.7-alpha.1 → 0.0.7-alpha.3

package/dist/resource/redis/store.js

@@ -1,246 +0,0 @@
-// ========= 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 { escapeGlob } from '@struktoai/mirage-core/core/redis/utils';
-import { compareCodePoints } from '@struktoai/mirage-core/utils/sort';
-import { loadOptionalPeer } from "../../optional_peer.js";
-export class RedisStore {
-    url;
-    keyPrefix;
-    providedClient;
-    clientPromise = null;
-    constructor(options = {}) {
-        this.url = options.url ?? 'redis://localhost:6379/0';
-        this.keyPrefix = options.keyPrefix ?? 'mirage:fs:';
-        this.providedClient = options.client ?? null;
-    }
-    fk(path) {
-        return `${this.keyPrefix}file:${path}`;
-    }
-    dk() {
-        return `${this.keyPrefix}dir`;
-    }
-    mk(path) {
-        return `${this.keyPrefix}modified:${path}`;
-    }
-    ak(path) {
-        return `${this.keyPrefix}attrs:${path}`;
-    }
-    async client() {
-        if (this.providedClient !== null)
-            return this.providedClient;
-        this.clientPromise ??= (async () => {
-            const mod = await loadOptionalPeer(() => import('redis'), { feature: 'RedisResource / RedisFileCacheStore', packageName: 'redis' });
-            const c = mod.createClient({
-                url: this.url,
-                socket: { reconnectStrategy: false },
-            });
-            await c.connect();
-            await c.sAdd(this.dk(), '/');
-            return c;
-        })();
-        return this.clientPromise;
-    }
-    async open() {
-        await this.client();
-    }
-    async getFile(path) {
-        const c = await this.client();
-        const typed = c;
-        const mod = (await import('redis'));
-        const blob = mod.RESP_TYPES.BLOB_STRING;
-        const mapping = { [blob]: Buffer };
-        const raw = await typed.withTypeMapping(mapping).get(this.fk(path));
-        if (raw === null)
-            return null;
-        return new Uint8Array(raw.buffer, raw.byteOffset, raw.byteLength);
-    }
-    /**
-     * A byte window of a stored file, or null when the key is absent.
-     *
-     * `GETRANGE` slices server-side, so a window costs the window rather than
-     * the whole value on the wire. Its bounds are inclusive and `-1` means the
-     * last byte, which is how "to the end" is spelled.
-     *
-     * `EXISTS` rides along because `GETRANGE` answers an empty string for a
-     * missing key, for an empty file and for a window past the end alike;
-     * without it a read of a deleted path would return an empty buffer instead
-     * of throwing. The two are issued together rather than through `MULTI`,
-     * which drops the Buffer type mapping and hands back a lossy string:
-     * node-redis pipelines commands issued in the same tick, so this is still
-     * one round trip.
-     *
-     * @param path mount-relative path of the file
-     * @param offset first byte to read
-     * @param size how many bytes, or null for the rest
-     */
-    async getFileRange(path, offset, size) {
-        const c = await this.client();
-        const key = this.fk(path);
-        // GETRANGE 0 -1 means the whole value, not an empty window.
-        if (size === 0)
-            return (await c.exists(key)) === 0 ? null : new Uint8Array(0);
-        const mod = (await import('redis'));
-        const typed = c;
-        const mapping = { [mod.RESP_TYPES.BLOB_STRING]: Buffer };
-        const end = size === null ? -1 : offset + size - 1;
-        const [exists, raw] = await Promise.all([
-            typed.exists(key),
-            typed.withTypeMapping(mapping).getRange(key, offset, end),
-        ]);
-        if (exists === 0)
-            return null;
-        return new Uint8Array(raw.buffer, raw.byteOffset, raw.byteLength);
-    }
-    async setFile(path, data) {
-        const c = await this.client();
-        await c.set(this.fk(path), Buffer.from(data.buffer, data.byteOffset, data.byteLength));
-    }
-    async delFile(path) {
-        const c = await this.client();
-        await c.del(this.fk(path));
-    }
-    async hasFile(path) {
-        const c = await this.client();
-        return (await c.exists(this.fk(path))) > 0;
-    }
-    async listFiles(prefix = '') {
-        const c = await this.client();
-        const pattern = `${escapeGlob(`${this.keyPrefix}file:${prefix}`)}*`;
-        const strip = `${this.keyPrefix}file:`.length;
-        const result = [];
-        for await (const k of c.scanIterator({ MATCH: pattern })) {
-            const keys = Array.isArray(k) ? k : [k];
-            for (const key of keys)
-                result.push(key.slice(strip));
-        }
-        return result.sort(compareCodePoints);
-    }
-    async fileLen(path) {
-        const c = await this.client();
-        return c.strLen(this.fk(path));
-    }
-    async hasDir(path) {
-        const c = await this.client();
-        return (await c.sIsMember(this.dk(), path)) === 1;
-    }
-    async addDir(path) {
-        const c = await this.client();
-        await c.sAdd(this.dk(), path);
-    }
-    async removeDir(path) {
-        const c = await this.client();
-        await c.sRem(this.dk(), path);
-    }
-    async listDirs() {
-        const c = await this.client();
-        const members = await c.sMembers(this.dk());
-        return new Set(members);
-    }
-    async getModified(path) {
-        const c = await this.client();
-        return c.get(this.mk(path));
-    }
-    async setModified(path, ts) {
-        const c = await this.client();
-        await c.set(this.mk(path), ts);
-    }
-    async delModified(path) {
-        const c = await this.client();
-        await c.del(this.mk(path));
-    }
-    async getAttrs(path) {
-        const c = await this.client();
-        const raw = await c.hGetAll(this.ak(path));
-        return { ...raw };
-    }
-    async setAttrs(path, fields) {
-        const c = await this.client();
-        await c.hSet(this.ak(path), fields);
-    }
-    async delAttrs(path) {
-        const c = await this.client();
-        await c.del(this.ak(path));
-    }
-    async scanKeys(pattern) {
-        const c = await this.client();
-        const keys = [];
-        for await (const k of c.scanIterator({ MATCH: pattern })) {
-            if (Array.isArray(k))
-                keys.push(...k);
-            else
-                keys.push(k);
-        }
-        return keys;
-    }
-    async listAttrs() {
-        const c = await this.client();
-        const head = `${this.keyPrefix}attrs:`;
-        const out = {};
-        for (const key of await this.scanKeys(`${escapeGlob(head)}*`)) {
-            out[key.slice(head.length)] = { ...(await c.hGetAll(key)) };
-        }
-        return out;
-    }
-    async listModified() {
-        const c = await this.client();
-        const head = `${this.keyPrefix}modified:`;
-        const out = {};
-        for (const key of await this.scanKeys(`${escapeGlob(head)}*`)) {
-            const val = await c.get(key);
-            if (val !== null)
-                out[key.slice(head.length)] = val;
-        }
-        return out;
-    }
-    async restore(state) {
-        const c = await this.client();
-        const pipe = c.multi();
-        for (const [path, data] of Object.entries(state.files)) {
-            pipe.set(this.fk(path), Buffer.from(data.buffer, data.byteOffset, data.byteLength));
-        }
-        for (const dir of state.dirs)
-            pipe.sAdd(this.dk(), dir);
-        for (const [path, fields] of Object.entries(state.attrs)) {
-            if (Object.keys(fields).length > 0)
-                pipe.hSet(this.ak(path), fields);
-        }
-        for (const [path, ts] of Object.entries(state.modified))
-            pipe.set(this.mk(path), ts);
-        await pipe.exec();
-    }
-    async clear() {
-        const c = await this.client();
-        const p = escapeGlob(this.keyPrefix);
-        for (const pattern of [`${p}file:*`, `${p}tmp:*`, `${p}modified:*`, `${p}attrs:*`]) {
-            const keys = await this.scanKeys(pattern);
-            if (keys.length > 0)
-                await c.del(keys);
-        }
-        await c.del(this.dk());
-    }
-    async close() {
-        if (this.providedClient !== null)
-            return;
-        if (this.clientPromise === null)
-            return;
-        const c = await this.clientPromise;
-        const typed = c;
-        if (typeof typed.destroy === 'function')
-            typed.destroy();
-        else if (c.isOpen)
-            await c.quit();
-        this.clientPromise = null;
-    }
-}
-//# sourceMappingURL=store.js.map

package/dist/resource/redis/store.js.map

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

package/dist/resource/registry.d.ts

@@ -1,42 +0,0 @@
-import type { ResolvedSource } from '@struktoai/mirage-core/secrets/types';
-import type { Resource } from '@struktoai/mirage-core/resource/base';
-/**
- * Construct a resource by registry name. Mirrors Python's
- * `mirage.resource.registry.build_resource`.
- *
- * Each entry is an async factory that lazy-imports its module so that
- * importing this file doesn't pull in every backend's dependencies.
- * Only the resource you actually request gets loaded — important for
- * S3/Redis whose peer deps (`@aws-sdk/client-s3`, `redis`) are optional.
- *
- * Configs are normalized from Python-style snake_case (used in YAML and
- * by the Python `mirage.config` loader) to TS-idiomatic camelCase. So
- * the same YAML file works in both Python and TS.
- */
-export type ResourceFactory = (config: Record<string, unknown>) => Promise<Resource>;
-/**
- * Look up every constructible name: builtins plus whatever `register()`
- * has added.
- */
-export declare function knownResources(): string[];
-/**
- * Register a custom resource factory under `name`. Builtin names cannot
- * be shadowed; re-registering a custom name replaces it. Mirrors
- * Python's `mirage.resource.registry.register_resource`, which keeps
- * builtins in REGISTRY and custom entries in a separate _CUSTOM dict so
- * a plugin cannot replace the builtin `s3` factory.
- */
-export declare function register(name: string, factory: ResourceFactory): void;
-/**
- * Build a resource instance by registry name, or from a colon reference
- * naming a class directly (`./wiki.mjs:WikiResource`, or the package
- * specifier `my-pkg/backends:WikiResource`).
- *
- * Builtins win over custom registrations, and both win over a reference,
- * so a name can never be reinterpreted as code. Throws if the name is
- * neither. Mirrors the ladder in Python's `_resolve_entry`, minus its
- * entry-point rung: Node has no equivalent of `importlib.metadata`, so a
- * package ships a resource here by exporting it and being named.
- */
-export declare function buildResource(name: string, config?: Record<string, unknown>, sources?: Readonly<Record<string, ResolvedSource>>): Promise<Resource>;
-//# sourceMappingURL=registry.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/resource/registry.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAA;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAA;AAQpE;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAsRpF;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAEzC;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAGrE;AAgED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACpC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,GACjD,OAAO,CAAC,QAAQ,CAAC,CAgCnB"}