@toa.io/extensions.storages 1.0.0-alpha.282 → 1.0.0-alpha.283

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.0.0-alpha.283](https://github.com/toa-io/toa/compare/v1.0.0-alpha.282...v1.0.0-alpha.283) (2026-09-04)
+
+### Bug Fixes
+
+* **storages:** take `Maybe` from core, not from the deprecated package ([bcaeeb3](https://github.com/toa-io/toa/commit/bcaeeb3c76c89af34e94ff569a210d21b7e87f64))
+
+### Features
+
+* **extensions:** an extension declares what it puts on a component's context ([133bc2a](https://github.com/toa-io/toa/commit/133bc2aad1e45a2d4aa68a08a5e44ca48d3b7414))
+
+
 # [1.0.0-alpha.282](https://github.com/toa-io/toa/compare/v1.0.0-alpha.281...v1.0.0-alpha.282) (2026-09-03)
 
 **Note:** Version bump only for package @toa.io/extensions.storages

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/extensions.storages",
-  "version": "1.0.0-alpha.282",
+  "version": "1.0.0-alpha.283",
   "type": "module",
   "description": "Toa Storages",
   "author": "temich <tema.gurtovoy@gmail.com>",
@@ -27,10 +27,10 @@
   "dependencies": {
     "@aws-sdk/client-s3": "3.1125.0",
     "@aws-sdk/lib-storage": "3.1125.0",
-    "@toa.io/schemas": "1.0.0-alpha.282",
+    "@toa.io/schemas": "1.0.0-alpha.283",
     "cloudinary": "2.11.0",
     "negotiator": "1.1.0",
     "openspan": "1.0.0-alpha.277"
   },
-  "gitHead": "4007c814725dd015d3bbebb9a28e28a247645c4f"
+  "gitHead": "2f52b023bed0ccb2ecdb2b82fe59fbe38bf282e1"
 }

package/source/Provider.ts

@@ -1,7 +1,7 @@
 import * as assert from 'node:assert'
 import type { Metadata, Stream } from './Entry.js'
 import type { Readable } from 'node:stream'
-import type { Maybe } from '@toa.io/types'
+import type { Maybe } from '@toa.io/core'
 import type { Secret, Secrets } from './Secrets.js'
 
 export abstract class Provider<Options = unknown> {

package/source/context.ts

@@ -0,0 +1,14 @@
+import type { Contribution } from '@toa.io/core'
+
+/** What this extension puts on the context of a component that declares it. */
+export function context (declaration: string[]): Contribution | null {
+  if (!Array.isArray(declaration) || declaration.length === 0) return null
+
+  const names = declaration.map((name) => JSON.stringify(name)).join(' | ')
+
+  return {
+    name: 'storages',
+    type: `Record<${names}, Storage>`,
+    imports: { '@toa.io/extensions.storages': ['Storage'] }
+  }
+}

package/source/index.ts

@@ -5,3 +5,6 @@ export { manifest } from './manifest.js'
 export type { Entry, Stream } from './Entry.js'
 export type { Storage } from './Storage.js'
 export type * from './providers/index.js'
+
+// what this extension puts on a component's context
+export { context } from './context.js'

package/source/providers/Cloudinary.ts

@@ -4,7 +4,7 @@ import { v2 as cloudinary } from 'cloudinary'
 import { console } from 'openspan'
 import { Provider } from '../Provider.js'
 import { ERR_NOT_FOUND } from '../errors.js'
-import type { Maybe } from '@toa.io/types'
+import type { Maybe } from '@toa.io/core'
 import type { Metadata, Stream } from '../Entry.js'
 import type { Secret, Secrets } from '../Secrets.js'
 import type { ReadableStream } from 'node:stream/web'

package/source/providers/FileSystem.ts

@@ -4,7 +4,7 @@ import { dirname, join } from 'node:path'
 import { Provider } from '../Provider.js'
 import { ERR_NOT_FOUND } from '../errors.js'
 import type { Readable } from 'node:stream'
-import type { Maybe } from '@toa.io/types'
+import type { Maybe } from '@toa.io/core'
 import type { Metadata, Stream } from '../Entry.js'
 
 export interface FileSystemOptions {

package/source/providers/S3.ts

@@ -8,7 +8,7 @@ import { console } from 'openspan'
 import { Provider } from '../Provider.js'
 import { ERR_NOT_FOUND } from '../errors.js'
 import type { ReadableStream } from 'node:stream/web'
-import type { Maybe } from '@toa.io/types'
+import type { Maybe } from '@toa.io/core'
 import type { Metadata, Stream } from '../Entry.js'
 import type { Secret, Secrets } from '../Secrets.js'
 

package/transpiled/Provider.d.ts

@@ -1,6 +1,6 @@
 import type { Metadata, Stream } from './Entry.js';
 import type { Readable } from 'node:stream';
-import type { Maybe } from '@toa.io/types';
+import type { Maybe } from '@toa.io/core';
 import type { Secret, Secrets } from './Secrets.js';
 export declare abstract class Provider<Options = unknown> {
     static readonly SECRETS?: readonly Secret[];

package/transpiled/context.d.ts

@@ -0,0 +1,3 @@
+import type { Contribution } from '@toa.io/core';
+/** What this extension puts on the context of a component that declares it. */
+export declare function context(declaration: string[]): Contribution | null;

package/transpiled/context.js

@@ -0,0 +1,12 @@
+/** What this extension puts on the context of a component that declares it. */
+export function context(declaration) {
+    if (!Array.isArray(declaration) || declaration.length === 0)
+        return null;
+    const names = declaration.map((name) => JSON.stringify(name)).join(' | ');
+    return {
+        name: 'storages',
+        type: `Record<${names}, Storage>`,
+        imports: { '@toa.io/extensions.storages': ['Storage'] }
+    };
+}
+//# sourceMappingURL=context.js.map

package/transpiled/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../source/context.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,MAAM,UAAU,OAAO,CAAE,WAAqB;IAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAExE,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAEzE,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU,KAAK,YAAY;QACjC,OAAO,EAAE,EAAE,6BAA6B,EAAE,CAAC,SAAS,CAAC,EAAE;KACxD,CAAA;AACH,CAAC"}

package/transpiled/index.d.ts

@@ -4,3 +4,4 @@ export { manifest } from './manifest.js';
 export type { Entry, Stream } from './Entry.js';
 export type { Storage } from './Storage.js';
 export type * from './providers/index.js';
+export { context } from './context.js';

package/transpiled/index.js

@@ -1,4 +1,6 @@
 export { Factory } from './Factory.js';
 export { deployment } from './deployment.js';
 export { manifest } from './manifest.js';
+// what this extension puts on a component's context
+export { context } from './context.js';
 //# sourceMappingURL=index.js.map

package/transpiled/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAMxC,oDAAoD;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}

package/transpiled/providers/Cloudinary.d.ts

@@ -1,6 +1,6 @@
 import { Readable } from 'node:stream';
 import { Provider } from '../Provider.js';
-import type { Maybe } from '@toa.io/types';
+import type { Maybe } from '@toa.io/core';
 import type { Metadata, Stream } from '../Entry.js';
 import type { Secret, Secrets } from '../Secrets.js';
 import type { TransformationOptions } from 'cloudinary';

package/transpiled/providers/FileSystem.d.ts

@@ -1,6 +1,6 @@
 import { Provider } from '../Provider.js';
 import type { Readable } from 'node:stream';
-import type { Maybe } from '@toa.io/types';
+import type { Maybe } from '@toa.io/core';
 import type { Metadata, Stream } from '../Entry.js';
 export interface FileSystemOptions {
     path: string;

package/transpiled/providers/S3.d.ts

@@ -1,6 +1,6 @@
 import { Readable } from 'node:stream';
 import { Provider } from '../Provider.js';
-import type { Maybe } from '@toa.io/types';
+import type { Maybe } from '@toa.io/core';
 import type { Metadata, Stream } from '../Entry.js';
 import type { Secret, Secrets } from '../Secrets.js';
 export interface S3Options {