@toa.io/extensions.storages 1.0.0-alpha.31 → 1.0.0-alpha.310

package/transpiled/providers/S3.js

@@ -1,54 +1,21 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.S3 = void 0;
-const node_stream_1 = require("node:stream");
-const node_buffer_1 = require("node:buffer");
-const posix_1 = require("node:path/posix");
-const node_assert_1 = __importDefault(require("node:assert"));
-const node_path_1 = require("node:path");
-const lib_storage_1 = require("@aws-sdk/lib-storage");
-const client_s3_1 = require("@aws-sdk/client-s3");
-const nodeNativeFetch = __importStar(require("smithy-node-native-fetch"));
-const Provider_1 = require("../Provider");
-class S3 extends Provider_1.Provider {
-    static SECRETS = [
-        { name: 'ACCESS_KEY_ID', optional: true },
-        { name: 'SECRET_ACCESS_KEY', optional: true }
-    ];
+import { Readable } from 'node:stream';
+import { Blob } from 'node:buffer';
+import { join } from 'node:path/posix';
+import { Upload } from '@aws-sdk/lib-storage';
+import * as s3 from '@aws-sdk/client-s3';
+import { console } from 'openspan';
+import { Provider } from '../Provider.js';
+import { secrets } from '@toa.io/definitions/extensions.storages';
+import { ERR_NOT_FOUND } from '../errors.js';
+export class S3 extends Provider {
+    static SECRETS = secrets.s3;
     bucket;
     client;
     constructor(options, secrets) {
-        super(options);
+        super(options, secrets);
         this.bucket = options.bucket;
         const s3Config = {
-            retryMode: 'adaptive',
-            ...nodeNativeFetch
+            retryMode: 'adaptive'
         };
         if (options.endpoint !== undefined) {
             s3Config.forcePathStyle = options.endpoint.startsWith('http://');
@@ -57,19 +24,20 @@ class S3 extends Provider_1.Provider {
         if (options.region !== undefined)
             s3Config.region = options.region;
         if (typeof secrets?.ACCESS_KEY_ID === 'string') {
-            node_assert_1.default.ok(secrets.SECRET_ACCESS_KEY !== undefined, 'SECRET_ACCESS_KEY is required if ACCESS_KEY_ID is provided');
+            if (secrets.SECRET_ACCESS_KEY === undefined)
+                throw new Error('SECRET_ACCESS_KEY is required if ACCESS_KEY_ID is provided');
             s3Config.credentials = {
                 accessKeyId: secrets.ACCESS_KEY_ID,
                 secretAccessKey: secrets.SECRET_ACCESS_KEY
             };
         }
-        this.client = new client_s3_1.S3Client(s3Config);
+        this.client = new s3.S3Client(s3Config);
         this.client.middlewareStack.add((next, _context) => async (args) => {
+            // removes leading slash
             if ('Key' in args.input && typeof args.input.Key === 'string')
-                // removes leading slash
                 args.input.Key = args.input.Key.replace(/^\//, '');
+            // removes leading slash and ensures finishing slash
             if ('Prefix' in args.input && typeof args.input.Prefix === 'string')
-                // removes leading slash and ensures finishing slash
                 args.input.Prefix = args.input.Prefix.replace(/^\/|\/$/g, '') + '/';
             return next(args);
         }, {
@@ -79,95 +47,76 @@ class S3 extends Provider_1.Provider {
         });
     }
     async get(Key) {
-        try {
-            const fileResponse = await this.client.send(new client_s3_1.GetObjectCommand({
+        return await this.try(async () => {
+            const entry = await this.client.send(new s3.GetObjectCommand({
                 Bucket: this.bucket,
                 Key
             }));
-            if (fileResponse.Body === undefined)
-                return null; // should never happen
-            if (fileResponse.Body instanceof node_stream_1.Readable)
-                return fileResponse.Body;
-            return node_stream_1.Readable.fromWeb((fileResponse.Body instanceof node_buffer_1.Blob
-                ? fileResponse.Body.stream()
-                : fileResponse.Body)); // types mismatch between Node 20 and aws-sdk
-        }
-        catch (err) {
-            if (err instanceof client_s3_1.NotFound || err instanceof client_s3_1.NoSuchKey)
-                return null;
-            else
-                throw err;
-        }
+            const stream = entry.Body instanceof Readable
+                ? entry.Body
+                : Readable.fromWeb((entry.Body instanceof Blob
+                    ? entry.Body.stream()
+                    : entry.Body));
+            if (entry.Metadata?.value === undefined)
+                return ERR_NOT_FOUND;
+            const metadata = JSON.parse(entry.Metadata.value);
+            return { stream, ...metadata };
+        });
     }
-    async list(prefix) {
-        return (await this.listObjects(prefix))
-            .map(({ Key }) => node_path_1.posix.basename(Key));
+    async head(Key) {
+        return await this.try(async () => {
+            const entry = await this.client.send(new s3.HeadObjectCommand({
+                Bucket: this.bucket,
+                Key
+            }));
+            if (entry.Metadata?.value === undefined)
+                return ERR_NOT_FOUND;
+            return JSON.parse(entry.Metadata.value);
+        });
     }
-    async put(path, filename, stream) {
-        await new lib_storage_1.Upload({
+    async put(Key, stream) {
+        await new Upload({
             client: this.client,
             params: {
                 Bucket: this.bucket,
-                Key: (0, posix_1.join)(path, filename),
+                Key,
                 Body: stream
             }
         }).done();
     }
-    /**
-     * Deletes either a single object or "directory" - all objects
-     * with given prefix (prefix will be enforced to finish with `/`)
-     * @param Key - key name or path prefix
-     */
-    async delete(Key) {
-        const { client, bucket: Bucket } = this;
-        // checking if given key is a single file
-        if (!Key.endsWith('/'))
-            try {
-                // DeleteObject on S3 returns no error if object does not exist
-                await client.send(new client_s3_1.HeadObjectCommand({ Bucket, Key }));
-                await client.send(new client_s3_1.DeleteObjectCommand({ Bucket, Key }));
-                return;
-            }
-            catch (err) {
-                node_assert_1.default.ok(err instanceof client_s3_1.NotFound || err instanceof client_s3_1.NoSuchKey, err);
-            }
-        const objectsToRemove = await this.listObjects(Key);
-        // Removing all objects in parallel in batches
-        await Promise.all((function* () {
-            while (objectsToRemove.length > 0)
-                yield client.send(new client_s3_1.DeleteObjectsCommand({
-                    Bucket,
-                    Delete: {
-                        Objects: objectsToRemove.splice(0, 1000 /* max batch size for DeleteObjects */)
-                    }
-                }));
-        })());
-    }
-    async move(from, keyTo) {
-        await this.client.send(new client_s3_1.CopyObjectCommand({
+    async commit(Key, metadata) {
+        await this.client.send(new s3.CopyObjectCommand({
             Bucket: this.bucket,
-            Key: keyTo,
-            CopySource: (0, posix_1.join)(this.bucket, from)
+            Key,
+            CopySource: join(this.bucket, Key),
+            Metadata: { value: JSON.stringify(metadata) },
+            MetadataDirective: 'REPLACE'
         }));
-        await this.client.send(new client_s3_1.DeleteObjectCommand({ Bucket: this.bucket, Key: from }));
+        console.debug('Uploaded to S3', { bucket: this.bucket, path: Key, metadata });
     }
-    async moveDir(from, to) {
-        const objects = await this.listObjects(from);
-        await Promise.all(objects.map(async ({ Key }) => {
-            const ent = node_path_1.posix.basename(Key);
-            const source = node_path_1.posix.join(from, ent);
-            const target = node_path_1.posix.join(to, ent);
-            return this.move(source, target);
-        }));
+    async delete(Key) {
+        await this.client.send(new s3.DeleteObjectCommand({ Bucket: this.bucket, Key }));
     }
-    async listObjects(Prefix) {
-        const { client, bucket: Bucket } = this;
-        const objects = [];
-        for await (const page of (0, client_s3_1.paginateListObjectsV2)({ client }, { Bucket, Prefix }))
-            for (const { Key } of page.Contents ?? [])
-                objects.push({ Key });
-        return objects;
+    async move(from, keyTo) {
+        return await this.try(async () => {
+            await this.client.send(new s3.CopyObjectCommand({
+                Bucket: this.bucket,
+                Key: keyTo,
+                CopySource: join(this.bucket, from)
+            }));
+            await this.client.send(new s3.DeleteObjectCommand({ Bucket: this.bucket, Key: from }));
+        });
+    }
+    async try(action) {
+        try {
+            return await action();
+        }
+        catch (err) {
+            if (err?.name === 'NotFound' || err?.name === 'NoSuchKey')
+                return ERR_NOT_FOUND;
+            else
+                throw err;
+        }
     }
 }
-exports.S3 = S3;
 //# sourceMappingURL=S3.js.map

package/transpiled/providers/S3.js.map

@@ -1 +1 @@
-{"version":3,"file":"S3.js","sourceRoot":"","sources":["../../source/providers/S3.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAAsC;AACtC,6CAAkC;AAClC,2CAAsC;AACtC,8DAAgC;AAChC,yCAAiC;AACjC,sDAA6C;AAC7C,kDAY2B;AAC3B,0EAA2D;AAC3D,0CAAiF;AAYjF,MAAa,EAAG,SAAQ,mBAAmB;IAClC,MAAM,CAAmB,OAAO,GAA8B;QACnE,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE;QACzC,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC9C,CAAA;IAEkB,MAAM,CAAQ;IACd,MAAM,CAAU;IAEnC,YAAoB,OAAkB,EAAE,OAAmB;QACzD,KAAK,CAAC,OAAO,CAAC,CAAA;QAEd,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;QAE5B,MAAM,QAAQ,GAAuB;YACnC,SAAS,EAAE,UAAU;YACrB,GAAG,eAAe;SACnB,CAAA;QAED,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACnC,QAAQ,CAAC,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;YAChE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;QACtC,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,QAAQ,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;QAElE,IAAI,OAAO,OAAO,EAAE,aAAa,KAAK,QAAQ,EAAE,CAAC;YAC/C,qBAAM,CAAC,EAAE,CAAC,OAAO,CAAC,iBAAiB,KAAK,SAAS,EAC/C,4DAA4D,CAAC,CAAA;YAE/D,QAAQ,CAAC,WAAW,GAAG;gBACrB,WAAW,EAAE,OAAO,CAAC,aAAa;gBAClC,eAAe,EAAE,OAAO,CAAC,iBAAiB;aAC3C,CAAA;QACH,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,oBAAQ,CAAC,QAAQ,CAAC,CAAA;QAEpC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACjE,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,QAAQ;gBAC7D,wBAAwB;gBAEtB,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;YAEpD,IAAI,QAAQ,IAAI,IAAI,CAAC,KAAK,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ;gBACnE,oDAAoD;gBAElD,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,GAAG,GAAG,CAAA;YAErE,OAAO,IAAI,CAAC,IAAI,CAAC,CAAA;QACnB,CAAC,EACD;YACE,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,MAAM;YAChB,IAAI,EAAE,yBAAyB;SAChC,CAAC,CAAA;IACJ,CAAC;IAEM,KAAK,CAAC,GAAG,CAAE,GAAW;QAC3B,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,4BAAgB,CAAC;gBAC/D,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,GAAG;aACJ,CAAC,CAAC,CAAA;YAEH,IAAI,YAAY,CAAC,IAAI,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAA,CAAC,sBAAsB;YAEvE,IAAI,YAAY,CAAC,IAAI,YAAY,sBAAQ;gBAAE,OAAO,YAAY,CAAC,IAAI,CAAA;YAEnE,OAAO,sBAAQ,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,IAAI,YAAY,kBAAI;gBACxD,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE;gBAC5B,CAAC,CAAC,YAAY,CAAC,IAAI,CAAmB,CAAC,CAAA,CAAC,6CAA6C;QACzF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,oBAAQ,IAAI,GAAG,YAAY,qBAAS;gBACrD,OAAO,IAAI,CAAA;;gBAEX,MAAM,GAAG,CAAA;QACb,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,IAAI,CAAE,MAAc;QAC/B,OAAO,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;aACpC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,iBAAK,CAAC,QAAQ,CAAC,GAAI,CAAC,CAAC,CAAA;IAC3C,CAAC;IAEM,KAAK,CAAC,GAAG,CAAE,IAAY,EAAE,QAAgB,EAAE,MAAgB;QAChE,MAAM,IAAI,oBAAM,CAAC;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE;gBACN,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,GAAG,EAAE,IAAA,YAAI,EAAC,IAAI,EAAE,QAAQ,CAAC;gBACzB,IAAI,EAAE,MAAM;aACb;SACF,CAAC,CAAC,IAAI,EAAE,CAAA;IACX,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,MAAM,CAAE,GAAW;QAC9B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;QAEvC,yCAAyC;QACzC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YACpB,IAAI,CAAC;gBACH,+DAA+D;gBAC/D,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,6BAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAA;gBACzD,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,+BAAmB,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAA;gBAE3D,OAAM;YACR,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,qBAAM,CAAC,EAAE,CAAC,GAAG,YAAY,oBAAQ,IAAI,GAAG,YAAY,qBAAS,EAAE,GAAY,CAAC,CAAA;YAC9E,CAAC;QAEH,MAAM,eAAe,GAAuB,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;QAEvE,8CAA8C;QAC9C,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,QAAS,CAAC;YAC3B,OAAO,eAAe,CAAC,MAAM,GAAG,CAAC;gBAC/B,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,gCAAoB,CAAC;oBACzC,MAAM;oBACN,MAAM,EAAE;wBACN,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,EAC/B,IAAI,CAAC,sCAAsC,CAAC;qBAC/C;iBACF,CAAC,CAAC,CAAA;QACP,CAAC,CAAC,EAAE,CAAC,CAAA;IACP,CAAC;IAEM,KAAK,CAAC,IAAI,CAAE,IAAY,EAAE,KAAa;QAC5C,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,6BAAiB,CAAC;YAC3C,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,KAAK;YACV,UAAU,EAAE,IAAA,YAAI,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC;SACpC,CAAC,CAAC,CAAA;QAEH,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,+BAAmB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IACrF,CAAC;IAEM,KAAK,CAAC,OAAO,CAAE,IAAY,EAAE,EAAU;QAC5C,MAAM,OAAO,GAAuB,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;QAEhE,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;YAC9C,MAAM,GAAG,GAAG,iBAAK,CAAC,QAAQ,CAAC,GAAI,CAAC,CAAA;YAChC,MAAM,MAAM,GAAG,iBAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;YACpC,MAAM,MAAM,GAAG,iBAAK,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;YAElC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAClC,CAAC,CAAC,CAAC,CAAA;IACL,CAAC;IAEO,KAAK,CAAC,WAAW,CAAE,MAAc;QACvC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;QACvC,MAAM,OAAO,GAAuB,EAAE,CAAA;QAEtC,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,IAAA,iCAAqB,EAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YAC5E,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE;gBACvC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;QAEzB,OAAO,OAAO,CAAA;IAChB,CAAC;;AAlKH,gBAmKC"}
+{"version":3,"file":"S3.js","sourceRoot":"","sources":["../../source/providers/S3.ts"],"names":[],"mappings":"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"}

package/transpiled/providers/Spaces.d.ts

@@ -0,0 +1,12 @@
+import { S3 } from './S3.ts';
+import type { Secret, Secrets } from '../Secrets.ts';
+export interface SpacesOptions {
+    space: string;
+    region: string;
+}
+type SpacesSecrets = Secrets<'ACCESS_KEY_ID' | 'SECRET_ACCESS_KEY'>;
+export declare class Spaces extends S3 {
+    static readonly SECRETS: readonly Secret[];
+    constructor(options: SpacesOptions, secrets?: SpacesSecrets);
+}
+export {};

package/transpiled/providers/Spaces.js

@@ -0,0 +1,13 @@
+import { S3 } from './S3.js';
+import { secrets } from '@toa.io/definitions/extensions.storages';
+export class Spaces extends S3 {
+    static SECRETS = secrets.spaces;
+    constructor(options, secrets) {
+        super({
+            bucket: options.space,
+            region: options.region,
+            endpoint: `https://${options.region}.digitaloceanspaces.com`
+        }, secrets);
+    }
+}
+//# sourceMappingURL=Spaces.js.map

package/transpiled/providers/Spaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Spaces.js","sourceRoot":"","sources":["../../source/providers/Spaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAA;AAUjE,MAAM,OAAO,MAAO,SAAQ,EAAE;IACrB,MAAM,CAAmB,OAAO,GAAsB,OAAO,CAAC,MAAM,CAAA;IAE3E,YAAmB,OAAsB,EAAE,OAAuB;QAChE,KAAK,CACH;YACE,MAAM,EAAE,OAAO,CAAC,KAAK;YACrB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,WAAW,OAAO,CAAC,MAAM,yBAAyB;SAC7D,EACD,OAAO,CACR,CAAA;IACH,CAAC;CACF"}

package/transpiled/providers/Temporary.d.ts

@@ -1,8 +1,7 @@
-import { FileSystem } from './FileSystem';
-import type { ProviderSecrets } from '../Provider';
+import { FileSystem } from './FileSystem.ts';
 export interface TemporaryOptions {
     directory: string;
 }
 export declare class Temporary extends FileSystem {
-    constructor(options: TemporaryOptions, secrets?: ProviderSecrets);
+    constructor(options: TemporaryOptions);
 }

package/transpiled/providers/Temporary.js

@@ -1,14 +1,10 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Temporary = void 0;
-const node_os_1 = require("node:os");
-const node_path_1 = require("node:path");
-const FileSystem_1 = require("./FileSystem");
-class Temporary extends FileSystem_1.FileSystem {
-    constructor(options, secrets) {
-        const path = (0, node_path_1.join)((0, node_os_1.tmpdir)(), options.directory);
-        super({ path }, secrets);
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { FileSystem } from './FileSystem.js';
+export class Temporary extends FileSystem {
+    constructor(options) {
+        const path = join(tmpdir(), options.directory);
+        super({ path });
     }
 }
-exports.Temporary = Temporary;
 //# sourceMappingURL=Temporary.js.map

package/transpiled/providers/Temporary.js.map

@@ -1 +1 @@
-{"version":3,"file":"Temporary.js","sourceRoot":"","sources":["../../source/providers/Temporary.ts"],"names":[],"mappings":";;;AAAA,qCAAgC;AAChC,yCAAgC;AAChC,6CAAyC;AAOzC,MAAa,SAAU,SAAQ,uBAAU;IACvC,YAAoB,OAAyB,EAAE,OAAyB;QACtE,MAAM,IAAI,GAAG,IAAA,gBAAI,EAAC,IAAA,gBAAM,GAAE,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;QAE9C,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAA;IAC1B,CAAC;CACF;AAND,8BAMC"}
+{"version":3,"file":"Temporary.js","sourceRoot":"","sources":["../../source/providers/Temporary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAM5C,MAAM,OAAO,SAAU,SAAQ,UAAU;IACvC,YAAmB,OAAyB;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;QAE9C,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAA;IACjB,CAAC;CACF"}

package/transpiled/providers/Test.d.ts

@@ -1,6 +1,6 @@
-import { Temporary, type TemporaryOptions } from './Temporary';
-import type { ProviderSecret, ProviderSecrets } from '../Provider';
+import { Temporary, type TemporaryOptions } from './Temporary.ts';
+import type { Secret } from '../Secrets.ts';
 export declare class Test extends Temporary {
-    static readonly SECRETS: readonly ProviderSecret[];
-    constructor(options: TemporaryOptions, secrets?: ProviderSecrets);
+    static readonly SECRETS: readonly Secret[];
+    constructor(options: TemporaryOptions);
 }

package/transpiled/providers/Test.js

@@ -1,15 +1,9 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Test = void 0;
-const Temporary_1 = require("./Temporary");
-class Test extends Temporary_1.Temporary {
-    static SECRETS = [
-        { name: 'USERNAME' },
-        { name: 'PASSWORD' }
-    ];
-    constructor(options, secrets) {
-        super(options, secrets);
+import { Temporary } from './Temporary.js';
+import { secrets } from '@toa.io/definitions/extensions.storages';
+export class Test extends Temporary {
+    static SECRETS = secrets.test;
+    constructor(options) {
+        super(options);
     }
 }
-exports.Test = Test;
 //# sourceMappingURL=Test.js.map

package/transpiled/providers/Test.js.map

@@ -1 +1 @@
-{"version":3,"file":"Test.js","sourceRoot":"","sources":["../../source/providers/Test.ts"],"names":[],"mappings":";;;AAAA,2CAA8D;AAG9D,MAAa,IAAK,SAAQ,qBAAS;IAC1B,MAAM,CAAmB,OAAO,GAA8B;QACnE,EAAE,IAAI,EAAE,UAAU,EAAE;QACpB,EAAE,IAAI,EAAE,UAAU,EAAE;KACrB,CAAA;IAED,YAAoB,OAAyB,EAAE,OAAyB;QACtE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACzB,CAAC;;AARH,oBASC"}
+{"version":3,"file":"Test.js","sourceRoot":"","sources":["../../source/providers/Test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAyB,MAAM,gBAAgB,CAAA;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAA;AAGjE,MAAM,OAAO,IAAK,SAAQ,SAAS;IAC1B,MAAM,CAAmB,OAAO,GAAsB,OAAO,CAAC,IAAI,CAAA;IAEzE,YAAmB,OAAyB;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAA;IAChB,CAAC;CACF"}

package/transpiled/providers/index.d.ts

@@ -1,13 +1,25 @@
-import { FileSystem } from './FileSystem';
-import { S3 } from './S3';
-import { Temporary } from './Temporary';
-import { Test } from './Test';
-import { InMemory } from './Memory';
+import type { Constructor } from '../Provider.ts';
+/**
+ * A provider is loaded when a storage names it: the SDK one is written against is not paid
+ * for by a process that declares another, and is not installed by one either — it is an
+ * optional peer of this package, which a deploy installs for the storages a component
+ * declares. See `provider` below for what a workspace that has not gets told.
+ */
 export declare const providers: {
-    readonly s3: typeof S3;
-    readonly fs: typeof FileSystem;
-    readonly tmp: typeof Temporary;
-    readonly mem: typeof InMemory;
-    readonly test: typeof Test;
+    readonly s3: () => Promise<typeof import("./S3.ts").S3>;
+    readonly spaces: () => Promise<typeof import("./Spaces.ts").Spaces>;
+    readonly cloudinary: () => Promise<typeof import("./Cloudinary.ts").Cloudinary>;
+    readonly fs: () => Promise<typeof import("./FileSystem.ts").FileSystem>;
+    readonly tmp: () => Promise<typeof import("./Temporary.ts").Temporary>;
+    readonly test: () => Promise<typeof import("./Test.ts").Test>;
 };
-export type { Declaration } from './Declaration';
+export type Id = keyof typeof providers;
+/** The provider a declaration names, or what to install to have it. */
+export declare function provider(id: Id): Promise<Constructor>;
+export type { Declaration } from './Declaration.ts';
+export type { S3Options } from './S3.ts';
+export type { SpacesOptions } from './Spaces.ts';
+export type { CloudinaryOptions } from './Cloudinary.ts';
+export type { FileSystemOptions } from './FileSystem.ts';
+export type { TemporaryOptions } from './Temporary.ts';
+export type { FileSystem, S3, Spaces, Cloudinary, Temporary } from './index.types.ts';

package/transpiled/providers/index.js

@@ -1,16 +1,32 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.providers = void 0;
-const FileSystem_1 = require("./FileSystem");
-const S3_1 = require("./S3");
-const Temporary_1 = require("./Temporary");
-const Test_1 = require("./Test");
-const Memory_1 = require("./Memory");
-exports.providers = {
-    s3: S3_1.S3,
-    fs: FileSystem_1.FileSystem,
-    tmp: Temporary_1.Temporary,
-    mem: Memory_1.InMemory,
-    test: Test_1.Test
+import { packages } from '@toa.io/definitions/extensions.storages';
+/**
+ * A provider is loaded when a storage names it: the SDK one is written against is not paid
+ * for by a process that declares another, and is not installed by one either — it is an
+ * optional peer of this package, which a deploy installs for the storages a component
+ * declares. See `provider` below for what a workspace that has not gets told.
+ */
+export const providers = {
+    s3: async () => (await import('./S3.js')).S3,
+    spaces: async () => (await import('./Spaces.js')).Spaces,
+    cloudinary: async () => (await import('./Cloudinary.js')).Cloudinary,
+    fs: async () => (await import('./FileSystem.js')).FileSystem,
+    tmp: async () => (await import('./Temporary.js')).Temporary,
+    test: async () => (await import('./Test.js')).Test
 };
+/** The provider a declaration names, or what to install to have it. */
+export async function provider(id) {
+    try {
+        return await providers[id]();
+    }
+    catch (error) {
+        const missing = Object.entries(packages[id]).map(([name, version]) => `${name}@${version}`);
+        if (missing.length === 0 || !isMissingModule(error))
+            throw error;
+        throw new Error(`Storage provider '${id}' needs ${missing.join(' ')}, which is not installed. ` +
+            `\`toa npm\` installs what this context's components declare.`, { cause: error });
+    }
+}
+function isMissingModule(error) {
+    return error?.code === 'ERR_MODULE_NOT_FOUND';
+}
 //# sourceMappingURL=index.js.map

package/transpiled/providers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/providers/index.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;AACzC,6BAAyB;AACzB,2CAAuC;AACvC,iCAA6B;AAC7B,qCAAmC;AAGtB,QAAA,SAAS,GAAG;IACvB,EAAE,EAAE,OAAE;IACN,EAAE,EAAE,uBAAU;IACd,GAAG,EAAE,qBAAS;IACd,GAAG,EAAE,iBAAQ;IACb,IAAI,EAAE,WAAI;CAC4C,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAA;AAGlE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;IAC5C,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM;IACxD,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,UAAU;IACpE,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,UAAU;IAC5D,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;IAC3D,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI;CACW,CAAA;AAI/D,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,EAAM;IACnC,IAAI,CAAC;QACH,OAAO,MAAM,SAAS,CAAC,EAAE,CAAC,EAAE,CAAA;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAC9C,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,OAAO,EAAE,CAC1C,CAAA;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAA;QAEhE,MAAM,IAAI,KAAK,CACb,qBAAqB,EAAE,WAAW,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,4BAA4B;YAC7E,8DAA8D,EAChE,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAA;IACH,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAQ,KAA2B,EAAE,IAAI,KAAK,sBAAsB,CAAA;AACtE,CAAC"}

package/transpiled/providers/index.types.d.ts

@@ -0,0 +1,5 @@
+export type { FileSystem } from './FileSystem.ts';
+export type { S3 } from './S3.ts';
+export type { Spaces } from './Spaces.ts';
+export type { Cloudinary } from './Cloudinary.ts';
+export type { Temporary } from './Temporary.ts';

package/transpiled/providers/index.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.types.js.map

package/transpiled/providers/index.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.types.js","sourceRoot":"","sources":["../../source/providers/index.types.ts"],"names":[],"mappings":""}