@forgezero/providers 0.1.11 → 0.1.12

package/README.md

@@ -112,11 +112,14 @@ import * as api from '@forgezero/providers/realtime';
 The service owns send/sendBatch. Attach provider methods directly in priority arrays; SMTP is never presented as batch-capable.
 
 ```text
-import { createService } from '@forgezero/providers';
-import { emailService, jetemail, smtp } from '@forgezero/providers/email';
+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;
+
 const vault = createVault({ project: 'my-project', environment: 'production' });
 const email = createService(emailService, {
   send: [
@@ -128,7 +131,10 @@ const email = createService(emailService, {
   ]
 });
 
+const message: EmailMessage = { to: 'user@example.com', subject: 'Hello', text: 'Sent by ForgeZero' };
 const outcome = await email.call('send', message);
+if (!outcome.ok) throw outcome.error;
+console.log(outcome.result, outcome.attempts);
 ```
 
 ## Extend with a custom provider and service
@@ -136,9 +142,26 @@ const outcome = await email.call('send', message);
 Public consumers define provider capabilities and application services independently, then attach them with the same ordered-array API.
 
 ```text
-const postmark = defineProvider({
-  id: 'postmark', label: 'Postmark',
-  methods: { deliver: defineProviderMethod({ invoke, classify }) }
+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 };
+const vault = createVault({ project: 'my-project', environment: 'production' });
+
+const postmark = defineSingleMethodProvider({
+  id: 'postmark', label: 'Postmark', method: 'deliver',
+  async invoke(context, notice: Notice): Promise<Receipt> {
+    const response = await fetch('https://api.postmarkapp.com/email', {
+      method: 'POST', signal: context.signal,
+      headers: { 'x-postmark-server-token': await context.secret('apiKey') },
+      body: JSON.stringify(notice)
+    });
+    if (!response.ok) throw new Error(`Postmark returned ${response.status}`);
+    return { id: response.headers.get('x-message-id') ?? crypto.randomUUID() };
+  },
+  classify: () => 'retryable'
 });
 const notifications = defineService({
   key: 'notifications', methods: { deliver: serviceMethod<Notice, Receipt>() }
@@ -153,6 +176,11 @@ 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';
+
+const vault = createVault({ project: 'my-project', environment: 'production' });
 const credentials = chainScopedCredentials(
   vaultCredentials(vault, 'jetemail'),
   scopeCredentials(systemdCredentials({

package/dist/binance.js

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

package/dist/chain.js

@@ -298,7 +298,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.11";
+var VERSION = "0.1.12";
 
 // 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.11";
+var VERSION = "0.1.12";
 
 // src/database.ts
 var pools = new Map;

package/dist/email.js

@@ -298,7 +298,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.11";
+var VERSION = "0.1.12";
 
 // 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.11";
+var VERSION = "0.1.12";
 
 // 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.11";
+export declare const VERSION = "0.1.12";
 export {};

package/dist/index.js

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

package/dist/pool.js

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

package/dist/storage.js

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

package/dist/translation.js

@@ -298,7 +298,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.11";
+var VERSION = "0.1.12";
 
 // 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.11",
+	"version": "0.1.12",
   "type": "module",
   "publishConfig": {
     "access": "public",
@@ -86,6 +86,6 @@
     "LICENSE"
   ],
   "dependencies": {
-	"@forgezero/runtime": "^0.1.6"
+	"@forgezero/runtime": "^0.1.7"
   }
 }