@toa.io/extensions.storages 1.0.0-alpha.7 → 1.0.0-alpha.78

package/source/Storage.ts

@@ -1,7 +1,8 @@
 import { Readable } from 'node:stream'
 import { posix } from 'node:path'
+import { buffer } from 'node:stream/consumers'
 import { decode, encode } from 'msgpackr'
-import { buffer, newid } from '@toa.io/generic'
+import { newid } from '@toa.io/generic'
 import { Err } from 'error-value'
 import { Scanner } from './Scanner'
 import type { ScanOptions } from './Scanner'
@@ -27,15 +28,33 @@ export class Storage {
 
     await this.persist(tempname, id)
 
-    return await this.create(path, id, scanner.size, scanner.type, options?.meta)
+    const entry: Entry = {
+      id,
+      size: scanner.size,
+      type: scanner.type,
+      origin: options?.origin,
+      created: Date.now(),
+      variants: [],
+      meta: options?.meta ?? {}
+    }
+
+    return await this.create(path, entry)
   }
 
   public async get (path: string): Maybe<Entry> {
-    const metapath = posix.join(ENTRIES, path, META)
-    const result = await this.provider.get(metapath)
+    const paths = this.destruct(path)
+    const result = await this.provider.get(paths.metafile)
 
-    if (result === null) return ERR_NOT_FOUND
-    else return decode(await buffer(result))
+    if (result === null)
+      return ERR_NOT_FOUND
+    else
+      return decode(await buffer(result))
+  }
+
+  public async list (path: string): Promise<string[]> {
+    const dir = posix.join(ENTRIES_ROOT, path, ENTRIES_DIR)
+
+    return await this.provider.list(dir)
   }
 
   public async fetch (path: string): Maybe<Readable> {
@@ -50,12 +69,14 @@ export class Storage {
 
     const blob = variant === null
       ? posix.join(BLOBs, id)
-      : posix.join(ENTRIES, rel, id, variant)
+      : posix.join(ENTRIES_ROOT, rel, id, variant)
 
     const stream = await this.provider.get(blob)
 
-    if (stream === null) return ERR_NOT_FOUND
-    else return stream
+    if (stream === null)
+      return ERR_NOT_FOUND
+    else
+      return stream
   }
 
   public async delete (path: string): Maybe<void> {
@@ -64,57 +85,38 @@ export class Storage {
     if (entry instanceof Error)
       return entry
 
-    await this.conceal(path)
-    await this.provider.delete(posix.join(ENTRIES, path))
-  }
+    const paths = this.destruct(path)
 
-  public async list (path: string): Promise<string[]> {
-    const listfile = posix.join(ENTRIES, path, LIST)
-    const stream = await this.provider.get(listfile)
-
-    return stream === null ? [] : decode(await buffer(stream))
-  }
-
-  public async permute (path: string, ids: string[]): Maybe<void> {
-    const unique = new Set(ids)
-    const dir = posix.join(ENTRIES, path)
-    const list = await this.list(path)
-
-    if (list.length !== ids.length || unique.size !== ids.length)
-      return ERR_PERMUTATION_MISMATCH
-
-    for (const id of ids)
-      if (!list.includes(id))
-        return ERR_PERMUTATION_MISMATCH
-
-    await this.provider.put(dir, LIST, Readable.from(encode(ids)))
+    await Promise.all([
+      this.provider.delete(paths.metafile),
+      this.provider.delete(paths.vardir)
+    ])
   }
 
-  public async conceal (path: string): Maybe<void> {
-    const { id, rel } = this.parse(path)
-    const dir = posix.join(ENTRIES, rel)
-    const list = await this.list(rel)
-    const index = list.indexOf(id)
-
-    if (index === -1)
-      return ERR_NOT_FOUND
+  public async move (path: string, to: string): Maybe<void> {
+    const source = this.destruct(path)
+    const rel = to.startsWith('.')
+    const dir = to.endsWith('/')
 
-    list.splice(index, 1)
+    if (rel)
+      to = posix.resolve(source.rel + '/', to)
 
-    await this.provider.put(dir, LIST, Readable.from(encode(list)))
-  }
+    if (dir)
+      to = posix.join(to, source.ent)
 
-  public async reveal (path: string): Maybe<void> {
-    const { id, rel } = this.parse(path)
+    const target = this.destruct(to)
 
-    return await this.enroll(rel, id)
+    await Promise.all([
+      this.provider.move(source.metafile, target.metafile),
+      this.provider.moveDir(source.vardir, target.vardir)
+    ])
   }
 
   public async diversify (path: string, name: string, stream: Readable): Maybe<void> {
     const scanner = new Scanner()
     const pipe = stream.pipe(scanner)
 
-    await this.provider.put(posix.join(ENTRIES, path), name, pipe)
+    await this.provider.put(posix.join(ENTRIES_ROOT, path), name, pipe)
 
     if (scanner.error !== null)
       return scanner.error
@@ -131,19 +133,30 @@ export class Storage {
     await this.save(path, entry)
   }
 
-  public async annotate (path: string, key: string, value?: unknown): Maybe<void> {
+  public async annotate (path: string, key: string | Record<string, unknown>, value?: unknown): Maybe<void> {
     const entry = await this.get(path)
 
     if (entry instanceof Error)
       return entry
 
-    // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
-    if (value === undefined) delete entry.meta[key]
-    else entry.meta[key] = value
+    const update = typeof key === 'string'
+      ? { [key]: value }
+      : key
+
+    Object.assign(entry.meta, update)
+
+    // filter undefined values
+    for (const key of Object.keys(entry.meta))
+      if (entry.meta[key] === undefined)
+        delete entry.meta[key]
 
     await this.save(path, entry)
   }
 
+  public path (): string | null {
+    return this.provider.path
+  }
+
   private async transit (stream: Readable): Promise<string> {
     const tempname = newid()
 
@@ -161,52 +174,21 @@ export class Storage {
 
   // eslint-disable-next-line max-params
   private async create
-  (path: string, id: string, size: number, type: string, meta: Meta = {}): Promise<Entry> {
-    const entry: Entry = {
-      id,
-      size,
-      type,
-      created: Date.now(),
-      variants: [],
-      meta
-    }
-
+  (path: string, entry: Entry): Promise<Entry> {
     const metafile = posix.join(path, entry.id)
     const existing = await this.get(metafile)
 
     if (existing instanceof Error)
       await this.save(metafile, entry)
 
-    await this.enroll(path, id, true)
-
     return entry
   }
 
-  private async save (rel: string, entry: Entry): Promise<void> {
-    const buffer = encode(entry)
-    const stream = Readable.from(buffer)
-
-    await this.provider.put(posix.join(ENTRIES, rel), META, stream)
-  }
-
-  private async enroll (path: string, id: string, addition: boolean = false): Maybe<void> {
-    const dir = posix.join(ENTRIES, path)
-    const list = await this.list(path)
-    const index = list.indexOf(id)
+  private async save (path: string, entry: Entry): Promise<void> {
+    const paths = this.destruct(path)
+    const stream = Readable.from(encode(entry))
 
-    if (index !== -1)
-      if (addition) list.splice(index, 1)
-      else return
-    else if (!addition) {
-      const entry = await this.get(posix.join(path, id))
-
-      if (entry instanceof Error)
-        return entry
-    }
-
-    list.push(id)
-
-    await this.provider.put(dir, LIST, Readable.from(encode(list)))
+    await this.provider.put(paths.metadir, paths.ent, stream)
   }
 
   private parse (path: string): Path {
@@ -217,16 +199,25 @@ export class Storage {
 
     return { rel, id, variant }
   }
+
+  private destruct (path: string): Paths {
+    const rel = posix.dirname(path)
+    const dir = posix.join(ENTRIES_ROOT, rel)
+    const ent = posix.basename(path)
+    const metadir = posix.join(dir, ENTRIES_DIR)
+    const metafile = posix.join(metadir, ent)
+    const vardir = posix.join(dir, ent)
+
+    return { rel, dir, ent, metadir, metafile, vardir }
+  }
 }
 
 const ERR_NOT_FOUND = Err('NOT_FOUND')
-const ERR_PERMUTATION_MISMATCH = Err('PERMUTATION_MISMATCH')
 
 const TEMP = '/temp'
 const BLOBs = '/blobs'
-const ENTRIES = '/entries'
-const LIST = '.list'
-const META = '.meta'
+const ENTRIES_ROOT = '/entries'
+const ENTRIES_DIR = '.meta'
 
 type Maybe<T> = Promise<T | Error>
 
@@ -236,9 +227,19 @@ interface Path {
   variant: string | null
 }
 
+interface Paths {
+  rel: string
+  dir: string
+  ent: string
+  metadir: string
+  metafile: string
+  vardir: string
+}
+
 type Meta = Record<string, string>
 
 interface Options extends ScanOptions {
+  origin?: string
   meta?: Meta
 }
 

package/source/deployment.ts

@@ -3,21 +3,25 @@ import { encode } from '@toa.io/generic'
 import { providers } from './providers'
 import { validateAnnotation } from './Annotation'
 import type { Annotation } from './Annotation'
-import type { Dependency, Variable } from '@toa.io/operations'
+import type { Dependency, Variable, Mounts } from '@toa.io/operations'
 import type { context } from '@toa.io/norm'
 
-export const SERIALIZATION_PREFIX = 'TOA_STORAGES'
+export const ENV_PREFIX = 'TOA_STORAGES'
 
 export function deployment (instances: Instance[], annotation: unknown): Dependency {
   validate(instances, annotation)
 
   const value = encode(annotation)
-  const pointer: Variable = { name: SERIALIZATION_PREFIX, value }
+  const pointer: Variable = { name: ENV_PREFIX, value }
   const secrets = getSecrets(annotation)
+  const mounts = getMounts(instances, annotation)
 
-  return {
-    variables: { global: [pointer, ...secrets] }
-  }
+  const dependency: Dependency = { variables: { global: [pointer, ...secrets] } }
+
+  if (mounts !== null)
+    dependency.mounts = mounts
+
+  return dependency
 }
 
 function validate (instances: Instance[], annotation: unknown): asserts annotation is Annotation {
@@ -42,7 +46,7 @@ function getSecrets (annotation: Annotation): Variable[] {
 
     for (const secret of Provider.SECRETS)
       secrets.push({
-        name: `${SERIALIZATION_PREFIX}_${name}_${secret.name}`.toUpperCase(),
+        name: `${ENV_PREFIX}_${name}_${secret.name}`.toUpperCase(),
         secret: {
           name: `toa-storages-${name}`,
           key: secret.name,
@@ -54,4 +58,31 @@ function getSecrets (annotation: Annotation): Variable[] {
   return secrets
 }
 
+function getMounts (instances: Instance[], annotation: Annotation): Mounts | null {
+  let mounts: Mounts | null = null
+
+  for (const { locator, manifest } of instances)
+    for (const name of manifest) {
+      const declaration = annotation[name]
+
+      // eslint-disable-next-line max-depth
+      if (declaration.provider !== 'fs')
+        continue
+
+      // eslint-disable-next-line max-depth
+      if (declaration.claim !== undefined) {
+        mounts ??= {}
+        mounts[locator.label] ??= []
+
+        mounts[locator.label].push({
+          name,
+          path: declaration.path,
+          claim: declaration.claim
+        })
+      }
+    }
+
+  return mounts
+}
+
 export type Instance = context.Dependency<string[]>

package/source/providers/FileSystem.test.ts

@@ -3,3 +3,9 @@ import { FileSystem } from './FileSystem'
 it('should be ok', async () => {
   expect(() => new FileSystem({ path: 'path' })).not.toThrow()
 })
+
+it('should expose path', () => {
+  const fs = new FileSystem({ path: '/tmp/foo' })
+
+  expect(fs.path).toBe('/tmp/foo')
+})

package/source/providers/FileSystem.ts

@@ -6,10 +6,11 @@ import type { ProviderSecrets } from '../Provider'
 
 export interface FileSystemOptions {
   path: string
+  claim?: string
 }
 
 export class FileSystem extends Provider<FileSystemOptions> {
-  protected readonly path: string
+  public override readonly path: string
 
   public constructor (options: FileSystemOptions, secrets?: ProviderSecrets) {
     super(options, secrets)
@@ -29,11 +30,19 @@ export class FileSystem extends Provider<FileSystemOptions> {
     }
   }
 
+  public async list (path: string): Promise<string[]> {
+    const dir = join(this.path, path)
+
+    return (await fs.readdir(dir, { withFileTypes: true }))
+      .filter((dirent) => dirent.isFile())
+      .map((dirent) => dirent.name)
+  }
+
   public async put (rel: string, filename: string, stream: Readable): Promise<void> {
     const dir = join(this.path, rel)
     const path = join(dir, filename)
 
-    await fs.mkdir(dirname(path), { recursive: true })
+    await fs.mkdir(dir, { recursive: true })
     await fs.writeFile(path, stream)
   }
 
@@ -48,4 +57,8 @@ export class FileSystem extends Provider<FileSystemOptions> {
     await fs.mkdir(dirname(to), { recursive: true })
     await fs.rename(from, to)
   }
+
+  public async moveDir (from: string, to: string): Promise<void> {
+    await this.move(from, to).catch(() => null)
+  }
 }

package/source/providers/Memory.ts

@@ -1,5 +1,5 @@
 import { Readable } from 'node:stream'
-import { join } from 'node:path'
+import { join, posix } from 'node:path'
 import { buffer } from 'node:stream/consumers'
 import * as assert from 'node:assert'
 
@@ -11,7 +11,7 @@ import { Provider } from '../Provider'
 export class InMemory extends Provider {
   private readonly storage = new Map<string, Buffer>()
 
-  public override async get (path: string): Promise<Readable | null> {
+  public async get (path: string): Promise<Readable | null> {
     const data = this.storage.get(path)
 
     if (data === undefined) return null
@@ -19,18 +19,22 @@ export class InMemory extends Provider {
     return Readable.from(data)
   }
 
-  public override async put (path: string, filename: string, stream: Readable): Promise<void> {
+  public async list (path: string): Promise<string[]> {
+    return Array.from(this.storage.keys())
+      .filter((f) => posix.dirname(f) === path)
+      .map((f) => posix.basename(f))
+  }
+
+  public async put (path: string, filename: string, stream: Readable): Promise<void> {
     this.storage.set(join(path, filename), await buffer(stream))
   }
 
-  public override async delete (path: string): Promise<void> {
+  public async delete (path: string): Promise<void> {
     for (const f of this.storage.keys())
       if (f.startsWith(path)) this.storage.delete(f)
   }
 
-  public override async move (from: string, to: string): Promise<void> {
-    assert.notEqual(from, to, 'Source and destination are the same')
-
+  public async move (from: string, to: string): Promise<void> {
     const buf = this.storage.get(from)
 
     assert.ok(buf !== undefined, `File not found: ${from}`)
@@ -38,4 +42,14 @@ export class InMemory extends Provider {
     this.storage.set(to, buf)
     this.storage.delete(from)
   }
+
+  public async moveDir (from: string, to: string): Promise<void> {
+    for (const f of this.storage.keys())
+      if (f.startsWith(from)) {
+        const toPath = to + f.slice(from.length)
+
+        this.storage.set(toPath, this.storage.get(f)!)
+        this.storage.delete(f)
+      }
+  }
 }

package/source/providers/S3.test.ts

@@ -105,6 +105,7 @@ describe('S3 storage provider', () => {
       deleteHandler))
 
     await provider.delete('/some/absolute/path_to_remove')
+
     expect(headHandler).toHaveBeenCalledTimes(1)
     expect(listHandler).toHaveBeenCalledTimes(2)
     expect(deleteHandler).toHaveBeenCalledTimes(1)

package/source/providers/S3.ts

@@ -2,6 +2,7 @@ import { Readable } from 'node:stream'
 import { Blob } from 'node:buffer'
 import { join } from 'node:path/posix'
 import assert from 'node:assert'
+import { posix } from 'node:path'
 import { Upload } from '@aws-sdk/lib-storage'
 import {
   S3Client,
@@ -70,10 +71,12 @@ export class S3 extends Provider<S3Options> {
     this.client.middlewareStack.add((next, _context) => async (args) => {
       if ('Key' in args.input && typeof args.input.Key === 'string')
       // removes leading slash
+
         args.input.Key = args.input.Key.replace(/^\//, '')
 
       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)
@@ -100,11 +103,18 @@ export class S3 extends Provider<S3Options> {
         ? fileResponse.Body.stream()
         : fileResponse.Body) as ReadableStream) // types mismatch between Node 20 and aws-sdk
     } catch (err) {
-      if (err instanceof NotFound || err instanceof NoSuchKey) return null
-      else throw err
+      if (err instanceof NotFound || err instanceof NoSuchKey)
+        return null
+      else
+        throw err
     }
   }
 
+  public async list (prefix: string): Promise<string[]> {
+    return (await this.listObjects(prefix))
+      .map(({ Key }) => posix.basename(Key!))
+  }
+
   public async put (path: string, filename: string, stream: Readable): Promise<void> {
     await new Upload({
       client: this.client,
@@ -136,10 +146,7 @@ export class S3 extends Provider<S3Options> {
         assert.ok(err instanceof NotFound || err instanceof NoSuchKey, err as Error)
       }
 
-    const objectsToRemove: ObjectIdentifier[] = []
-
-    for await (const page of paginateListObjectsV2({ client }, { Bucket, Prefix: Key }))
-      for (const { Key } of page.Contents ?? []) objectsToRemove.push({ Key })
+    const objectsToRemove: ObjectIdentifier[] = await this.listObjects(Key)
 
     // Removing all objects in parallel in batches
     await Promise.all((function * () {
@@ -163,4 +170,27 @@ export class S3 extends Provider<S3Options> {
 
     await this.client.send(new DeleteObjectCommand({ Bucket: this.bucket, Key: from }))
   }
+
+  public async moveDir (from: string, to: string): Promise<void> {
+    const objects: ObjectIdentifier[] = await this.listObjects(from)
+
+    await Promise.all(objects.map(async ({ Key }) => {
+      const ent = posix.basename(Key!)
+      const source = posix.join(from, ent)
+      const target = posix.join(to, ent)
+
+      return this.move(source, target)
+    }))
+  }
+
+  private async listObjects (Prefix: string): Promise<ObjectIdentifier[]> {
+    const { client, bucket: Bucket } = this
+    const objects: ObjectIdentifier[] = []
+
+    for await (const page of paginateListObjectsV2({ client }, { Bucket, Prefix }))
+      for (const { Key } of page.Contents ?? [])
+        objects.push({ Key })
+
+    return objects
+  }
 }

package/source/providers/index.test.ts

@@ -69,6 +69,16 @@ describe.each(suites)('$provider', (suite) => {
     expect(result).toBeNull()
   })
 
+  it('should list files', async () => {
+    const stream = createReadStream('lenna.png')
+
+    await provider.put(dir, 'lenna.png', stream)
+
+    const result = await provider.list(dir)
+
+    expect(result).toContain('lenna.png')
+  })
+
   describe('danger', () => {
     /*
 

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/transpiled/Entry.d.ts

@@ -3,6 +3,7 @@ export interface Entry {
     size: number;
     type: string;
     created: number;
+    origin?: string;
     variants: Variant[];
     meta: Record<string, unknown>;
 }

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);
     }
@@ -34,6 +35,7 @@ class Factory {
         const Provider = providers_1.providers[providerId];
         const secrets = this.resolveSecrets(name, Provider);
         const provider = new Provider(options, secrets);
+        openspan_1.console.debug('Storage created', { name, provider: providerId, options, path: provider.path });
         return new Storage_1.Storage(provider);
     }
     resolveSecrets(storageName, Class) {
@@ -41,7 +43,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;AAKjD,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,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,kBAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;QAE9F,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,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;AA1DD,0BA0DC"}

package/transpiled/Provider.d.ts

@@ -7,11 +7,14 @@ export interface ProviderSecret {
 }
 export declare abstract class Provider<Options = void> {
     static readonly SECRETS: readonly ProviderSecret[];
+    readonly path: string | null;
     constructor(_: Options, secrets?: ProviderSecrets);
     abstract get(path: string): Promise<Readable | null>;
+    abstract list(path: string): Promise<string[]>;
     abstract put(path: string, filename: string, stream: Readable): Promise<void>;
     abstract delete(path: string): Promise<void>;
     abstract move(from: string, to: string): Promise<void>;
+    abstract moveDir(from: string, to: string): Promise<void>;
 }
 export interface ProviderConstructor {
     readonly SECRETS: readonly ProviderSecret[];

package/transpiled/Provider.js

@@ -27,6 +27,7 @@ exports.Provider = void 0;
 const assert = __importStar(require("node:assert"));
 class Provider {
     static SECRETS = [];
+    path = null;
     constructor(_, secrets) {
         for (const { name, optional = false } of new.target.SECRETS)
             assert.ok(optional || secrets?.[name] !== undefined, `Missing secret '${name}'`);