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

package/dist/resource/s3/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/resource/s3/mock.ts"],"names":[],"mappings":"AA+BA,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IAErE,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC;IAShD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IAIxD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIxD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAKhF,UAAU,IAAI,SAAS,MAAM,EAAE;CAGhC;AAkGD,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,WAAW,CAAA;IAClB,KAAK,IAAI,IAAI,CAAA;IACb,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,wBAAgB,aAAa,CAAC,KAAK,GAAE,WAA+B,GAAG,MAAM,CAuF5E"}

package/dist/resource/s3/mock.js

@@ -0,0 +1,214 @@
+// ========= 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 { mockClient } from 'aws-sdk-client-mock';
+import { S3Client, GetObjectCommand, HeadObjectCommand, ListObjectsV2Command, PutObjectCommand, DeleteObjectCommand, DeleteObjectsCommand, CopyObjectCommand, } from '@aws-sdk/client-s3';
+import { createHash } from 'node:crypto';
+import { lstripSlash } from '@struktoai/mirage-core/utils/slash';
+import { compareCodePoints } from '@struktoai/mirage-core/utils/sort';
+const LAST_MODIFIED = new Date('2026-03-31T00:00:00Z');
+export class S3MockStore {
+    buckets = new Map();
+    objects(bucket) {
+        let m = this.buckets.get(bucket);
+        if (m === undefined) {
+            m = new Map();
+            this.buckets.set(bucket, m);
+        }
+        return m;
+    }
+    set(bucket, key, data) {
+        this.objects(bucket).set(key, data);
+    }
+    get(bucket, key) {
+        return this.buckets.get(bucket)?.get(key);
+    }
+    has(bucket, key) {
+        return this.buckets.get(bucket)?.has(key) ?? false;
+    }
+    delete(bucket, key) {
+        this.buckets.get(bucket)?.delete(key);
+    }
+    copy(srcBucket, srcKey, dstBucket, dstKey) {
+        const data = this.get(srcBucket, srcKey);
+        if (data !== undefined)
+            this.set(dstBucket, dstKey, data);
+    }
+    allBuckets() {
+        return [...this.buckets.keys()];
+    }
+}
+function notFound() {
+    const err = new Error('NoSuchKey');
+    err.name = 'NoSuchKey';
+    err.$metadata = { httpStatusCode: 404 };
+    return err;
+}
+function invalidRange() {
+    const err = new Error('InvalidRange');
+    err.name = 'InvalidRange';
+    err.$metadata = { httpStatusCode: 416 };
+    return err;
+}
+/**
+ * The slice a real ranged GET would return, refusals included.
+ *
+ * S3 answers 416 for a window starting at or past the end of a non-empty
+ * object. The mock used to slice regardless and hand back an empty array —
+ * which is the answer the ops layer produces only *after* normalizing that
+ * refusal, so agreeing with the fixed code for free left the normalization
+ * untested.
+ */
+function sliceRange(data, rangeSpec) {
+    if (!rangeSpec?.startsWith('bytes='))
+        return data;
+    const bounds = rangeSpec.slice(6).split('-', 2);
+    const start = bounds[0] ? Number.parseInt(bounds[0], 10) : 0;
+    const end = bounds[1] ? Number.parseInt(bounds[1], 10) : data.byteLength - 1;
+    if (data.byteLength > 0 && start >= data.byteLength)
+        throw invalidRange();
+    return data.slice(start, end + 1);
+}
+function paginateDirectory(objects, prefix) {
+    const commonPrefixes = new Set();
+    const contents = [];
+    const sorted = [...objects.entries()].sort(([a], [b]) => compareCodePoints(a, b));
+    for (const [key, data] of sorted) {
+        if (!key.startsWith(prefix))
+            continue;
+        const relative = key.slice(prefix.length);
+        if (relative === '') {
+            contents.push({ Key: key, Size: data.byteLength });
+            continue;
+        }
+        if (relative.includes('/')) {
+            const child = relative.split('/', 1)[0];
+            commonPrefixes.add(prefix + String(child) + '/');
+            continue;
+        }
+        contents.push({ Key: key, Size: data.byteLength });
+    }
+    return {
+        CommonPrefixes: [...commonPrefixes].sort(compareCodePoints).map((p) => ({ Prefix: p })),
+        Contents: contents,
+    };
+}
+function paginateFlat(objects, prefix) {
+    const contents = [];
+    const sorted = [...objects.entries()].sort(([a], [b]) => compareCodePoints(a, b));
+    for (const [key, data] of sorted) {
+        if (key.startsWith(prefix))
+            contents.push({ Key: key, Size: data.byteLength });
+    }
+    return { Contents: contents };
+}
+function md5Hex(data) {
+    return createHash('md5').update(data).digest('hex');
+}
+function mockBody(data) {
+    return {
+        transformToByteArray: () => Promise.resolve(data),
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async *[Symbol.asyncIterator]() {
+            const chunkSize = 8192;
+            for (let i = 0; i < data.byteLength; i += chunkSize) {
+                yield data.slice(i, Math.min(i + chunkSize, data.byteLength));
+            }
+        },
+    };
+}
+export function installS3Mock(store = new S3MockStore()) {
+    const mock = mockClient(S3Client);
+    mock.on(GetObjectCommand).callsFake((input) => {
+        const data = store.get(input.Bucket, input.Key);
+        if (data === undefined)
+            throw notFound();
+        const sliced = sliceRange(data, input.Range);
+        return Promise.resolve({ Body: mockBody(sliced), ContentLength: sliced.byteLength });
+    });
+    mock.on(HeadObjectCommand).callsFake((input) => {
+        const data = store.get(input.Bucket, input.Key);
+        if (data === undefined)
+            throw notFound();
+        return Promise.resolve({
+            ContentLength: data.byteLength,
+            LastModified: LAST_MODIFIED,
+            ETag: `"${md5Hex(data)}"`,
+        });
+    });
+    mock
+        .on(ListObjectsV2Command)
+        .callsFake((input) => {
+        const objects = store.objects(input.Bucket);
+        const prefix = input.Prefix ?? '';
+        const page = input.Delimiter === '/' ? paginateDirectory(objects, prefix) : paginateFlat(objects, prefix);
+        return Promise.resolve({
+            Contents: page.Contents ?? [],
+            ...(page.CommonPrefixes !== undefined ? { CommonPrefixes: page.CommonPrefixes } : {}),
+            IsTruncated: false,
+            KeyCount: page.Contents?.length ?? 0,
+        });
+    });
+    mock
+        .on(PutObjectCommand)
+        .callsFake((input) => {
+        let body;
+        const raw = input.Body;
+        if (raw instanceof Uint8Array)
+            body = raw;
+        else if (typeof raw === 'string')
+            body = new TextEncoder().encode(raw);
+        else
+            body = new Uint8Array();
+        store.set(input.Bucket, input.Key, body);
+        return Promise.resolve({ ETag: `"${md5Hex(body)}"` });
+    });
+    mock.on(DeleteObjectCommand).callsFake((input) => {
+        store.delete(input.Bucket, input.Key);
+        return Promise.resolve({});
+    });
+    mock
+        .on(DeleteObjectsCommand)
+        .callsFake((input) => {
+        const deleted = [];
+        for (const obj of input.Delete.Objects ?? []) {
+            store.delete(input.Bucket, obj.Key);
+            deleted.push({ Key: obj.Key });
+        }
+        return Promise.resolve({ Deleted: deleted });
+    });
+    mock
+        .on(CopyObjectCommand)
+        .callsFake((input) => {
+        const source = lstripSlash(input.CopySource);
+        const idx = source.indexOf('/');
+        const srcBucket = idx > 0 ? source.slice(0, idx) : input.Bucket;
+        const srcKey = idx > 0 ? source.slice(idx + 1) : source;
+        store.copy(srcBucket, srcKey, input.Bucket, input.Key);
+        return Promise.resolve({
+            CopyObjectResult: {
+                ETag: `"${md5Hex(store.get(input.Bucket, input.Key) ?? new Uint8Array())}"`,
+            },
+        });
+    });
+    return {
+        store,
+        reset: () => {
+            mock.reset();
+        },
+        restore: () => {
+            mock.restore();
+        },
+    };
+}
+//# sourceMappingURL=mock.js.map

package/dist/resource/s3/mock.js.map

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

package/dist/resource/s3/s3.d.ts

@@ -0,0 +1,50 @@
+import { S3Accessor } from '@struktoai/mirage-core/accessor/s3';
+import type { RegisteredCommand } from '@struktoai/mirage-core/commands/config';
+import type { RegisteredOp } from '@struktoai/mirage-core/ops/registry';
+import { BaseResource } from '@struktoai/mirage-core/resource/base';
+import type { FindOptions, Resource } from '@struktoai/mirage-core/resource/base';
+import { PathSpec } from '@struktoai/mirage-core/types';
+import type { FileStat } from '@struktoai/mirage-core/types';
+import { type S3Config, type S3ConfigRedacted } from './config.ts';
+import { type DeltaHook } from '@struktoai/mirage-core/watch/index';
+export interface S3ResourceState {
+    type: string;
+    config: S3ConfigRedacted;
+}
+export declare class S3Resource extends BaseResource implements Resource {
+    readonly kind: string;
+    readonly cachesReads: boolean;
+    readonly supportsSnapshot: boolean;
+    readonly sizesAlwaysKnown: boolean;
+    readonly indexTtl: number;
+    readonly prompt: string;
+    readonly config: S3Config;
+    readonly accessor: S3Accessor;
+    readonly opsMap: Record<string, unknown>;
+    constructor(config: S3Config);
+    storageId(): string;
+    open(): Promise<void>;
+    commands(): readonly RegisteredCommand[];
+    ops(): readonly RegisteredOp[];
+    streamPath(p: PathSpec): AsyncIterable<Uint8Array>;
+    readFile(p: PathSpec): Promise<Uint8Array>;
+    writeFile(p: PathSpec, data: Uint8Array): Promise<void>;
+    appendFile(p: PathSpec, data: Uint8Array): Promise<void>;
+    readdir(p: PathSpec): Promise<string[]>;
+    stat(p: PathSpec): Promise<FileStat>;
+    exists(p: PathSpec): Promise<boolean>;
+    mkdir(p: PathSpec): Promise<void>;
+    rmdir(p: PathSpec): Promise<void>;
+    unlink(p: PathSpec): Promise<void>;
+    rename(src: PathSpec, dst: PathSpec): Promise<void>;
+    truncate(p: PathSpec, length: number): Promise<void>;
+    copy(src: PathSpec, dst: PathSpec): Promise<void>;
+    rmR(p: PathSpec): Promise<void>;
+    du(p: PathSpec): Promise<number>;
+    find(p: PathSpec, options?: FindOptions): Promise<string[]>;
+    glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
+    deltaHook(): DeltaHook;
+    getState(): Promise<S3ResourceState>;
+    loadState(_state: S3ResourceState): Promise<void>;
+}
+//# sourceMappingURL=s3.d.ts.map

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

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

package/dist/resource/s3/s3.js

@@ -0,0 +1,201 @@
+// ========= 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 { S3Accessor } from '@struktoai/mirage-core/accessor/s3';
+import { makeResolveGlob } from '@struktoai/mirage-core/commands/builtin/generic_bind/index';
+import { S3_COMMANDS } from '@struktoai/mirage-core/commands/builtin/s3/index';
+import { SCOPE_ERROR as S3_SCOPE_ERROR } from '@struktoai/mirage-core/core/s3/constants';
+import { copy as copyCore } from '@struktoai/mirage-core/core/s3/copy';
+import { create as createCore } from '@struktoai/mirage-core/core/s3/create';
+import { entries as duEntriesCore, size as duSizeCore, } from '@struktoai/mirage-core/core/s3/du/index';
+import { exists as existsCore } from '@struktoai/mirage-core/core/s3/exists';
+import { find as findCore } from '@struktoai/mirage-core/core/s3/find';
+import { mkdir as mkdirCore } from '@struktoai/mirage-core/core/s3/mkdir';
+import { read as readCore } from '@struktoai/mirage-core/core/s3/read';
+import { readdir as readdirCore } from '@struktoai/mirage-core/core/s3/readdir';
+import { rename as renameCore } from '@struktoai/mirage-core/core/s3/rename';
+import { rmR as rmRCore } from '@struktoai/mirage-core/core/s3/rm';
+import { rmdir as rmdirCore } from '@struktoai/mirage-core/core/s3/rmdir';
+import { stat as statCore } from '@struktoai/mirage-core/core/s3/stat';
+import { rangeRead as rangeReadCore, stream as streamCore, } from '@struktoai/mirage-core/core/s3/stream';
+import { truncate as truncateCore } from '@struktoai/mirage-core/core/s3/truncate';
+import { unlink as unlinkCore } from '@struktoai/mirage-core/core/s3/unlink';
+import { write as writeCore } from '@struktoai/mirage-core/core/s3/write';
+import { S3_OPS } from '@struktoai/mirage-core/ops/s3/index';
+import { BaseResource } from '@struktoai/mirage-core/resource/base';
+import { normalizeKeyPrefix } from '@struktoai/mirage-core/resource/s3/config';
+import { S3_PROMPT } from '@struktoai/mirage-core/resource/s3/prompt';
+import { s3StorageId } from '@struktoai/mirage-core/resource/s3/storage_id';
+import { PathSpec, ResourceName } from '@struktoai/mirage-core/types';
+import { mountKey, mountPrefixOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { HttpProxyAgent } from 'http-proxy-agent';
+import { HttpsProxyAgent } from 'https-proxy-agent';
+import { redactConfig } from "./config.js";
+import { buildDeltaHook } from '@struktoai/mirage-core/core/s3/watch';
+import {} from '@struktoai/mirage-core/watch/index';
+const globCore = makeResolveGlob(readdirCore, S3_SCOPE_ERROR);
+function createProxyAgents(proxy) {
+    return { httpAgent: new HttpProxyAgent(proxy), httpsAgent: new HttpsProxyAgent(proxy) };
+}
+export class S3Resource extends BaseResource {
+    kind = ResourceName.S3;
+    cachesReads = true;
+    supportsSnapshot = true;
+    // byte store: stat() sizes every file from metadata
+    sizesAlwaysKnown = true;
+    indexTtl = 600;
+    prompt = S3_PROMPT;
+    config;
+    accessor;
+    opsMap = {
+        read_bytes: readCore,
+        write: writeCore,
+        readdir: readdirCore,
+        stat: statCore,
+        unlink: unlinkCore,
+        rmdir: rmdirCore,
+        copy: copyCore,
+        rename: renameCore,
+        mkdir: mkdirCore,
+        read_stream: streamCore,
+        range_read: rangeReadCore,
+        rm_recursive: rmRCore,
+        du_size: duSizeCore,
+        du_entries: duEntriesCore,
+        create: createCore,
+        truncate: truncateCore,
+        exists: existsCore,
+        find_flat: findCore,
+    };
+    constructor(config) {
+        super();
+        const normalized = normalizeKeyPrefix(config.keyPrefix);
+        const cfg = { ...config };
+        if (normalized !== undefined) {
+            cfg.keyPrefix = normalized;
+        }
+        else {
+            delete cfg.keyPrefix;
+        }
+        this.config = cfg;
+        const proxy = cfg.proxy;
+        this.accessor = new S3Accessor({
+            ...cfg,
+            ...(proxy !== undefined && proxy !== ''
+                ? { httpAgentProvider: () => createProxyAgents(proxy) }
+                : {}),
+        });
+    }
+    storageId() {
+        return s3StorageId(this.kind, this.config);
+    }
+    open() {
+        return Promise.resolve();
+    }
+    commands() {
+        return S3_COMMANDS.toArray();
+    }
+    ops() {
+        return S3_OPS;
+    }
+    streamPath(p) {
+        return streamCore(this.accessor, p);
+    }
+    readFile(p) {
+        return readCore(this.accessor, p);
+    }
+    writeFile(p, data) {
+        return writeCore(this.accessor, p, data);
+    }
+    async appendFile(p, data) {
+        let existing;
+        try {
+            existing = await readCore(this.accessor, p);
+        }
+        catch (err) {
+            if (err?.code === 'ENOENT') {
+                existing = new Uint8Array();
+            }
+            else {
+                throw err;
+            }
+        }
+        const merged = new Uint8Array(existing.byteLength + data.byteLength);
+        merged.set(existing, 0);
+        merged.set(data, existing.byteLength);
+        await writeCore(this.accessor, p, merged);
+    }
+    readdir(p) {
+        return readdirCore(this.accessor, p, this.index);
+    }
+    stat(p) {
+        return statCore(this.accessor, p);
+    }
+    exists(p) {
+        return existsCore(this.accessor, p);
+    }
+    mkdir(p) {
+        return mkdirCore(this.accessor, p);
+    }
+    rmdir(p) {
+        return rmdirCore(this.accessor, p);
+    }
+    unlink(p) {
+        return unlinkCore(this.accessor, p);
+    }
+    rename(src, dst) {
+        return renameCore(this.accessor, src, dst);
+    }
+    truncate(p, length) {
+        return truncateCore(this.accessor, p, length);
+    }
+    copy(src, dst) {
+        return copyCore(this.accessor, src, dst);
+    }
+    rmR(p) {
+        return rmRCore(this.accessor, p);
+    }
+    du(p) {
+        return duSizeCore(this.accessor, p);
+    }
+    find(p, options = {}) {
+        return findCore(this.accessor, p, options);
+    }
+    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 globCore(this.accessor, effective, this.index);
+    }
+    deltaHook() {
+        return buildDeltaHook(this.accessor);
+    }
+    getState() {
+        return Promise.resolve({
+            type: this.kind,
+            config: redactConfig(this.config),
+        });
+    }
+    loadState(_state) {
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=s3.js.map

package/dist/resource/s3/s3.js.map

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

package/dist/resource/s3_alias.d.ts

@@ -0,0 +1,112 @@
+import { S3Resource } from './s3/s3.ts';
+import type { RegisteredCommand } from '@struktoai/mirage-core/commands/config';
+import type { RegisteredOp } from '@struktoai/mirage-core/ops/registry';
+import { z } from '@struktoai/mirage-core/resource/secrets';
+import type { ConfigOf, RedactedConfig } from '@struktoai/mirage-core/resource/secrets';
+import type { S3Config, S3ConfigRedacted } from './s3/config.ts';
+/**
+ * Shared shape for the S3-compatible providers.
+ *
+ * Every alias is the same credentials plus one endpoint rule, so the
+ * fields, the zod schema that drives redaction, the snake_case mapping and
+ * the conversion to S3Config live here once. A provider declares only its
+ * endpoint rule and whatever it genuinely adds. Mirrors Python's
+ * `mirage/resource/s3_alias.py`.
+ *
+ * Only `bucket` and whatever the endpoint genuinely needs are required.
+ * Credentials are optional because `S3Config` leaves them optional too, so
+ * omitting them falls through to the usual AWS resolution order: `profile`,
+ * then the `AWS_ACCESS_KEY_ID` / `AWS_SECRET_ACCESS_KEY` environment
+ * variables, then the shared credentials file, then an instance role.
+ * `sessionToken` and `profile` live here rather than on the one provider
+ * that first needed them, so every alias accepts them.
+ */
+export interface S3AliasConfig {
+    bucket: string;
+    accessKeyId?: string;
+    secretAccessKey?: string;
+    sessionToken?: string;
+    profile?: string;
+    region?: string;
+    endpoint?: string;
+    forcePathStyle?: boolean;
+    keyPrefix?: string;
+    timeoutMs?: number;
+    proxy?: string;
+}
+declare const ALIAS_SCHEMA: z.ZodObject<{
+    region: z.ZodString;
+    endpoint: z.ZodString;
+    bucket: z.ZodString;
+    accessKeyId: z.ZodOptional<z.ZodString>;
+    secretAccessKey: z.ZodOptional<z.ZodString>;
+    sessionToken: z.ZodOptional<z.ZodString>;
+    profile: z.ZodOptional<z.ZodString>;
+    forcePathStyle: z.ZodOptional<z.ZodBoolean>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    proxy: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type S3AliasConfigRedacted = RedactedConfig<ConfigOf<typeof ALIAS_SCHEMA>, 'accessKeyId' | 'secretAccessKey' | 'sessionToken' | 'proxy'>;
+export interface Alias<C extends S3AliasConfig, R> {
+    toS3Config: (config: C) => S3Config;
+    redact: (config: C) => R;
+    normalize: (input: Record<string, unknown>) => C;
+}
+/**
+ * A provider whose endpoint is derived from its (required) region.
+ *
+ * `forcePathStyle` stays absent from the S3Config when the caller did not
+ * ask for it, which is what the hand-written providers did and what the
+ * S3 client treats as virtual-hosted style.
+ */
+export declare function makeRegionAlias<C extends S3AliasConfig & {
+    region: string;
+}, R>(endpointFor: (config: C) => string): Alias<C, R> & {
+    resolvedEndpoint: (config: C) => string;
+};
+/**
+ * A self-hosted gateway reachable only at a caller-supplied endpoint.
+ *
+ * ceph, minio and seaweedfs have no public region to derive from, so the
+ * region and path-style defaults are materialized rather than omitted.
+ */
+export declare function makeFixedAlias<C extends S3AliasConfig & {
+    endpoint: string;
+}, R>(): Alias<C, R>;
+/**
+ * The snapshot state of an S3-compatible alias: its own kind and its own
+ * redacted config, not the `s3` kind and S3 config it delegates to.
+ */
+export interface S3AliasResourceState<TRedacted> {
+    type: string;
+    config: TRedacted;
+}
+/**
+ * The shared body of every S3-compatible provider resource (MinIO, Ceph,
+ * R2, Wasabi, ...). Each is an {@link S3Resource} reached through a
+ * provider-shaped config, so all it owns is its `kind`, that config, and
+ * ops/commands retagged from `s3` onto the kind. A subclass supplies its
+ * prompt as a plain field and hands the varying pieces to `super`.
+ *
+ * `toS3Config` and `redact` arrive as functions rather than as an
+ * {@link Alias}: the four providers whose region or endpoint rule fits
+ * neither {@link makeRegionAlias} nor {@link makeFixedAlias} write their
+ * own pair, so the resource layer takes the two functions every provider
+ * has either way. Mirrors python `S3AliasResource` in
+ * `mirage/resource/s3_alias.py`.
+ */
+export declare abstract class S3AliasResource<TConfig, TRedacted extends S3ConfigRedacted> extends S3Resource {
+    readonly kind: string;
+    readonly aliasConfig: TConfig;
+    private readonly aliasOps;
+    private readonly aliasCommands;
+    private readonly redactAlias;
+    protected constructor(kind: string, config: TConfig, s3Config: S3Config, redact: (config: TConfig) => TRedacted);
+    ops(): readonly RegisteredOp[];
+    commands(): readonly RegisteredCommand[];
+    getState(): Promise<S3AliasResourceState<TRedacted>>;
+    loadState(_state: S3AliasResourceState<TRedacted>): Promise<void>;
+}
+export {};
+//# sourceMappingURL=s3_alias.d.ts.map

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

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