@forgezero/providers 0.1.20 → 0.1.22

package/README.md

@@ -11,7 +11,7 @@ Send through whichever provider is up. Priority and failover, reordered live.
 
 ## Package overview
 
-Anyone calling somebody else's API who needs the failure classified rather than guessed. Provider capabilities stay independent from application-owned services, which attach named methods by priority with health tracking. Supported runtimes: bun, node, workers, deno. Package root: @forgezero/providers. The sections below show the actual named imports emitted by each declaration entry point; wildcard imports are intentionally not used in the documentation.
+Anyone calling somebody else's API who needs the failure classified rather than guessed. Provider capabilities stay independent from application-owned services, which attach named methods by priority with health tracking. Supported runtimes: bun, node, workers, deno. Package root: @forgezero/providers. Consumer documentation is curated with each module's explicit public flag; the complete internal/export inventory remains in the typed SSOT and declaration files.
 
 ```text
 bun add @forgezero/providers
@@ -29,9 +29,9 @@ The five packages are installation boundaries. Choose a package by who installs
 | @forgezero/runtime | Portable runtime primitives for queries, jobs, events, schemas and finance. | bun, node | [Open](https://www.forgezero.net/docs/runtime) |
 | @forgezero/agent | Operator CLI and managed-node agent for bootstrap, deploy and lifecycle. | bun, node | [Open](https://www.forgezero.net/docs/agent) |
 
-## @forgezero/providers public imports and commands
+## @forgezero/providers supported imports and commands
 
-Every row links to the detailed explanation and named-import/example area below. This table and those details are generated from the package inventory and emitted declarations.
+These are supported consumer entry points, not every internal module shipped for ForgeZero managed installation. Each row links to its task-oriented usage.
 
 | public entry | short description | runtime | details |
 |---|---|---|---|
@@ -59,61 +59,11 @@ bun test
 <a id="forgezero-providers"></a>
 ## @forgezero/providers
 
-The registry: priority, health, and a terminal-versus-retryable verdict per failure. This entry exposes 17 named value exports and 31 named type exports. The generated import block lists one name per line for scanning and copying; keep only the names used by your file.
+The registry: priority, health, and a terminal-versus-retryable verdict per failure. This is a supported entry point. Import only the named values used by the adjacent task example; the declaration file remains the complete API reference.
 
 ```text
 import {
   ProviderError,
-  STRIKES_TO_OFFLINE,
-  VERSION,
-  chainCredentials,
-  chainScopedCredentials,
-  createRegistry,
-  createService,
-  defineProvider,
-  defineProviderMethod,
-  defineProviderMethodBranches,
-  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,
-  ProviderMethodBranches,
-  ProviderMethodEntry,
-  ProviderMethodSpec,
-  ProviderMethods,
-  RegistryOptions,
-  ScopedCredentialSource,
-  ServiceDefinition,
-  ServiceMethodAttachment,
-  ServiceMethodContract,
-  ServiceMethods,
-  StaticRegistryConfig,
 } from '@forgezero/providers';
 ```
 
@@ -189,19 +139,11 @@ 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. 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.
+JetEmail (`send`, `sendBatch`), SMTP (`send` only), and the typed email service contract; SMTP transport is injected. This is a supported entry point. Import only the named values used by the adjacent task example; the declaration file remains the complete API reference.
 
 ```text
 import {
   emailProviders,
-  emailService,
-  jetemail,
-  smtp,
-} from '@forgezero/providers/email';
-
-import type {
-  JetEmailConfig,
-  SmtpTransport,
 } from '@forgezero/providers/email';
 ```
 
@@ -250,27 +192,11 @@ 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. 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.
+ArangoDB in the registry for credential rotation and health — with failover off by default. This is a supported entry point. Import only the named values used by the adjacent task example; the declaration file remains the complete API reference.
 
 ```text
 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';
 ```
 
@@ -289,27 +215,11 @@ export const selectedCapability = ARANGO_COMMUNITY_VERSION;
 <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. 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.
+Outbound HTTP with a per-host weight budget reserved before the call and settled from the response. This is a supported entry point. Import only the named values used by the adjacent task example; the declaration file remains the complete API reference.
 
 ```text
 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';
 ```
 
@@ -328,20 +238,11 @@ export const selectedCapability = BudgetExhausted;
 <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. 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.
+Which outbound address a request leaves by, sticky per key, over the same budget as everything else. This is a supported entry point. Import only the named values used by the adjacent task example; the declaration file remains the complete API reference.
 
 ```text
 import {
   PoolEmpty,
-  PoolExhausted,
-  createAddressPool,
-} from '@forgezero/providers/pool';
-
-import type {
-  AddressPool,
-  Lease,
-  PoolAddress,
-  PoolOptions,
 } from '@forgezero/providers/pool';
 ```
 
@@ -360,19 +261,12 @@ export const selectedCapability = PoolEmpty;
 <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. 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.
+An EVM node behind the same failover as any other service: read logs, broadcast, and never stop scanning because one endpoint rate-limited. This is a supported entry point. Import only the named values used by the adjacent task example; the declaration file remains the complete API reference.
 
 ```text
 import {
   evmRpc,
 } from '@forgezero/providers/chain';
-
-import type {
-  ChainCall,
-  ChainLog,
-  ChainReceipt,
-  ChainResult,
-} from '@forgezero/providers/chain';
 ```
 
 ## @forgezero/providers/chain — Use this entry point
@@ -390,19 +284,11 @@ export const selectedCapability = evmRpc;
 <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. 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.
+Binance behind the venue adapter: three hosts, one weight budget, signed over the exact string that is sent. This is a supported entry point. Import only the named values used by the adjacent task example; the declaration file remains the complete API reference.
 
 ```text
 import {
   binanceSymbol,
-  createBinanceAdapter,
-  readBinanceError,
-  toOrderStatus,
-} from '@forgezero/providers/binance';
-
-import type {
-  BinanceCredentials,
-  BinanceOptions,
 } from '@forgezero/providers/binance';
 ```
 
@@ -421,29 +307,11 @@ export const selectedCapability = binanceSymbol;
 <a id="forgezero-providers-storage"></a>
 ## @forgezero/providers/storage
 
-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.
+S3-compatible object storage, SigV4 signed with Web Crypto and no vendor SDK. This is a supported entry point. Import only the named values used by the adjacent task example; the declaration file remains the complete API reference.
 
 ```text
 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';
 ```
 
@@ -462,20 +330,11 @@ export const selectedCapability = MAX_SINGLE_PUT_BYTES;
 <a id="forgezero-providers-translation"></a>
 ## @forgezero/providers/translation
 
-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.
+Google AI Studio translation with strict batch alignment and classified quota failures. This is a supported entry point. Import only the named values used by the adjacent task example; the declaration file remains the complete API reference.
 
 ```text
 import {
   TranslationError,
-  googleAiStudio,
-  parseStrings,
-  translationProviders,
-} from '@forgezero/providers/translation';
-
-import type {
-  TranslateRequest,
-  TranslateResult,
-  TranslationProvider,
 } from '@forgezero/providers/translation';
 ```
 
@@ -494,16 +353,11 @@ export const selectedCapability = TranslationError;
 <a id="forgezero-providers-realtime"></a>
 ## @forgezero/providers/realtime
 
-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.
+Cloudflare KV node-directory and Durable Object fan-out clients for project-defined realtime services. This is a supported entry point. Import only the named values used by the adjacent task example; the declaration file remains the complete API reference.
 
 ```text
 import {
   RealtimeProviderError,
-  cloudflareRealtime,
-} from '@forgezero/providers/realtime';
-
-import type {
-  RealtimeProviderOptions,
 } from '@forgezero/providers/realtime';
 ```
 

package/dist/binance.js

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

package/dist/chain.js

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

package/dist/database.js

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

package/dist/email.d.ts

@@ -2,6 +2,10 @@ import { type EmailBatch, type EmailBatchResult, type EmailMessage } from './ind
 export interface JetEmailConfig {
     /** EU residency endpoint. */
     eu?: boolean;
+    /** Bare sender mailbox. JetEmail's wire API receives it as `Name <mailbox>`. */
+    from?: string;
+    /** Optional display name. Defaults to the sender mailbox local part. */
+    fromName?: string;
     endpoint?: string;
     batchEndpoint?: string;
     fetch?: typeof globalThis.fetch;

package/dist/email.js

@@ -336,7 +336,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.20";
+var VERSION = "0.1.22";
 
 // src/email.ts
 var recipients = (to) => Array.isArray(to) ? [...to] : [to];
@@ -348,6 +348,19 @@ function assertMessage(message) {
     throw new ProviderError("EMAIL_NO_BODY", "An email needs html, text, or both.");
   }
 }
+var JETEMAIL_MAILBOX = /^[^\s<>@]+@[^\s<>@]+\.[^\s<>@]+$/;
+function jetemailSender(config, override) {
+  const mailbox = (override ?? config.from ?? "").trim();
+  if (!JETEMAIL_MAILBOX.test(mailbox)) {
+    throw new ProviderError("JETEMAIL_FROM", "JetEmail needs a valid sender mailbox.");
+  }
+  const fallbackName = mailbox.slice(0, mailbox.indexOf("@"));
+  const name = (config.fromName ?? fallbackName).trim();
+  if (!name || /[\r\n<>]/.test(name)) {
+    throw new ProviderError("JETEMAIL_FROM_NAME", "JetEmail sender name must be non-empty and header-safe.");
+  }
+  return `${name} <${mailbox}>`;
+}
 var jetemailCredentials = {
   type: "object",
   additionalProperties: false,
@@ -366,7 +379,8 @@ var jetemailConfig = {
   additionalProperties: false,
   properties: {
     eu: { type: "boolean", default: false, title: "EU residency" },
-    from: { type: "string", format: "email", title: "Default from address" }
+    from: { type: "string", format: "email", title: "Default from address" },
+    fromName: { type: "string", minLength: 1, maxLength: 120, title: "Sender name" }
   }
 };
 var jetemailSend = defineProviderMethod({
@@ -386,7 +400,7 @@ var jetemailSend = defineProviderMethod({
         ...message.idempotencyKey ? { "idempotency-key": message.idempotencyKey } : {}
       },
       body: JSON.stringify({
-        from: message.from ?? config.from,
+        from: jetemailSender(config, message.from),
         to: recipients(message.to),
         subject: message.subject,
         html: message.html,
@@ -395,7 +409,7 @@ var jetemailSend = defineProviderMethod({
         eu: config.eu ?? false
       })
     });
-    if (response.status === 201 || response.status === 202) {
+    if (response.status === 200 || response.status === 201 || response.status === 202) {
       const payload = await response.json().catch(() => ({}));
       return { id: payload.id ?? "" };
     }
@@ -437,7 +451,7 @@ var jetemailSendBatch = defineProviderMethod({
       },
       body: JSON.stringify({
         emails: batch.emails.map((message) => ({
-          from: message.from ?? config.from,
+          from: jetemailSender(config, message.from),
           to: recipients(message.to),
           subject: message.subject,
           html: message.html,

package/dist/http.js

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

package/dist/index.d.ts

@@ -303,5 +303,5 @@ export interface EmailBatchResult {
     };
     results: readonly EmailBatchItemResult[];
 }
-export declare const VERSION = "0.1.20";
+export declare const VERSION = "0.1.22";
 export {};

package/dist/index.js

@@ -336,7 +336,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.20";
+var VERSION = "0.1.22";
 export {
   staticConfig,
   serviceMethod,

package/dist/pool.js

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

package/dist/storage.js

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

package/dist/translation.js

@@ -336,7 +336,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.20";
+var VERSION = "0.1.22";
 
 // 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.20",
+  "version": "0.1.22",
   "type": "module",
   "publishConfig": {
     "access": "public",
@@ -85,6 +85,6 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@forgezero/runtime": "^0.1.13"
+    "@forgezero/runtime": "^0.1.14"
   }
 }