fauxqs 2.4.0 → 2.4.2

package/dist/tenant/trackedStores.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Tracked store subclasses for multi-tenant usage tracking.
+ *
+ * These override lookup methods to call `usageTracker.touch()` on every access.
+ * When tenant management is disabled, the base store classes are used directly —
+ * no tenant code runs on the hot path.
+ *
+ * MAINTENANCE: if a new public method is added to SqsStore, SnsStore, or S3Store
+ * that represents a "usage" of a resource (queue lookup, topic lookup, bucket
+ * operation), add a corresponding override here. The base store classes have a
+ * NOTE comment reminding contributors of this.
+ */
+import { SqsStore } from "../sqs/sqsStore.ts";
+import type { SqsQueue } from "../sqs/sqsStore.ts";
+import { SnsStore } from "../sns/snsStore.ts";
+import type { SnsTopic } from "../sns/snsTypes.ts";
+import { S3Store } from "../s3/s3Store.ts";
+import type { S3Object, ChecksumAlgorithm } from "../s3/s3Types.ts";
+import type { UsageTracker } from "./usageTracker.ts";
+/**
+ * SqsStore subclass that touches the usage tracker on every queue lookup.
+ * Used only when tenant management is enabled — otherwise plain SqsStore is used.
+ */
+export declare class TrackedSqsStore extends SqsStore {
+    private readonly tracker;
+    constructor(tracker: UsageTracker);
+    getQueue(url: string): SqsQueue | undefined;
+    getQueueByName(name: string): SqsQueue | undefined;
+    getQueueByArn(arn: string): SqsQueue | undefined;
+    listQueues(prefix?: string, maxResults?: number, nextToken?: string): {
+        queues: SqsQueue[];
+        nextToken?: string;
+    };
+}
+/**
+ * SnsStore subclass that touches the usage tracker on topic lookup.
+ */
+export declare class TrackedSnsStore extends SnsStore {
+    private readonly tracker;
+    constructor(tracker: UsageTracker);
+    getTopic(arn: string): SnsTopic | undefined;
+    listTopics(nextToken?: string): {
+        topics: SnsTopic[];
+        nextToken?: string;
+    };
+}
+/**
+ * S3Store subclass that touches the usage tracker on bucket operations.
+ * Only methods that represent real "usage" of a bucket are overridden.
+ * uploadPart is excluded — createMultipartUpload and completeMultipartUpload
+ * cover the lifecycle, and uploadPart can be called thousands of times per object.
+ */
+export declare class TrackedS3Store extends S3Store {
+    private readonly tracker;
+    constructor(tracker: UsageTracker);
+    putObject(bucket: string, key: string, body: Buffer, contentType?: string, metadata?: Record<string, string>, systemMetadata?: {
+        contentLanguage?: string;
+        contentDisposition?: string;
+        cacheControl?: string;
+        contentEncoding?: string;
+    }, checksumData?: {
+        algorithm: ChecksumAlgorithm;
+        value: string;
+        type: "FULL_OBJECT" | "COMPOSITE";
+        partChecksums?: string[];
+    }): S3Object;
+    getObject(bucket: string, key: string): S3Object;
+    deleteObject(bucket: string, key: string): void;
+    headObject(bucket: string, key: string): S3Object;
+    listObjects(bucket: string, options?: {
+        prefix?: string;
+        delimiter?: string;
+        maxKeys?: number;
+        startAfter?: string;
+        marker?: string;
+    }): {
+        objects: S3Object[];
+        commonPrefixes: string[];
+        isTruncated: boolean;
+    };
+    renameObject(bucket: string, sourceKey: string, destKey: string): void;
+    createMultipartUpload(bucket: string, key: string, contentType?: string, metadata?: Record<string, string>, systemMetadata?: {
+        contentLanguage?: string;
+        contentDisposition?: string;
+        cacheControl?: string;
+        contentEncoding?: string;
+    }, checksumAlgorithm?: ChecksumAlgorithm): string;
+    completeMultipartUpload(uploadId: string, partSpecs: {
+        partNumber: number;
+        etag: string;
+    }[]): S3Object;
+}
+//# sourceMappingURL=trackedStores.d.ts.map

package/dist/tenant/trackedStores.d.ts.map

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

package/dist/tenant/trackedStores.js

@@ -0,0 +1,122 @@
+/**
+ * Tracked store subclasses for multi-tenant usage tracking.
+ *
+ * These override lookup methods to call `usageTracker.touch()` on every access.
+ * When tenant management is disabled, the base store classes are used directly —
+ * no tenant code runs on the hot path.
+ *
+ * MAINTENANCE: if a new public method is added to SqsStore, SnsStore, or S3Store
+ * that represents a "usage" of a resource (queue lookup, topic lookup, bucket
+ * operation), add a corresponding override here. The base store classes have a
+ * NOTE comment reminding contributors of this.
+ */
+import { SqsStore } from "../sqs/sqsStore.js";
+import { SnsStore } from "../sns/snsStore.js";
+import { S3Store } from "../s3/s3Store.js";
+/**
+ * SqsStore subclass that touches the usage tracker on every queue lookup.
+ * Used only when tenant management is enabled — otherwise plain SqsStore is used.
+ */
+export class TrackedSqsStore extends SqsStore {
+    tracker;
+    constructor(tracker) {
+        super();
+        this.tracker = tracker;
+    }
+    getQueue(url) {
+        const queue = super.getQueue(url);
+        if (queue)
+            this.tracker.touch(queue.name);
+        return queue;
+    }
+    getQueueByName(name) {
+        const queue = super.getQueueByName(name);
+        if (queue)
+            this.tracker.touch(queue.name);
+        return queue;
+    }
+    getQueueByArn(arn) {
+        const queue = super.getQueueByArn(arn);
+        if (queue)
+            this.tracker.touch(queue.name);
+        return queue;
+    }
+    listQueues(prefix, maxResults, nextToken) {
+        const result = super.listQueues(prefix, maxResults, nextToken);
+        for (const queue of result.queues) {
+            this.tracker.touch(queue.name);
+        }
+        return result;
+    }
+}
+/**
+ * SnsStore subclass that touches the usage tracker on topic lookup.
+ */
+export class TrackedSnsStore extends SnsStore {
+    tracker;
+    constructor(tracker) {
+        super();
+        this.tracker = tracker;
+    }
+    getTopic(arn) {
+        const topic = super.getTopic(arn);
+        if (topic)
+            this.tracker.touch(topic.name);
+        return topic;
+    }
+    listTopics(nextToken) {
+        const result = super.listTopics(nextToken);
+        for (const topic of result.topics) {
+            this.tracker.touch(topic.name);
+        }
+        return result;
+    }
+}
+/**
+ * S3Store subclass that touches the usage tracker on bucket operations.
+ * Only methods that represent real "usage" of a bucket are overridden.
+ * uploadPart is excluded — createMultipartUpload and completeMultipartUpload
+ * cover the lifecycle, and uploadPart can be called thousands of times per object.
+ */
+export class TrackedS3Store extends S3Store {
+    tracker;
+    constructor(tracker) {
+        super();
+        this.tracker = tracker;
+    }
+    putObject(bucket, key, body, contentType, metadata, systemMetadata, checksumData) {
+        this.tracker.touch(bucket);
+        return super.putObject(bucket, key, body, contentType, metadata, systemMetadata, checksumData);
+    }
+    getObject(bucket, key) {
+        this.tracker.touch(bucket);
+        return super.getObject(bucket, key);
+    }
+    deleteObject(bucket, key) {
+        this.tracker.touch(bucket);
+        super.deleteObject(bucket, key);
+    }
+    headObject(bucket, key) {
+        this.tracker.touch(bucket);
+        return super.headObject(bucket, key);
+    }
+    listObjects(bucket, options) {
+        this.tracker.touch(bucket);
+        return super.listObjects(bucket, options);
+    }
+    renameObject(bucket, sourceKey, destKey) {
+        this.tracker.touch(bucket);
+        super.renameObject(bucket, sourceKey, destKey);
+    }
+    createMultipartUpload(bucket, key, contentType, metadata, systemMetadata, checksumAlgorithm) {
+        this.tracker.touch(bucket);
+        return super.createMultipartUpload(bucket, key, contentType, metadata, systemMetadata, checksumAlgorithm);
+    }
+    completeMultipartUpload(uploadId, partSpecs) {
+        const upload = this.multipartUploads.get(uploadId);
+        if (upload)
+            this.tracker.touch(upload.bucket);
+        return super.completeMultipartUpload(uploadId, partSpecs);
+    }
+}
+//# sourceMappingURL=trackedStores.js.map

package/dist/tenant/trackedStores.js.map

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

package/dist/tenant/usageTracker.d.ts

@@ -0,0 +1,40 @@
+export interface UsageEntry {
+    lastUsedMs: number;
+    /** Explicit prefix this resource belongs to, or null if not tenant-managed. */
+    prefix: string | null;
+}
+/**
+ * Tracks last-used timestamps and explicit prefix ownership for resources.
+ * Designed to be wired into stores via an optional field — when undefined,
+ * the optional chaining `store.usageTracker?.touch()` is a single falsy check.
+ */
+export declare class UsageTracker {
+    private entries;
+    /** Update the last-used timestamp for an already-registered resource. No-op if not registered. */
+    touch(name: string): void;
+    /** Register a resource with an explicit prefix. Also sets lastUsedMs to now. */
+    register(name: string, prefix: string | null): void;
+    /** Remove a resource from tracking. */
+    delete(name: string): void;
+    /** Get the entry for a resource, or undefined if not tracked. */
+    get(name: string): UsageEntry | undefined;
+    /** Number of tracked resources. */
+    get size(): number;
+    /**
+     * Iterate entries starting after `cursor`. Returns up to `budget` entries.
+     * When the end is reached, wraps around to the beginning.
+     * Returns the entries visited and whether a full cycle was completed.
+     */
+    scan(cursor: string | undefined, budget: number): {
+        visited: Array<[string, UsageEntry]>;
+        nextCursor: string | undefined;
+        wrapped: boolean;
+    };
+    /** Get all entries — primarily for listing/inspection. */
+    allEntries(): ReadonlyMap<string, UsageEntry>;
+    /** Return the next key after `name` in insertion order, or undefined if at end. */
+    nextAfter(name: string): string | undefined;
+    /** Clear all entries. */
+    clear(): void;
+}
+//# sourceMappingURL=usageTracker.d.ts.map

package/dist/tenant/usageTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usageTracker.d.ts","sourceRoot":"","sources":["../../src/tenant/usageTracker.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAiC;IAEhD,kGAAkG;IAClG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOzB,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAInD,uCAAuC;IACvC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1B,iEAAiE;IACjE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIzC,mCAAmC;IACnC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACH,IAAI,CACF,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,MAAM,GACb;QAAE,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;IAiC7F,0DAA0D;IAC1D,UAAU,IAAI,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC;IAI7C,mFAAmF;IACnF,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAS3C,yBAAyB;IACzB,KAAK,IAAI,IAAI;CAGd"}

package/dist/tenant/usageTracker.js

@@ -0,0 +1,87 @@
+/**
+ * Tracks last-used timestamps and explicit prefix ownership for resources.
+ * Designed to be wired into stores via an optional field — when undefined,
+ * the optional chaining `store.usageTracker?.touch()` is a single falsy check.
+ */
+export class UsageTracker {
+    entries = new Map();
+    /** Update the last-used timestamp for an already-registered resource. No-op if not registered. */
+    touch(name) {
+        const entry = this.entries.get(name);
+        if (entry) {
+            entry.lastUsedMs = Date.now();
+        }
+    }
+    /** Register a resource with an explicit prefix. Also sets lastUsedMs to now. */
+    register(name, prefix) {
+        this.entries.set(name, { lastUsedMs: Date.now(), prefix });
+    }
+    /** Remove a resource from tracking. */
+    delete(name) {
+        this.entries.delete(name);
+    }
+    /** Get the entry for a resource, or undefined if not tracked. */
+    get(name) {
+        return this.entries.get(name);
+    }
+    /** Number of tracked resources. */
+    get size() {
+        return this.entries.size;
+    }
+    /**
+     * Iterate entries starting after `cursor`. Returns up to `budget` entries.
+     * When the end is reached, wraps around to the beginning.
+     * Returns the entries visited and whether a full cycle was completed.
+     */
+    scan(cursor, budget) {
+        const maxToVisit = Math.min(budget, this.entries.size);
+        const visited = [];
+        let wrapped = false;
+        let pastCursor = cursor === undefined;
+        // First pass: from cursor to end
+        for (const [name, entry] of this.entries) {
+            if (visited.length >= maxToVisit) {
+                const nextCursor = visited.length > 0 ? visited[visited.length - 1][0] : cursor;
+                return { visited, nextCursor, wrapped: false };
+            }
+            if (!pastCursor) {
+                if (name === cursor) {
+                    pastCursor = true;
+                }
+                continue;
+            }
+            visited.push([name, entry]);
+        }
+        // Wrapped around — continue from start up to and including cursor
+        wrapped = true;
+        for (const [name, entry] of this.entries) {
+            if (visited.length >= maxToVisit)
+                break;
+            visited.push([name, entry]);
+            if (cursor !== undefined && name === cursor)
+                break;
+        }
+        const nextCursor = visited.length > 0 ? visited[visited.length - 1][0] : undefined;
+        return { visited, nextCursor, wrapped };
+    }
+    /** Get all entries — primarily for listing/inspection. */
+    allEntries() {
+        return this.entries;
+    }
+    /** Return the next key after `name` in insertion order, or undefined if at end. */
+    nextAfter(name) {
+        let found = false;
+        for (const key of this.entries.keys()) {
+            if (found)
+                return key;
+            if (key === name)
+                found = true;
+        }
+        return undefined;
+    }
+    /** Clear all entries. */
+    clear() {
+        this.entries.clear();
+    }
+}
+//# sourceMappingURL=usageTracker.js.map

package/dist/tenant/usageTracker.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fauxqs",
-  "version": "2.4.0",
+  "version": "2.4.2",
   "description": "SNS/SQS/S3 emulator",
   "type": "module",
   "scripts": {