@forgezero/providers 0.1.13 → 0.1.14

package/README.md

@@ -59,17 +59,59 @@ bun test
 <a id="forgezero-providers"></a>
 ## @forgezero/providers
 
-The registry: priority, health, and a terminal-versus-retryable verdict per failure. Named value imports: ProviderError, STRIKES_TO_OFFLINE, VERSION, chainCredentials, chainScopedCredentials, createRegistry, createService, defineProvider, defineProviderMethod, defineService, defineSingleMethodProvider, envCredentials, nextHealth, scopeCredentials, serviceMethod, staticConfig. Named type imports: AnyProviderMethod, Attempt, CallOptions, CallResult, ConfigSource, CredentialSource, DirectAttempt, DirectCallResult, DirectServiceAttachment, DirectServiceConfig, DirectServiceOptions, EmailBatch, EmailBatchItemResult, EmailBatchResult, EmailMessage, FailureKind, InvokeContext, ProviderDefinition, ProviderHealth, ProviderInstanceConfig, ProviderMethodSpec, ProviderMethods, RegistryOptions, ScopedCredentialSource, ServiceDefinition, ServiceMethodAttachment, ServiceMethodContract, ServiceMethods, StaticRegistryConfig. Import only the names used by this file.
+The registry: priority, health, and a terminal-versus-retryable verdict per failure. This entry exposes 16 named value exports and 29 named type exports. The generated import block lists one name per line for scanning and copying; keep only the names used by your file.
 
 ```text
-import { ProviderError, STRIKES_TO_OFFLINE, VERSION, chainCredentials, chainScopedCredentials, createRegistry } from '@forgezero/providers';
-import { createService, defineProvider, defineProviderMethod, defineService, defineSingleMethodProvider, envCredentials } from '@forgezero/providers';
-import { nextHealth, scopeCredentials, serviceMethod, staticConfig } from '@forgezero/providers';
-import type { AnyProviderMethod, Attempt, CallOptions, CallResult, ConfigSource, CredentialSource } from '@forgezero/providers';
-import type { DirectAttempt, DirectCallResult, DirectServiceAttachment, DirectServiceConfig, DirectServiceOptions, EmailBatch } from '@forgezero/providers';
-import type { EmailBatchItemResult, EmailBatchResult, EmailMessage, FailureKind, InvokeContext, ProviderDefinition } from '@forgezero/providers';
-import type { ProviderHealth, ProviderInstanceConfig, ProviderMethodSpec, ProviderMethods, RegistryOptions, ScopedCredentialSource } from '@forgezero/providers';
-import type { ServiceDefinition, ServiceMethodAttachment, ServiceMethodContract, ServiceMethods, StaticRegistryConfig } from '@forgezero/providers';
+import {
+  ProviderError,
+  STRIKES_TO_OFFLINE,
+  VERSION,
+  chainCredentials,
+  chainScopedCredentials,
+  createRegistry,
+  createService,
+  defineProvider,
+  defineProviderMethod,
+  defineService,
+  defineSingleMethodProvider,
+  envCredentials,
+  nextHealth,
+  scopeCredentials,
+  serviceMethod,
+  staticConfig,
+} from '@forgezero/providers';
+
+import type {
+  AnyProviderMethod,
+  Attempt,
+  CallOptions,
+  CallResult,
+  ConfigSource,
+  CredentialSource,
+  DirectAttempt,
+  DirectCallResult,
+  DirectServiceAttachment,
+  DirectServiceConfig,
+  DirectServiceOptions,
+  EmailBatch,
+  EmailBatchItemResult,
+  EmailBatchResult,
+  EmailMessage,
+  FailureKind,
+  InvokeContext,
+  ProviderDefinition,
+  ProviderHealth,
+  ProviderInstanceConfig,
+  ProviderMethodSpec,
+  ProviderMethods,
+  RegistryOptions,
+  ScopedCredentialSource,
+  ServiceDefinition,
+  ServiceMethodAttachment,
+  ServiceMethodContract,
+  ServiceMethods,
+  StaticRegistryConfig,
+} from '@forgezero/providers';
 ```
 
 ## @forgezero/providers — Extend with a custom provider and service
@@ -77,9 +119,18 @@ import type { ServiceDefinition, ServiceMethodAttachment, ServiceMethodContract,
 Public consumers define provider capabilities and application services independently, then attach them with the same ordered-array API.
 
 ```text
-import { createService, defineService, defineSingleMethodProvider, serviceMethod } from '@forgezero/providers';
-import { createVault } from '@forgezero/vault';
-import { vaultCredentials } from '@forgezero/vault/providers';
+import {
+  createService,
+  defineService,
+  defineSingleMethodProvider,
+  serviceMethod,
+} from '@forgezero/providers';
+import {
+  createVault,
+} from '@forgezero/vault';
+import {
+  vaultCredentials,
+} from '@forgezero/vault/providers';
 
 type Notice = { text: string };
 type Receipt = { id: string };
@@ -111,9 +162,17 @@ const service = createService(notifications, {
 Bootstrap tries the scoped Vault entry first and the identically named systemd credential second. If neither exists, the provider call fails.
 
 ```text
-import { chainScopedCredentials, scopeCredentials } from '@forgezero/providers';
-import { createVault, systemdCredentials } from '@forgezero/vault';
-import { vaultCredentials } from '@forgezero/vault/providers';
+import {
+  chainScopedCredentials,
+  scopeCredentials,
+} from '@forgezero/providers';
+import {
+  createVault,
+  systemdCredentials,
+} from '@forgezero/vault';
+import {
+  vaultCredentials,
+} from '@forgezero/vault/providers';
 
 const vault = createVault({ project: 'my-project', environment: 'production' });
 const credentials = chainScopedCredentials(
@@ -127,11 +186,20 @@ const credentials = chainScopedCredentials(
 <a id="forgezero-providers-email"></a>
 ## @forgezero/providers/email
 
-JetEmail (`send`, `sendBatch`), SMTP (`send` only), and the typed email service contract; SMTP transport is injected. Named value imports: emailProviders, emailService, jetemail, smtp. Named type imports: JetEmailConfig, SmtpTransport. Import only the names used by this file.
+JetEmail (`send`, `sendBatch`), SMTP (`send` only), and the typed email service contract; SMTP transport is injected. This entry exposes 4 named value exports and 2 named type exports. The generated import block lists one name per line for scanning and copying; keep only the names used by your file.
 
 ```text
-import { emailProviders, emailService, jetemail, smtp } from '@forgezero/providers/email';
-import type { JetEmailConfig, SmtpTransport } from '@forgezero/providers/email';
+import {
+  emailProviders,
+  emailService,
+  jetemail,
+  smtp,
+} from '@forgezero/providers/email';
+
+import type {
+  JetEmailConfig,
+  SmtpTransport,
+} from '@forgezero/providers/email';
 ```
 
 ## @forgezero/providers/email — Email with ordered provider fallback
@@ -139,10 +207,22 @@ import type { JetEmailConfig, SmtpTransport } from '@forgezero/providers/email';
 The service owns send/sendBatch. Attach provider methods directly in priority arrays; SMTP is never presented as batch-capable.
 
 ```text
-import { createService, type EmailMessage } from '@forgezero/providers';
-import { emailService, jetemail, smtp, type SmtpTransport } from '@forgezero/providers/email';
-import { createVault } from '@forgezero/vault';
-import { vaultCredentials } from '@forgezero/vault/providers';
+import {
+  createService,
+  type EmailMessage,
+} from '@forgezero/providers';
+import {
+  emailService,
+  jetemail,
+  smtp,
+  type SmtpTransport,
+} from '@forgezero/providers/email';
+import {
+  createVault,
+} from '@forgezero/vault';
+import {
+  vaultCredentials,
+} from '@forgezero/vault/providers';
 
 // Adapt Nodemailer, Bun, or an HTTP SMTP relay once at the host boundary.
 declare const transport: SmtpTransport;
@@ -167,86 +247,177 @@ console.log(outcome.result, outcome.attempts);
 <a id="forgezero-providers-database"></a>
 ## @forgezero/providers/database
 
-ArangoDB in the registry for credential rotation and health — with failover off by default. Named value imports: ARANGO_COMMUNITY_VERSION, ARANGO_SERVER_MODE_PATH, MAX_ARANGO_COORDINATORS, arangoCoordinatorUrls, arangodb, databaseProviders, resetPools. Named type imports: ArangoConfig, ArangoConnectOptions, ArangoCoordinatorMember, ArangoLike, ArangoMembershipSnapshot, ArangoMembershipVerifier, Query. Import only the names used by this file.
+ArangoDB in the registry for credential rotation and health — with failover off by default. This entry exposes 7 named value exports and 7 named type exports. The generated import block lists one name per line for scanning and copying; keep only the names used by your file.
 
 ```text
-import { ARANGO_COMMUNITY_VERSION, ARANGO_SERVER_MODE_PATH, MAX_ARANGO_COORDINATORS, arangoCoordinatorUrls, arangodb, databaseProviders } from '@forgezero/providers/database';
-import { resetPools } from '@forgezero/providers/database';
-import type { ArangoConfig, ArangoConnectOptions, ArangoCoordinatorMember, ArangoLike, ArangoMembershipSnapshot, ArangoMembershipVerifier } from '@forgezero/providers/database';
-import type { Query } from '@forgezero/providers/database';
+import {
+  ARANGO_COMMUNITY_VERSION,
+  ARANGO_SERVER_MODE_PATH,
+  MAX_ARANGO_COORDINATORS,
+  arangoCoordinatorUrls,
+  arangodb,
+  databaseProviders,
+  resetPools,
+} from '@forgezero/providers/database';
+
+import type {
+  ArangoConfig,
+  ArangoConnectOptions,
+  ArangoCoordinatorMember,
+  ArangoLike,
+  ArangoMembershipSnapshot,
+  ArangoMembershipVerifier,
+  Query,
+} from '@forgezero/providers/database';
 ```
 
 <a id="forgezero-providers-http"></a>
 ## @forgezero/providers/http
 
-Outbound HTTP with a per-host weight budget reserved before the call and settled from the response. Named value imports: BudgetExhausted, binanceWeight, budgetState, createHttpClient, http, httpProviders, resetBudgets, settle, spend. Named type imports: HostBudget, HttpClient, HttpConfig, HttpRequest, HttpResponse. Import only the names used by this file.
+Outbound HTTP with a per-host weight budget reserved before the call and settled from the response. This entry exposes 9 named value exports and 5 named type exports. The generated import block lists one name per line for scanning and copying; keep only the names used by your file.
 
 ```text
-import { BudgetExhausted, binanceWeight, budgetState, createHttpClient, http, httpProviders } from '@forgezero/providers/http';
-import { resetBudgets, settle, spend } from '@forgezero/providers/http';
-import type { HostBudget, HttpClient, HttpConfig, HttpRequest, HttpResponse } from '@forgezero/providers/http';
+import {
+  BudgetExhausted,
+  binanceWeight,
+  budgetState,
+  createHttpClient,
+  http,
+  httpProviders,
+  resetBudgets,
+  settle,
+  spend,
+} from '@forgezero/providers/http';
+
+import type {
+  HostBudget,
+  HttpClient,
+  HttpConfig,
+  HttpRequest,
+  HttpResponse,
+} from '@forgezero/providers/http';
 ```
 
 <a id="forgezero-providers-pool"></a>
 ## @forgezero/providers/pool
 
-Which outbound address a request leaves by, sticky per key, over the same budget as everything else. Named value imports: PoolEmpty, PoolExhausted, createAddressPool. Named type imports: AddressPool, Lease, PoolAddress, PoolOptions. Import only the names used by this file.
+Which outbound address a request leaves by, sticky per key, over the same budget as everything else. This entry exposes 3 named value exports and 4 named type exports. The generated import block lists one name per line for scanning and copying; keep only the names used by your file.
 
 ```text
-import { PoolEmpty, PoolExhausted, createAddressPool } from '@forgezero/providers/pool';
-import type { AddressPool, Lease, PoolAddress, PoolOptions } from '@forgezero/providers/pool';
+import {
+  PoolEmpty,
+  PoolExhausted,
+  createAddressPool,
+} from '@forgezero/providers/pool';
+
+import type {
+  AddressPool,
+  Lease,
+  PoolAddress,
+  PoolOptions,
+} from '@forgezero/providers/pool';
 ```
 
 <a id="forgezero-providers-chain"></a>
 ## @forgezero/providers/chain
 
-An EVM node behind the same failover as any other service: read logs, broadcast, and never stop scanning because one endpoint rate-limited. Named value imports: evmRpc. Named type imports: ChainCall, ChainLog, ChainReceipt, ChainResult. Import only the names used by this file.
+An EVM node behind the same failover as any other service: read logs, broadcast, and never stop scanning because one endpoint rate-limited. This entry exposes 1 named value export and 4 named type exports. The generated import block lists one name per line for scanning and copying; keep only the names used by your file.
 
 ```text
-import { evmRpc } from '@forgezero/providers/chain';
-import type { ChainCall, ChainLog, ChainReceipt, ChainResult } from '@forgezero/providers/chain';
+import {
+  evmRpc,
+} from '@forgezero/providers/chain';
+
+import type {
+  ChainCall,
+  ChainLog,
+  ChainReceipt,
+  ChainResult,
+} from '@forgezero/providers/chain';
 ```
 
 <a id="forgezero-providers-binance"></a>
 ## @forgezero/providers/binance
 
-Binance behind the venue adapter: three hosts, one weight budget, signed over the exact string that is sent. Named value imports: binanceSymbol, createBinanceAdapter, readBinanceError, toOrderStatus. Named type imports: BinanceCredentials, BinanceOptions. Import only the names used by this file.
+Binance behind the venue adapter: three hosts, one weight budget, signed over the exact string that is sent. This entry exposes 4 named value exports and 2 named type exports. The generated import block lists one name per line for scanning and copying; keep only the names used by your file.
 
 ```text
-import { binanceSymbol, createBinanceAdapter, readBinanceError, toOrderStatus } from '@forgezero/providers/binance';
-import type { BinanceCredentials, BinanceOptions } from '@forgezero/providers/binance';
+import {
+  binanceSymbol,
+  createBinanceAdapter,
+  readBinanceError,
+  toOrderStatus,
+} from '@forgezero/providers/binance';
+
+import type {
+  BinanceCredentials,
+  BinanceOptions,
+} from '@forgezero/providers/binance';
 ```
 
 <a id="forgezero-providers-storage"></a>
 ## @forgezero/providers/storage
 
-S3-compatible object storage, SigV4 signed with Web Crypto and no vendor SDK. Named value imports: MAX_SINGLE_PUT_BYTES, StorageError, amzDate, createS3Client, encodeSegment, parseListXml, s3, signRequest, storageProviders. Named type imports: ObjectSummary, PutObjectArgs, S3Client, S3Config, S3Credentials, SignedRequest, StorageRequest. Import only the names used by this file.
+S3-compatible object storage, SigV4 signed with Web Crypto and no vendor SDK. This entry exposes 9 named value exports and 7 named type exports. The generated import block lists one name per line for scanning and copying; keep only the names used by your file.
 
 ```text
-import { MAX_SINGLE_PUT_BYTES, StorageError, amzDate, createS3Client, encodeSegment, parseListXml } from '@forgezero/providers/storage';
-import { s3, signRequest, storageProviders } from '@forgezero/providers/storage';
-import type { ObjectSummary, PutObjectArgs, S3Client, S3Config, S3Credentials, SignedRequest } from '@forgezero/providers/storage';
-import type { StorageRequest } from '@forgezero/providers/storage';
+import {
+  MAX_SINGLE_PUT_BYTES,
+  StorageError,
+  amzDate,
+  createS3Client,
+  encodeSegment,
+  parseListXml,
+  s3,
+  signRequest,
+  storageProviders,
+} from '@forgezero/providers/storage';
+
+import type {
+  ObjectSummary,
+  PutObjectArgs,
+  S3Client,
+  S3Config,
+  S3Credentials,
+  SignedRequest,
+  StorageRequest,
+} from '@forgezero/providers/storage';
 ```
 
 <a id="forgezero-providers-translation"></a>
 ## @forgezero/providers/translation
 
-Google AI Studio translation with strict batch alignment and classified quota failures. Named value imports: TranslationError, googleAiStudio, parseStrings, translationProviders. Named type imports: TranslateRequest, TranslateResult, TranslationProvider. Import only the names used by this file.
+Google AI Studio translation with strict batch alignment and classified quota failures. This entry exposes 4 named value exports and 3 named type exports. The generated import block lists one name per line for scanning and copying; keep only the names used by your file.
 
 ```text
-import { TranslationError, googleAiStudio, parseStrings, translationProviders } from '@forgezero/providers/translation';
-import type { TranslateRequest, TranslateResult, TranslationProvider } from '@forgezero/providers/translation';
+import {
+  TranslationError,
+  googleAiStudio,
+  parseStrings,
+  translationProviders,
+} from '@forgezero/providers/translation';
+
+import type {
+  TranslateRequest,
+  TranslateResult,
+  TranslationProvider,
+} from '@forgezero/providers/translation';
 ```
 
 <a id="forgezero-providers-realtime"></a>
 ## @forgezero/providers/realtime
 
-Cloudflare KV node-directory and Durable Object fan-out clients for project-defined realtime services. Named value imports: RealtimeProviderError, cloudflareRealtime. Named type imports: RealtimeProviderOptions. Import only the names used by this file.
+Cloudflare KV node-directory and Durable Object fan-out clients for project-defined realtime services. This entry exposes 2 named value exports and 1 named type export. The generated import block lists one name per line for scanning and copying; keep only the names used by your file.
 
 ```text
-import { RealtimeProviderError, cloudflareRealtime } from '@forgezero/providers/realtime';
-import type { RealtimeProviderOptions } from '@forgezero/providers/realtime';
+import {
+  RealtimeProviderError,
+  cloudflareRealtime,
+} from '@forgezero/providers/realtime';
+
+import type {
+  RealtimeProviderOptions,
+} from '@forgezero/providers/realtime';
 ```
 
 ## Built-in provider capabilities

package/dist/binance.js

@@ -298,7 +298,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.13";
+var VERSION = "0.1.14";
 
 // src/http.ts
 class BudgetExhausted extends ProviderError {

package/dist/chain.js

@@ -298,7 +298,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.13";
+var VERSION = "0.1.14";
 
 // src/chain.ts
 var hexToNumber = (value) => Number(BigInt(value));

package/dist/database.js

@@ -298,7 +298,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.13";
+var VERSION = "0.1.14";
 
 // src/database.ts
 var pools = new Map;

package/dist/email.js

@@ -298,7 +298,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.13";
+var VERSION = "0.1.14";
 
 // src/email.ts
 var recipients = (to) => Array.isArray(to) ? [...to] : [to];

package/dist/http.js

@@ -298,7 +298,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.13";
+var VERSION = "0.1.14";
 
 // src/http.ts
 class BudgetExhausted extends ProviderError {

package/dist/index.d.ts

@@ -285,5 +285,5 @@ export interface EmailBatchResult {
     };
     results: readonly EmailBatchItemResult[];
 }
-export declare const VERSION = "0.1.13";
+export declare const VERSION = "0.1.14";
 export {};

package/dist/index.js

@@ -298,7 +298,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.13";
+var VERSION = "0.1.14";
 export {
   staticConfig,
   serviceMethod,

package/dist/pool.js

@@ -298,7 +298,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.13";
+var VERSION = "0.1.14";
 
 // src/http.ts
 class BudgetExhausted extends ProviderError {

package/dist/storage.js

@@ -298,7 +298,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.13";
+var VERSION = "0.1.14";
 
 // src/storage.ts
 var encoder = new TextEncoder;

package/dist/translation.js

@@ -298,7 +298,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.13";
+var VERSION = "0.1.14";
 
 // src/translation.ts
 var GOOGLE_ENDPOINT = "https://generativelanguage.googleapis.com/v1beta/models";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgezero/providers",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "type": "module",
   "publishConfig": {
     "access": "public",
@@ -85,6 +85,6 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@forgezero/runtime": "^0.1.8"
+    "@forgezero/runtime": "^0.1.9"
   }
 }