actor-ts 0.9.0

package/dist/persistence/object-storage/ObjectStoragePlugin.js

@@ -0,0 +1,113 @@
+import { ObjectStorageDurableStateStore } from '../durable-state-stores/ObjectStorageDurableStateStore.js';
+import { ObjectStorageSnapshotStore } from '../snapshot-stores/ObjectStorageSnapshotStore.js';
+import { probeCompressionAvailability } from './Compression.js';
+import { probeEncryptionAvailability } from './Encryption.js';
+import { FilesystemObjectStorageBackend } from './FilesystemObjectStorageBackend.js';
+import { S3ObjectStorageBackend, } from './S3ObjectStorageBackend.js';
+import { knownConfigsOf, } from './PluginConfig.js';
+/** Canonical plugin IDs registered by `registerObjectStoragePlugins`. */
+export const OBJECT_STORAGE_SNAPSHOT_PLUGIN_ID = 'actor-ts.persistence.snapshot-store.object-storage';
+export const OBJECT_STORAGE_DURABLE_STATE_PLUGIN_ID = 'actor-ts.persistence.durable-state.object-storage';
+/**
+ * Register the object-storage SnapshotStore against `PersistenceExtension`
+ * and return a ready-to-use DurableStateStore instance.  Mirrors the
+ * Cassandra plugin's one-call wiring while accepting that DurableState
+ * isn't extension-managed today — callers who want DurableState read
+ * `handles.durableStateStore` from the return value and pass it into
+ * their `DurableStateActor` settings.
+ *
+ * **Eager peer-dep validation (#18, #59).**  Before returning, this
+ * function probes any optional peer-dependency the configured codecs
+ * need — `fzstd` for `compression: 'zstd'` (when neither Bun nor
+ * Node 22.15+ provides a native impl), `SubtleCrypto` when any
+ * encryption config is supplied.  A failing probe surfaces the
+ * "install X" message **here**, at registration time, instead of
+ * silently surviving until the first persist call.  For resolvers
+ * built via `compressionByPrefix` / `encryptionByPrefix` every config
+ * the resolver could return is probed; opaque user-written resolvers
+ * fall back to first-use checks.
+ *
+ * Example:
+ *
+ *   const ext = system.extension(PersistenceExtensionId);
+ *   const { durableStateStore } = await registerObjectStoragePlugins(ext, {
+ *     backend: { kind: 's3', bucket: 'my-app', region: 'eu-central-1' },
+ *     compression: { algorithm: 'zstd' },
+ *     encryption:  encryptionByPrefix({ default: { mode: 'sse-s3' } }),
+ *   });
+ *   // ... and to make the snapshot plugin active:
+ *   //   actor-ts.persistence.snapshot-store.plugin = "actor-ts.persistence.snapshot-store.object-storage"
+ */
+export async function registerObjectStoragePlugins(ext, options) {
+    await validateObjectStoragePeerDeps(options);
+    const backend = buildBackend(options.backend);
+    const snapshotId = options.snapshotPluginId ?? OBJECT_STORAGE_SNAPSHOT_PLUGIN_ID;
+    ext.registerSnapshotStore(snapshotId, (_system) => new ObjectStorageSnapshotStore({
+        backend,
+        prefix: options.prefix,
+        keepN: options.keepN,
+        compression: options.compression,
+        encryption: options.encryption,
+    }));
+    const durableStateStore = new ObjectStorageDurableStateStore({
+        backend,
+        prefix: options.prefix,
+        compression: options.compression,
+        encryption: options.encryption,
+    });
+    return { backend, durableStateStore };
+}
+/**
+ * Probe every codec peer-dep the configured options may need.  Public
+ * so callers can pre-validate (e.g. at app bootstrap) independently of
+ * actually registering the plugin.
+ */
+export async function validateObjectStoragePeerDeps(options) {
+    // Compression: probe each algorithm at most once.
+    const algos = new Set();
+    for (const cfg of collectCompressionConfigs(options.compression)) {
+        algos.add(cfg.algorithm);
+    }
+    for (const algo of algos) {
+        await probeCompressionAvailability(algo);
+    }
+    // Encryption: WebCrypto is needed for the client-aes256-gcm mode
+    // (HKDF + AES-GCM go through SubtleCrypto).  The server-side modes
+    // — sse-s3, sse-kms — are header pass-throughs and need nothing.
+    const encConfigs = collectEncryptionConfigs(options.encryption);
+    if (encConfigs.some((c) => c.mode === 'client-aes256-gcm')) {
+        await probeEncryptionAvailability();
+    }
+}
+function collectCompressionConfigs(c) {
+    if (c === undefined)
+        return [];
+    if (typeof c === 'function') {
+        // Resolver: check for the introspection metadata that
+        // `compressionByPrefix` attaches.  Opaque user resolvers return
+        // `undefined` here — we skip them rather than guess.
+        return knownConfigsOf(c) ?? [];
+    }
+    return [c];
+}
+function collectEncryptionConfigs(e) {
+    if (e === undefined)
+        return [];
+    if (typeof e === 'function')
+        return knownConfigsOf(e) ?? [];
+    return [e];
+}
+function buildBackend(spec) {
+    switch (spec.kind) {
+        case 'filesystem': return new FilesystemObjectStorageBackend({ dir: spec.dir });
+        case 's3': return new S3ObjectStorageBackend({
+            bucket: spec.bucket,
+            region: spec.region,
+            endpoint: spec.endpoint,
+            forcePathStyle: spec.forcePathStyle,
+            credentials: spec.credentials,
+        });
+        case 'custom': return spec.backend;
+    }
+}
+//# sourceMappingURL=ObjectStoragePlugin.js.map

package/dist/persistence/object-storage/ObjectStoragePlugin.js.map

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

package/dist/persistence/object-storage/PluginConfig.d.ts

@@ -0,0 +1,67 @@
+import type { CompressionConfig, EncryptionConfig } from '../PersistenceOptions.js';
+/**
+ * Programmatic configuration for compression and encryption — used by
+ * `ObjectStorageSnapshotStore` and `ObjectStorageDurableStateStore` as
+ * **plugin-level defaults**.
+ *
+ * Per-actor preferences live on the actor itself (see
+ * `PersistentActor.compression()` / `.encryption()`); the resolvers
+ * here are the fallback for actors that don't set their own.  Both
+ * fields accept either a flat config (applied uniformly) or a resolver
+ * function (called per-save with the `persistenceId`).  Returning
+ * `undefined` from a resolver means "fall back to the store's default".
+ *
+ * The `CompressionConfig` / `EncryptionConfig` types themselves are
+ * re-exported from the neutral `../PersistenceWriteOptions.js` so
+ * actors can import them without depending on the object-storage layer.
+ *
+ * Convenience helpers (`compressionByPrefix`, `encryptionByPrefix`)
+ * build common resolvers for the longest-prefix-match pattern.
+ */
+export type { CompressionAlgo, CompressionConfig, EncryptionConfig, MasterKeyRing, MasterKeyRingEntry, } from '../PersistenceOptions.js';
+export type CompressionResolver = (persistenceId: string) => CompressionConfig | undefined;
+export type EncryptionResolver = (persistenceId: string) => EncryptionConfig | undefined;
+/**
+ * Internal: a resolver function with optional introspection metadata.
+ * `compressionByPrefix` / `encryptionByPrefix` attach `__knownConfigs`
+ * so that eager peer-dep validation (#18, #59) can probe every config
+ * the resolver could possibly return.  Custom user-written resolvers
+ * are opaque — their peer-dep checks fall back to first-use.
+ */
+declare const KNOWN_CONFIGS: unique symbol;
+export interface ResolverWithKnownConfigs<T> {
+    readonly [KNOWN_CONFIGS]?: ReadonlyArray<T>;
+}
+export declare const RESOLVER_KNOWN_CONFIGS_SYMBOL: symbol;
+/**
+ * Read the optional `__knownConfigs` metadata from a resolver.  Returns
+ * `undefined` for opaque user-written resolvers.
+ */
+export declare function knownConfigsOf<T>(resolver: ((pid: string) => T | undefined)): ReadonlyArray<T> | undefined;
+/**
+ * Resolve `compression` to a `CompressionConfig` for a given pid, taking
+ * the resolver-vs-flat distinction into account and falling back to the
+ * supplied default when the resolver returns `undefined` or when no
+ * compression is configured at all.
+ */
+export declare function resolveCompression(config: CompressionConfig | CompressionResolver | undefined, pid: string, fallback: CompressionConfig): CompressionConfig;
+/** Same shape as `resolveCompression` but for encryption configs. */
+export declare function resolveEncryption(config: EncryptionConfig | EncryptionResolver | undefined, pid: string, fallback: EncryptionConfig): EncryptionConfig;
+/**
+ * Build a `CompressionResolver` from a longest-prefix-match map.  The
+ * `default` entry is used when no other prefix matches.
+ *
+ *   compressionByPrefix({
+ *     default:        { algorithm: 'gzip' },
+ *     'events/big/':  { algorithm: 'zstd' },
+ *     'events/tiny/': { algorithm: 'none' },
+ *   })
+ */
+export declare function compressionByPrefix(spec: {
+    readonly default?: CompressionConfig;
+} & Record<string, CompressionConfig>): CompressionResolver;
+/** Mirror of `compressionByPrefix` for encryption configs. */
+export declare function encryptionByPrefix(spec: {
+    readonly default?: EncryptionConfig;
+} & Record<string, EncryptionConfig>): EncryptionResolver;
+//# sourceMappingURL=PluginConfig.d.ts.map

package/dist/persistence/object-storage/PluginConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginConfig.d.ts","sourceRoot":"","sources":["../../../src/persistence/object-storage/PluginConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;;;;;;;;;;GAkBG;AAEH,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,MAAM,MAAM,mBAAmB,GAAG,CAAC,aAAa,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,CAAC;AAE3F,MAAM,MAAM,kBAAkB,GAAG,CAAC,aAAa,EAAE,MAAM,KAAK,gBAAgB,GAAG,SAAS,CAAC;AAEzF;;;;;;GAMG;AACH,QAAA,MAAM,aAAa,eAA0D,CAAC;AAE9E,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC,QAAQ,CAAC,CAAC,aAAa,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;CAC7C;AAED,eAAO,MAAM,6BAA6B,QAAgB,CAAC;AAc3D;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,GAAG,SAAS,CAAC,GACzC,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAE9B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,GAAG,mBAAmB,GAAG,SAAS,EAC3D,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,iBAAiB,GAC1B,iBAAiB,CAInB;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,gBAAgB,GAAG,kBAAkB,GAAG,SAAS,EACzD,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,gBAAgB,GACzB,gBAAgB,CAIlB;AAID;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GACjF,mBAAmB,CAcrB;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAChC,IAAI,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC/E,kBAAkB,CAYpB"}

package/dist/persistence/object-storage/PluginConfig.js

@@ -0,0 +1,93 @@
+/**
+ * Internal: a resolver function with optional introspection metadata.
+ * `compressionByPrefix` / `encryptionByPrefix` attach `__knownConfigs`
+ * so that eager peer-dep validation (#18, #59) can probe every config
+ * the resolver could possibly return.  Custom user-written resolvers
+ * are opaque — their peer-dep checks fall back to first-use.
+ */
+const KNOWN_CONFIGS = Symbol.for('actor-ts.persistence.resolverKnownConfigs');
+export const RESOLVER_KNOWN_CONFIGS_SYMBOL = KNOWN_CONFIGS;
+function attachKnownConfigs(fn, configs) {
+    Object.defineProperty(fn, KNOWN_CONFIGS, {
+        value: Object.freeze(configs.slice()),
+        enumerable: false,
+        configurable: false,
+        writable: false,
+    });
+    return fn;
+}
+/**
+ * Read the optional `__knownConfigs` metadata from a resolver.  Returns
+ * `undefined` for opaque user-written resolvers.
+ */
+export function knownConfigsOf(resolver) {
+    return resolver[KNOWN_CONFIGS];
+}
+/**
+ * Resolve `compression` to a `CompressionConfig` for a given pid, taking
+ * the resolver-vs-flat distinction into account and falling back to the
+ * supplied default when the resolver returns `undefined` or when no
+ * compression is configured at all.
+ */
+export function resolveCompression(config, pid, fallback) {
+    if (config === undefined)
+        return fallback;
+    if (typeof config === 'function')
+        return config(pid) ?? fallback;
+    return config;
+}
+/** Same shape as `resolveCompression` but for encryption configs. */
+export function resolveEncryption(config, pid, fallback) {
+    if (config === undefined)
+        return fallback;
+    if (typeof config === 'function')
+        return config(pid) ?? fallback;
+    return config;
+}
+/* ------------------------- Convenience builders ------------------------- */
+/**
+ * Build a `CompressionResolver` from a longest-prefix-match map.  The
+ * `default` entry is used when no other prefix matches.
+ *
+ *   compressionByPrefix({
+ *     default:        { algorithm: 'gzip' },
+ *     'events/big/':  { algorithm: 'zstd' },
+ *     'events/tiny/': { algorithm: 'none' },
+ *   })
+ */
+export function compressionByPrefix(spec) {
+    const sorted = Object.entries(spec)
+        .filter(([k]) => k !== 'default')
+        .sort(([a], [b]) => b.length - a.length);
+    const fallback = spec.default;
+    const resolver = (pid) => {
+        for (const [prefix, cfg] of sorted)
+            if (pid.startsWith(prefix))
+                return cfg;
+        return fallback;
+    };
+    // Tag with every config the resolver could return, so eager peer-dep
+    // validation (#18, #59) can probe each algorithm exactly once.
+    const all = sorted.map(([, c]) => c);
+    if (fallback)
+        all.push(fallback);
+    return attachKnownConfigs(resolver, all);
+}
+/** Mirror of `compressionByPrefix` for encryption configs. */
+export function encryptionByPrefix(spec) {
+    const sorted = Object.entries(spec)
+        .filter(([k]) => k !== 'default')
+        .sort(([a], [b]) => b.length - a.length);
+    const fallback = spec.default;
+    const resolver = (pid) => {
+        for (const [prefix, cfg] of sorted)
+            if (pid.startsWith(prefix))
+                return cfg;
+        return fallback;
+    };
+    const all = sorted.map(([, c]) => c);
+    if (fallback)
+        all.push(fallback);
+    return attachKnownConfigs(resolver, all);
+}
+//# sourceMappingURL=PluginConfig.js.map

package/dist/persistence/object-storage/PluginConfig.js.map

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

package/dist/persistence/object-storage/S3ObjectStorageBackend.d.ts

@@ -0,0 +1,104 @@
+import { type Option } from '../../util/Option.js';
+import { type ObjectFetched, type ObjectInfo, type ObjectStorageBackend, type PutOptions } from './ObjectStorageBackend.js';
+/**
+ * S3-compatible `ObjectStorageBackend` — wraps AWS SDK v3
+ * (`@aws-sdk/client-s3`) and works against AWS S3, MinIO, Cloudflare R2,
+ * Backblaze B2, DigitalOcean Spaces, Wasabi … any service that speaks the
+ * S3 API.
+ *
+ * `@aws-sdk/client-s3` is an **optional peer dependency**: this module
+ * lazy-imports the SDK only when `put`/`get`/`delete`/`list` is first
+ * called, so users who don't reach for the S3 backend don't pay the
+ * ~3-4 MB SDK weight.  The same pattern is used by `NodeHonoRunner`
+ * for `@hono/node-server`.
+ *
+ * **Strict CAS** maps to S3's HTTP preconditions:
+ *
+ *   - `ifMatch:    '<etag>'` → HTTP `If-Match: <etag>` — refuse if changed
+ *   - `ifNoneMatch: '*'`     → HTTP `If-None-Match: *` — refuse if exists
+ *
+ * Both surface as `412 Precondition Failed` from S3, which we translate
+ * to `ObjectStorageConcurrencyError`.  S3 added `If-None-Match` PUT
+ * support in August 2024; older S3-compatible stores may reject it —
+ * that's a backend-version issue, not a code issue, and the resulting
+ * error is propagated as `ObjectStorageBackendError`.
+ *
+ * **Endpoint override** — for MinIO / R2 / Backblaze: pass `endpoint`
+ * and (for path-style services like MinIO) `forcePathStyle: true`.  For
+ * R2 the canonical region is `'auto'`.
+ */
+export interface S3Credentials {
+    readonly accessKeyId: string;
+    readonly secretAccessKey: string;
+    readonly sessionToken?: string;
+}
+export interface S3ObjectStorageOptions {
+    /** S3 bucket name. */
+    readonly bucket: string;
+    /** AWS region.  For Cloudflare R2 use `'auto'`. */
+    readonly region: string;
+    /**
+     * Custom endpoint URL.  Use this for MinIO (`http://localhost:9000`),
+     * Cloudflare R2 (`https://<account>.r2.cloudflarestorage.com`),
+     * Backblaze B2, DigitalOcean Spaces, Wasabi.  Omit for AWS S3.
+     */
+    readonly endpoint?: string;
+    /**
+     * Force path-style URLs (`<endpoint>/<bucket>/<key>`) instead of
+     * virtual-host style (`<bucket>.<endpoint>/<key>`).  Required for
+     * MinIO and most non-AWS S3-compatible stores.
+     */
+    readonly forcePathStyle?: boolean;
+    /**
+     * Static credentials.  Omit to fall back to the SDK's default chain
+     * (env vars `AWS_ACCESS_KEY_ID`/`AWS_SECRET_ACCESS_KEY`, EC2 instance
+     * profile, IAM role for service accounts, …).
+     */
+    readonly credentials?: S3Credentials;
+    /**
+     * Allow injecting a pre-built `S3Client` — useful for tests, custom
+     * middleware, or sharing one client across multiple backends.  When
+     * provided, all other connection options are ignored.
+     */
+    readonly client?: S3ClientLike;
+}
+export declare class S3ObjectStorageBackend implements ObjectStorageBackend {
+    private readonly clientLazy;
+    private readonly bucket;
+    constructor(options: S3ObjectStorageOptions);
+    put(key: string, body: Uint8Array, opts?: PutOptions): Promise<{
+        etag: string;
+    }>;
+    get(key: string): Promise<Option<ObjectFetched>>;
+    delete(key: string): Promise<void>;
+    list(opts: {
+        prefix: string;
+        limit?: number;
+    }): Promise<ObjectInfo[]>;
+    close(): Promise<void>;
+}
+interface S3PutResult {
+    ETag?: string;
+}
+interface S3GetResult {
+    Body?: unknown;
+    ETag?: string;
+    LastModified?: Date;
+    ContentEncoding?: string;
+    ContentType?: string;
+}
+interface S3ListResult {
+    Contents?: Array<{
+        Key?: string;
+        Size?: number;
+        LastModified?: Date;
+    }>;
+    IsTruncated?: boolean;
+    NextContinuationToken?: string;
+}
+export interface S3ClientLike {
+    send(cmd: unknown): Promise<S3PutResult & S3GetResult & S3ListResult>;
+    destroy?(): void;
+}
+export {};
+//# sourceMappingURL=S3ObjectStorageBackend.d.ts.map

package/dist/persistence/object-storage/S3ObjectStorageBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"S3ObjectStorageBackend.d.ts","sourceRoot":"","sources":["../../../src/persistence/object-storage/S3ObjectStorageBackend.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,oBAAoB,EACzB,KAAK,UAAU,EAChB,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;CAChC;AAED,qBAAa,sBAAuB,YAAW,oBAAoB;IACjE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,EAAE,sBAAsB;IAcrC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IA+BpF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAyBhD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlC,IAAI,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAoCrE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B;AAoCD,UAAU,WAAW;IAAG,IAAI,CAAC,EAAE,MAAM,CAAC;CAAE;AACxC,UAAU,WAAW;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AACD,UAAU,YAAY;IACpB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;IACvE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB"}

package/dist/persistence/object-storage/S3ObjectStorageBackend.js

@@ -0,0 +1,202 @@
+import { Lazy } from '../../util/Lazy.js';
+import { none, some } from '../../util/Option.js';
+import { wrapError } from '../../util/WrapError.js';
+import { ObjectStorageBackendError, ObjectStorageConcurrencyError, } from './ObjectStorageBackend.js';
+export class S3ObjectStorageBackend {
+    clientLazy;
+    bucket;
+    constructor(options) {
+        this.bucket = options.bucket;
+        this.clientLazy = Lazy.of(async () => {
+            if (options.client)
+                return options.client;
+            const sdk = await s3SdkLazy.get();
+            return new sdk.S3Client({
+                region: options.region,
+                endpoint: options.endpoint,
+                forcePathStyle: options.forcePathStyle,
+                credentials: options.credentials,
+            });
+        });
+    }
+    async put(key, body, opts = {}) {
+        const client = await this.clientLazy.get();
+        const sdk = await s3SdkLazy.get();
+        const cmd = new sdk.PutObjectCommand({
+            Bucket: this.bucket,
+            Key: key,
+            Body: body,
+            ContentType: opts.contentType,
+            ContentEncoding: opts.contentEncoding,
+            IfMatch: opts.ifMatch,
+            IfNoneMatch: opts.ifNoneMatch,
+            ServerSideEncryption: opts.sse === 'AES256' ? 'AES256'
+                : (opts.sse && typeof opts.sse === 'object') ? 'aws:kms'
+                    : undefined,
+            SSEKMSKeyId: (opts.sse && typeof opts.sse === 'object') ? opts.sse.kmsKeyId : undefined,
+        });
+        let result;
+        try {
+            result = await client.send(cmd);
+        }
+        catch (e) {
+            if (isS3PreconditionFailed(e)) {
+                throw new ObjectStorageConcurrencyError(key, `S3 PUT rejected for ${key}: ${e.name ?? 'PreconditionFailed'}`);
+            }
+            throw wrapError(e, ObjectStorageBackendError, `S3 PUT failed for ${key}`);
+        }
+        const etag = stripQuotes(result.ETag);
+        if (!etag)
+            throw new ObjectStorageBackendError(`S3 PUT returned no ETag for ${key}`);
+        return { etag: quote(etag) };
+    }
+    async get(key) {
+        const client = await this.clientLazy.get();
+        const sdk = await s3SdkLazy.get();
+        const cmd = new sdk.GetObjectCommand({ Bucket: this.bucket, Key: key });
+        let result;
+        try {
+            result = await client.send(cmd);
+        }
+        catch (e) {
+            if (isS3NotFound(e))
+                return none;
+            throw wrapError(e, ObjectStorageBackendError, `S3 GET failed for ${key}`);
+        }
+        if (!result.Body) {
+            throw new ObjectStorageBackendError(`S3 GET for ${key} returned empty Body`);
+        }
+        const body = await readToUint8Array(result.Body);
+        const etag = stripQuotes(result.ETag);
+        if (!etag)
+            throw new ObjectStorageBackendError(`S3 GET returned no ETag for ${key}`);
+        return some({
+            body,
+            etag: quote(etag),
+            lastModified: result.LastModified ?? new Date(),
+            contentEncoding: result.ContentEncoding,
+            contentType: result.ContentType,
+        });
+    }
+    async delete(key) {
+        const client = await this.clientLazy.get();
+        const sdk = await s3SdkLazy.get();
+        const cmd = new sdk.DeleteObjectCommand({ Bucket: this.bucket, Key: key });
+        try {
+            await client.send(cmd);
+        }
+        catch (e) {
+            // S3 DELETE is already idempotent — 200/204 even when the key was absent.
+            // We only reach this branch on a real error (auth, network, …).
+            throw wrapError(e, ObjectStorageBackendError, `S3 DELETE failed for ${key}`);
+        }
+    }
+    async list(opts) {
+        const client = await this.clientLazy.get();
+        const sdk = await s3SdkLazy.get();
+        const out = [];
+        let continuationToken;
+        // Page until either we hit the soft limit or the bucket is exhausted.
+        while (true) {
+            const remaining = opts.limit ? Math.max(0, opts.limit - out.length) : undefined;
+            if (remaining === 0)
+                break;
+            const cmd = new sdk.ListObjectsV2Command({
+                Bucket: this.bucket,
+                Prefix: opts.prefix,
+                // S3 caps MaxKeys at 1000; we ask for our remaining or 1000.
+                MaxKeys: remaining ? Math.min(remaining, 1000) : 1000,
+                ContinuationToken: continuationToken,
+            });
+            let result;
+            try {
+                result = await client.send(cmd);
+            }
+            catch (e) {
+                throw wrapError(e, ObjectStorageBackendError, `S3 LIST failed for prefix=${opts.prefix}`);
+            }
+            for (const obj of result.Contents ?? []) {
+                if (!obj.Key)
+                    continue;
+                out.push({
+                    key: obj.Key,
+                    size: obj.Size ?? 0,
+                    lastModified: obj.LastModified ?? new Date(0),
+                });
+            }
+            if (!result.IsTruncated || !result.NextContinuationToken)
+                break;
+            continuationToken = result.NextContinuationToken;
+        }
+        out.sort((a, b) => a.key.localeCompare(b.key));
+        return opts.limit ? out.slice(0, opts.limit) : out;
+    }
+    async close() {
+        if (!this.clientLazy.isEvaluated)
+            return;
+        const client = await this.clientLazy.get();
+        client.destroy?.();
+    }
+}
+const s3SdkLazy = Lazy.of(async () => {
+    try {
+        const name = '@aws-sdk/client-s3';
+        return (await import(name));
+    }
+    catch (e) {
+        throw new Error('S3ObjectStorageBackend requires the "@aws-sdk/client-s3" package.  Install it with: '
+            + 'npm install @aws-sdk/client-s3\nOriginal error: '
+            + (e instanceof Error ? e.message : String(e)));
+    }
+});
+function isS3PreconditionFailed(e) {
+    if (!e || typeof e !== 'object')
+        return false;
+    const err = e;
+    return err.name === 'PreconditionFailed' || err.$metadata?.httpStatusCode === 412;
+}
+function isS3NotFound(e) {
+    if (!e || typeof e !== 'object')
+        return false;
+    const err = e;
+    return err.name === 'NoSuchKey' || err.Code === 'NoSuchKey'
+        || err.name === 'NotFound' || err.$metadata?.httpStatusCode === 404;
+}
+/**
+ * AWS SDK v3 returns `Body` as a stream-like object with helper methods
+ * (`transformToByteArray`, `transformToString`).  Bun & Node 20+ provide
+ * `.transformToByteArray()` directly; we fall back to manual stream
+ * reading for older shims.
+ */
+async function readToUint8Array(body) {
+    if (!body || typeof body !== 'object') {
+        throw new Error('S3 GET Body is not a stream object');
+    }
+    const b = body;
+    if (typeof b.transformToByteArray === 'function') {
+        return await b.transformToByteArray();
+    }
+    // Fallback: collect chunks from an async iterator.
+    const chunks = [];
+    let total = 0;
+    for await (const chunk of b) {
+        chunks.push(chunk);
+        total += chunk.length;
+    }
+    const out = new Uint8Array(total);
+    let off = 0;
+    for (const c of chunks) {
+        out.set(c, off);
+        off += c.length;
+    }
+    return out;
+}
+function stripQuotes(s) {
+    if (!s)
+        return s;
+    if (s.length >= 2 && s.startsWith('"') && s.endsWith('"'))
+        return s.slice(1, -1);
+    return s;
+}
+function quote(s) { return `"${s}"`; }
+//# sourceMappingURL=S3ObjectStorageBackend.js.map

package/dist/persistence/object-storage/S3ObjectStorageBackend.js.map

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