@toa.io/extensions.storages 1.0.0-alpha.13 → 1.0.0-alpha.143

package/source/providers/index.ts

@@ -1,16 +1,21 @@
 import { FileSystem } from './FileSystem'
 import { S3 } from './S3'
+import { Cloudinary } from './Cloudinary'
 import { Temporary } from './Temporary'
 import { Test } from './Test'
-import { InMemory } from './Memory'
-import type { ProviderConstructor } from '../Provider'
+import type { Constructor } from '../Provider'
 
 export const providers = {
   s3: S3,
+  cloudinary: Cloudinary,
   fs: FileSystem,
   tmp: Temporary,
-  mem: InMemory,
   test: Test
-} as const satisfies Record<string, ProviderConstructor>
+} as const satisfies Record<string, Constructor>
 
 export type { Declaration } from './Declaration'
+
+export type { S3Options } from './S3'
+export type { CloudinaryOptions } from './Cloudinary'
+export type { FileSystemOptions } from './FileSystem'
+export type { TemporaryOptions } from './Temporary'

package/source/schemas.ts

@@ -9,6 +9,7 @@ const ns = namespace(path)
 
 export const annotation: Schema<Annotation> = ns.schema<Annotation>('annotation')
 export const s3: Schema<Declaration> = ns.schema<Declaration>('s3')
+export const cloudinary: Schema<Declaration> = ns.schema<Declaration>('cloudinary')
 export const fs: Schema<Declaration> = ns.schema<Declaration>('fs')
 export const mem: Schema<Declaration> = ns.schema<Declaration>('mem')
 export const tmp: Schema<Declaration> = ns.schema<Declaration>('tmp')

package/source/test/.env.example

@@ -1 +1,5 @@
 RUN_S3=1
+RUN_CLOUDINARY=1
+
+CLOUDINARY_API_KEY=cloudinary_api_key
+CLOUDINARY_API_SECRET=cloudinary_api_secret

package/source/test/sample.svg

@@ -0,0 +1,4 @@
+<svg width="160" height="160" viewBox="0 0 160 160" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect width="160" height="160" rx="6" fill="white"/>
+<path d="M83.8172 117.311H77.1506V75.6034C76.519 64.0461 71.2424 54.9753 62.4955 50.5487C55.8003 47.163 48.1655 47.3486 43.0436 51.0295C40.1688 53.0962 38.5807 55.5676 38.1898 58.5867C37.3617 64.9771 42.1922 72.4486 44.1231 74.7915L38.9812 79.0344C38.6222 78.5963 30.2131 68.2629 31.5783 57.7295C32.2107 52.8533 34.7593 48.7772 39.1526 45.6153C46.3817 40.42 56.4798 40.0343 65.5055 44.601C72.2494 48.0136 77.4112 53.7335 80.5225 60.9231C83.6337 53.7335 88.7954 48.0137 95.539 44.601C104.566 40.0343 114.664 40.42 121.892 45.6153C126.286 48.7772 128.834 52.8533 129.467 57.7295C130.832 68.2629 122.423 78.5963 122.064 79.0344L116.918 74.7963C116.988 74.7106 123.858 66.2201 122.853 58.5677C122.457 55.5582 120.87 53.0914 118.001 51.0295C112.879 47.3486 105.244 47.1582 98.5495 50.5487C89.5949 55.0803 84.2775 64.4793 83.8573 76.4304C83.8678 76.7653 83.8748 77.1016 83.8783 77.4392L83.8335 77.4396C83.8333 77.4617 83.833 77.4837 83.8328 77.5058L83.8172 77.5056V117.311Z" fill="#323232"/>
+</svg>

package/source/test/util.ts

@@ -1,10 +1,13 @@
 import { join } from 'node:path'
 import dotenv from 'dotenv'
-import type { ProviderSecrets } from '../Provider'
-import type { providers } from '../providers'
-import type { FileSystemOptions } from '../providers/FileSystem'
-import type { S3Options } from '../providers/S3'
-import type { TemporaryOptions } from '../providers/Temporary'
+import type { Secrets } from '../Secrets'
+import type {
+  providers,
+  S3Options,
+  CloudinaryOptions,
+  FileSystemOptions,
+  TemporaryOptions
+} from '../providers'
 
 dotenv.config({ path: join(__dirname, '.env') })
 
@@ -16,10 +19,6 @@ export const suites = [
       directory: 'toa-storages-temp'
     }
   },
-  {
-    run: true,
-    provider: 'mem'
-  },
   {
     run: process.env.RUN_S3 === '1',
     provider: 's3',
@@ -32,14 +31,57 @@ export const suites = [
       ACCESS_KEY_ID: 'developer',
       SECRET_ACCESS_KEY: 'secret'
     }
+  },
+  {
+    run: process.env.RUN_CLOUDINARY === '1',
+    provider: 'cloudinary',
+    options: {
+      environment: 'dl5z4zgth',
+      type: 'image',
+      prefix: 'toa-dev',
+      transformations: [
+        {
+          extension: '(?<width>\\d*)x(?<height>\\d*)(z(?<zoom>\\d*))?',
+          transformation: {
+            width: '<width>',
+            height: '<height>',
+            zoom: '<zoom>',
+            crop: 'thumb',
+            gravity: 'face'
+          },
+          optional: true
+        },
+        {
+          extension: '\\[(?<width>\\d*)x(?<height>\\d*)\\](z(?<zoom>\\d+))?',
+          transformation: {
+            width: '<width>',
+            height: '<height>',
+            zoom: '<zoom>',
+            crop: 'fit'
+          },
+          optional: true
+        },
+        {
+          extension: '(?<format>jpeg|webp)',
+          transformation: {
+            fetch_format: '<format>'
+          },
+          optional: true
+        }
+      ]
+    },
+    secrets: {
+      API_KEY: process.env.CLOUDINARY_API_KEY ?? '',
+      API_SECRET: process.env.CLOUDINARY_API_SECRET ?? ''
+    }
   }
   // add more providers here, use `run` as a condition to run the test
   // e.g.: `run: process.env.ACCESS_KEY_ID !== undefined`
 ] satisfies Suite[]
 
-interface Suite {
+export interface Suite {
   run: boolean
   provider: keyof typeof providers
-  options?: FileSystemOptions | S3Options | TemporaryOptions
-  secrets?: ProviderSecrets
+  options?: S3Options | CloudinaryOptions | FileSystemOptions | TemporaryOptions
+  secrets?: Secrets
 }

package/transpiled/Entry.d.ts

@@ -1,14 +1,16 @@
-export interface Entry {
+/// <reference types="node" />
+import type { Readable } from 'node:stream';
+export type Entry = {
     id: string;
-    size: number;
+} & Metadata;
+export type Stream = {
+    stream: Readable;
+} & Metadata;
+export interface Metadata {
     type: string;
-    created: number;
-    variants: Variant[];
-    meta: Record<string, unknown>;
-}
-interface Variant {
-    name: string;
     size: number;
-    type: string;
+    checksum: string;
+    created: string;
+    attributes: Attributes;
 }
-export {};
+export type Attributes = Record<string, string>;

package/transpiled/Factory.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Factory = void 0;
 const node_assert_1 = __importDefault(require("node:assert"));
+const openspan_1 = require("openspan");
 const generic_1 = require("@toa.io/generic");
 const providers_1 = require("./providers");
 const Storage_1 = require("./Storage");
@@ -14,8 +15,8 @@ const Annotation_1 = require("./Annotation");
 class Factory {
     annotation;
     constructor() {
-        const env = process.env.TOA_STORAGES;
-        node_assert_1.default.ok(env !== undefined, 'TOA_STORAGES is not defined');
+        const env = process.env[deployment_1.ENV_PREFIX];
+        node_assert_1.default.ok(env !== undefined, `${deployment_1.ENV_PREFIX} is not defined`);
         this.annotation = (0, generic_1.decode)(env);
         (0, Annotation_1.validateAnnotation)(this.annotation);
     }
@@ -30,10 +31,15 @@ class Factory {
         return storages;
     }
     createStorage(name, declaration) {
-        const { provider: providerId, ...options } = declaration;
-        const Provider = providers_1.providers[providerId];
+        const { provider: id, ...options } = declaration;
+        const Provider = providers_1.providers[id];
         const secrets = this.resolveSecrets(name, Provider);
         const provider = new Provider(options, secrets);
+        openspan_1.console.debug('Storage created', {
+            name,
+            provider: id,
+            ...(provider.root === undefined ? undefined : { root: provider.root })
+        });
         return new Storage_1.Storage(provider);
     }
     resolveSecrets(storageName, Class) {
@@ -41,7 +47,7 @@ class Factory {
             return {};
         const secrets = {};
         for (const secret of Class.SECRETS) {
-            const variable = `${deployment_1.SERIALIZATION_PREFIX}_${storageName}_${secret.name}`.toUpperCase();
+            const variable = `${deployment_1.ENV_PREFIX}_${storageName}_${secret.name}`.toUpperCase();
             const value = process.env[variable];
             node_assert_1.default.ok(secret.optional === true || value !== undefined, `'${variable}' is not defined`);
             secrets[secret.name] = value;

package/transpiled/Factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"Factory.js","sourceRoot":"","sources":["../source/Factory.ts"],"names":[],"mappings":";;;;;;AAAA,8DAAgC;AAChC,6CAAwC;AACxC,2CAAuC;AACvC,uCAAkD;AAClD,qCAAiC;AACjC,6CAAmD;AACnD,6CAAiD;AAKjD,MAAa,OAAO;IACD,UAAU,CAAY;IAEvC;QACE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAA;QAEpC,qBAAM,CAAC,EAAE,CAAC,GAAG,KAAK,SAAS,EAAE,6BAA6B,CAAC,CAAA;QAE3D,IAAI,CAAC,UAAU,GAAG,IAAA,gBAAM,EAAC,GAAG,CAAC,CAAA;QAE7B,IAAA,+BAAkB,EAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACrC,CAAC;IAEM,MAAM;QACX,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAA;QAEtC,OAAO,IAAI,eAAM,CAAC,QAAQ,CAAC,CAAA;IAC7B,CAAC;IAEO,cAAc;QACpB,MAAM,QAAQ,GAAa,EAAE,CAAA;QAE7B,KAAK,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;YAC/D,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;QAExD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAEO,aAAa,CAAE,IAAY,EAAE,WAAwB;QAC3D,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,EAAE,GAAG,WAAW,CAAA;QACxD,MAAM,QAAQ,GAAwB,qBAAS,CAAC,UAAU,CAAC,CAAA;QAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;QACnD,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAE/C,OAAO,IAAI,iBAAO,CAAC,QAAQ,CAAC,CAAA;IAC9B,CAAC;IAEO,cAAc,CAAE,WAAmB,EACzC,KAA0B;QAC1B,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;YAC7B,OAAO,EAAE,CAAA;QAEX,MAAM,OAAO,GAAuC,EAAE,CAAA;QAEtD,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,GAAG,iCAAoB,IAAI,WAAW,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;YACtF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YAEnC,qBAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EACvD,IAAI,QAAQ,kBAAkB,CAAC,CAAA;YAEjC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;QAC9B,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;CACF;AAxDD,0BAwDC"}
+{"version":3,"file":"Factory.js","sourceRoot":"","sources":["../source/Factory.ts"],"names":[],"mappings":";;;;;;AAAA,8DAAgC;AAChC,uCAAkC;AAClC,6CAAwC;AACxC,2CAAuC;AACvC,uCAAkD;AAClD,qCAAiC;AACjC,6CAAyC;AACzC,6CAAiD;AAMjD,MAAa,OAAO;IACD,UAAU,CAAY;IAEvC;QACE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAU,CAAC,CAAA;QAEnC,qBAAM,CAAC,EAAE,CAAC,GAAG,KAAK,SAAS,EAAE,GAAG,uBAAU,iBAAiB,CAAC,CAAA;QAE5D,IAAI,CAAC,UAAU,GAAG,IAAA,gBAAM,EAAC,GAAG,CAAC,CAAA;QAE7B,IAAA,+BAAkB,EAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACrC,CAAC;IAEM,MAAM;QACX,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAA;QAEtC,OAAO,IAAI,eAAM,CAAC,QAAQ,CAAC,CAAA;IAC7B,CAAC;IAEO,cAAc;QACpB,MAAM,QAAQ,GAAa,EAAE,CAAA;QAE7B,KAAK,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;YAC/D,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;QAExD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAEO,aAAa,CAAE,IAAY,EAAE,WAAwB;QAC3D,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,WAAW,CAAA;QAChD,MAAM,QAAQ,GAAgB,qBAAS,CAAC,EAAE,CAAC,CAAA;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;QACnD,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAE/C,kBAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE;YAC/B,IAAI;YACJ,QAAQ,EAAE,EAAE;YACZ,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;SACvE,CAAC,CAAA;QAEF,OAAO,IAAI,iBAAO,CAAC,QAAQ,CAAC,CAAA;IAC9B,CAAC;IAEO,cAAc,CAAE,WAAmB,EAAE,KAAkB;QAC7D,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;YAC7B,OAAO,EAAE,CAAA;QAEX,MAAM,OAAO,GAAuC,EAAE,CAAA;QAEtD,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,GAAG,uBAAU,IAAI,WAAW,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;YAC5E,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YAEnC,qBAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EACvD,IAAI,QAAQ,kBAAkB,CAAC,CAAA;YAEjC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;QAC9B,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;CACF;AA7DD,0BA6DC"}

package/transpiled/Provider.d.ts

@@ -1,20 +1,20 @@
 /// <reference types="node" />
-import { type Readable } from 'node:stream';
-export type ProviderSecrets<K extends string = string> = Record<K | string, string | undefined>;
-export interface ProviderSecret {
-    readonly name: string;
-    readonly optional?: boolean;
-}
+import type { Metadata, Stream } from './Entry';
+import type { Readable } from 'node:stream';
+import type { Maybe } from '@toa.io/types';
+import type { Secret, Secrets } from './Secrets';
 export declare abstract class Provider<Options = void> {
-    static readonly SECRETS: readonly ProviderSecret[];
-    constructor(_: Options, secrets?: ProviderSecrets);
-    abstract get(path: string): Promise<Readable | null>;
-    abstract put(path: string, filename: string, stream: Readable): Promise<void>;
+    static readonly SECRETS?: readonly Secret[];
+    readonly root?: string;
+    protected constructor(_: Options, secrets?: Secrets);
+    abstract get(path: string): Promise<Maybe<Stream>>;
+    abstract head(path: string): Promise<Maybe<Metadata>>;
+    abstract put(path: string, stream: Readable): Promise<void>;
+    abstract commit(path: string, metadata: Metadata): Promise<void>;
     abstract delete(path: string): Promise<void>;
-    abstract move(from: string, to: string): Promise<void>;
+    abstract move(from: string, to: string): Promise<Maybe<void>>;
 }
-export interface ProviderConstructor {
-    readonly SECRETS: readonly ProviderSecret[];
-    prototype: Provider;
-    new (options: any, secrets?: ProviderSecrets): Provider;
+export interface Constructor {
+    SECRETS?: readonly Secret[];
+    new (options: any, secrets?: Secrets): Provider;
 }

package/transpiled/Provider.js

@@ -26,10 +26,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Provider = void 0;
 const assert = __importStar(require("node:assert"));
 class Provider {
-    static SECRETS = [];
+    static SECRETS;
+    root;
     constructor(_, secrets) {
-        for (const { name, optional = false } of new.target.SECRETS)
-            assert.ok(optional || secrets?.[name] !== undefined, `Missing secret '${name}'`);
+        new.target.SECRETS?.forEach(({ name, optional }) => assert.ok(optional === true || secrets?.[name] !== undefined, `Missing secret '${name}'`));
     }
 }
 exports.Provider = Provider;

package/transpiled/Provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"Provider.js","sourceRoot":"","sources":["../source/Provider.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AACA,oDAAqC;AASrC,MAAsB,QAAQ;IACrB,MAAM,CAAU,OAAO,GAA8B,EAAE,CAAA;IAE9D,YAAoB,CAAU,EAAE,OAAyB;QACvD,KAAK,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,KAAK,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO;YACzD,MAAM,CAAC,EAAE,CAAC,QAAQ,IAAI,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,mBAAmB,IAAI,GAAG,CAAC,CAAA;IACpF,CAAC;;AANH,4BAeC"}
+{"version":3,"file":"Provider.js","sourceRoot":"","sources":["../source/Provider.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,oDAAqC;AAMrC,MAAsB,QAAQ;IACrB,MAAM,CAAU,OAAO,CAAoB;IAClC,IAAI,CAAS;IAE7B,YAAuB,CAAU,EAAE,OAAiB;QAClD,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CACjD,MAAM,CAAC,EAAE,CAAC,QAAQ,KAAK,IAAI,IAAI,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,mBAAmB,IAAI,GAAG,CAAC,CAAC,CAAA;IAC9F,CAAC;CAaF;AApBD,4BAoBC"}

package/transpiled/Scanner.d.ts

@@ -4,12 +4,13 @@ import { PassThrough, type TransformCallback } from 'node:stream';
 export declare class Scanner extends PassThrough {
     size: number;
     type: string;
-    error: Error | null;
+    error?: Error;
     private readonly hash;
     private readonly claim?;
     private readonly accept?;
+    private readonly limit?;
     private position;
-    private detected;
+    private completed;
     private readonly chunks;
     constructor(control?: ScanOptions);
     digest(): string;
@@ -18,9 +19,11 @@ export declare class Scanner extends PassThrough {
     private complete;
     private verify;
     private match;
+    private negotiate;
     private interrupt;
 }
 export interface ScanOptions {
     claim?: string;
     accept?: string;
+    limit?: number;
 }

package/transpiled/Scanner.js

@@ -1,24 +1,29 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Scanner = void 0;
 const node_stream_1 = require("node:stream");
 const node_crypto_1 = require("node:crypto");
-const agent_1 = require("@toa.io/agent");
 const error_value_1 = require("error-value");
+const negotiator_1 = __importDefault(require("negotiator"));
 class Scanner extends node_stream_1.PassThrough {
     size = 0;
     type = 'application/octet-stream';
-    error = null;
+    error;
     hash = (0, node_crypto_1.createHash)('md5');
     claim;
     accept;
+    limit;
     position = 0;
-    detected = false;
+    completed = false;
     chunks = [];
     constructor(control) {
         super();
         this.claim = control?.claim;
         this.accept = control?.accept;
+        this.limit = control?.limit;
     }
     digest() {
         return this.hash.digest('hex');
@@ -30,7 +35,7 @@ class Scanner extends node_stream_1.PassThrough {
     process = (buffer) => {
         this.size += buffer.length;
         this.hash.update(buffer);
-        if (this.detected)
+        if (this.completed)
             return;
         if (this.position + buffer.length > HEADER_SIZE)
             buffer = buffer.subarray(0, HEADER_SIZE - this.position);
@@ -38,18 +43,25 @@ class Scanner extends node_stream_1.PassThrough {
         this.position += buffer.length;
         if (this.position === HEADER_SIZE)
             this.complete();
+        if (this.limit !== undefined && this.size > this.limit)
+            this.interrupt(ERR_LIMIT_EXCEEDED);
     };
     complete() {
         const header = Buffer.concat(this.chunks).toString('hex');
         const signature = SIGNATURES
-            .find(({ hex, off }) => header.slice(off, off + hex.length) === hex);
+            .find(({ off, hex, expression }) => {
+            const sig = header.slice(off, off + hex.length);
+            return expression === undefined
+                ? sig === hex
+                : expression.test(sig);
+        });
         const type = signature?.type ?? this.claim;
         if (type !== undefined) {
             this.match(type);
             this.type = type;
         }
         this.verify(signature);
-        this.detected = true;
+        this.completed = true;
     }
     verify(signature) {
         if (this.claim === undefined || this.claim === 'application/octet-stream')
@@ -63,36 +75,51 @@ class Scanner extends node_stream_1.PassThrough {
     match(type) {
         if (this.accept === undefined)
             return;
-        const unacceptable = (0, agent_1.negotiate)(this.accept, [type]) === null;
+        const unacceptable = this.negotiate(this.accept, [type]) === null;
         if (unacceptable)
             this.interrupt(ERR_NOT_ACCEPTABLE);
     }
+    negotiate(accept, type) {
+        return new negotiator_1.default({ headers: { accept } }).mediaType(type) ?? null;
+    }
     interrupt(error) {
+        this.completed = true;
         this.error = error;
-        this.end();
+        this.destroy(error);
     }
 }
 exports.Scanner = Scanner;
 // https://en.wikipedia.org/wiki/List_of_file_signatures
 const SIGNATURES = [
-    { hex: 'ffd8ffe0', off: 0, type: 'image/jpeg' },
-    { hex: 'ffd8ffe1', off: 0, type: 'image/jpeg' },
-    { hex: 'ffd8ffee', off: 0, type: 'image/jpeg' },
-    { hex: 'ffd8ffdb', off: 0, type: 'image/jpeg' },
-    { hex: '89504e47', off: 0, type: 'image/png' },
-    { hex: '47494638', off: 0, type: 'image/gif' },
-    { hex: '52494646', off: 0, type: 'image/webp' },
-    { hex: '4a584c200d0a870a', off: 8, type: 'image/jxl' },
-    { hex: '6674797068656963', off: 8, type: 'image/heic' },
-    { hex: '6674797061766966', off: 8, type: 'image/avif' }
+    { hex: 'ff d8 ff e0', off: 0, type: 'image/jpeg' },
+    { hex: 'ff d8 ff e1', off: 0, type: 'image/jpeg' },
+    { hex: 'ff d8 ff e2', off: 0, type: 'image/jpeg' },
+    { hex: 'ff d8 ff ee', off: 0, type: 'image/jpeg' },
+    { hex: 'ff d8 ff db', off: 0, type: 'image/jpeg' },
+    { hex: '89 50 4e 47', off: 0, type: 'image/png' },
+    { hex: '47 49 46 38', off: 0, type: 'image/gif' },
+    { hex: '52 49 46 46 ?? ?? ?? ?? 57 45 42 50', off: 0, type: 'image/webp' },
+    { hex: '4a 58 4c 20 0d 0a 87 0a', off: 8, type: 'image/jxl' },
+    { hex: '66 74 79 70 68 65 69 63', off: 8, type: 'image/heic' },
+    { hex: '66 74 79 70 61 76 69 66', off: 8, type: 'image/avif' },
+    { hex: '52 49 46 46 ?? ?? ?? ?? 41 56 49 20', off: 0, type: 'video/avi' },
+    { hex: '52 49 46 46 ?? ?? ?? ?? 57 41 56 45', off: 0, type: 'audio/wav' }
     /*
     When adding a new signature, include a copyright-free sample file in the `.tests` directory
-    and update the 'signatures' test group in `Storage.test.ts`.
+    and update the `signatures` test group in `Storage.test.ts`.
      */
-];
+].map((signature) => {
+    signature.hex = signature.hex.replaceAll(' ', '');
+    if (signature.hex.includes('??')) {
+        const expression = signature.hex.replaceAll(/(?<wildcards>\?{1,24})/g, (_, wildcards) => `[0-9a-f]{${wildcards.length}}`);
+        signature.expression = new RegExp(expression, 'i');
+    }
+    return signature;
+});
 const HEADER_SIZE = SIGNATURES
     .reduce((max, { off, hex }) => Math.max(max, off + hex.length), 0) / 2;
 const KNOWN_TYPES = new Set(SIGNATURES.map(({ type }) => type));
-const ERR_TYPE_MISMATCH = (0, error_value_1.Err)('TYPE_MISMATCH');
-const ERR_NOT_ACCEPTABLE = (0, error_value_1.Err)('NOT_ACCEPTABLE');
+const ERR_TYPE_MISMATCH = new error_value_1.Err('TYPE_MISMATCH');
+const ERR_NOT_ACCEPTABLE = new error_value_1.Err('NOT_ACCEPTABLE');
+const ERR_LIMIT_EXCEEDED = new error_value_1.Err('LIMIT_EXCEEDED');
 //# sourceMappingURL=Scanner.js.map

package/transpiled/Scanner.js.map

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

package/transpiled/Secrets.d.ts

@@ -0,0 +1,5 @@
+export type Secrets<K extends string = string> = Record<K | string, string | undefined>;
+export interface Secret {
+    readonly name: string;
+    readonly optional?: boolean;
+}

package/transpiled/Secrets.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Secrets.js.map

package/transpiled/Secrets.js.map

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

package/transpiled/Storage.d.ts

@@ -1,32 +1,23 @@
 /// <reference types="node" />
-import { Readable } from 'node:stream';
+import type { Readable } from 'node:stream';
+import type { Attributes, Entry, Stream } from './Entry';
 import type { ScanOptions } from './Scanner';
 import type { Provider } from './Provider';
-import type { Entry } from './Entry';
 export declare class Storage {
     private readonly provider;
     constructor(provider: Provider);
     put(path: string, stream: Readable, options?: Options): Maybe<Entry>;
-    get(path: string): Maybe<Entry>;
-    fetch(path: string): Maybe<Readable>;
+    get(path: string): Maybe<Stream>;
+    head(path: string): Promise<Maybe<Entry>>;
     delete(path: string): Maybe<void>;
-    list(path: string): Promise<string[]>;
-    permute(path: string, ids: string[]): Maybe<void>;
-    conceal(path: string): Maybe<void>;
-    reveal(path: string): Maybe<void>;
-    diversify(path: string, name: string, stream: Readable): Maybe<void>;
-    annotate(path: string, key: string, value?: unknown): Maybe<void>;
-    private transit;
-    private persist;
-    private create;
-    private save;
-    private enroll;
-    private parse;
+    path(): string | null;
+    private locate;
 }
-type Maybe<T> = Promise<T | Error>;
-type Meta = Record<string, string>;
 interface Options extends ScanOptions {
-    meta?: Meta;
+    id?: string;
+    origin?: string;
+    attributes?: Attributes;
 }
+type Maybe<T> = Promise<T | Error>;
 export type Storages = Record<string, Storage>;
 export {};