@forgezero/providers 0.1.8 → 0.1.9

package/dist/binance.js

@@ -144,7 +144,7 @@ function createRegistry(options) {
   }
   return { call };
 }
-var VERSION = "0.1.8";
+var VERSION = "0.1.9";
 
 // src/http.ts
 class BudgetExhausted extends ProviderError {

package/dist/chain.js

@@ -144,7 +144,7 @@ function createRegistry(options) {
   }
   return { call };
 }
-var VERSION = "0.1.8";
+var VERSION = "0.1.9";
 
 // src/chain.ts
 var hexToNumber = (value) => Number(BigInt(value));

package/dist/database.js

@@ -144,7 +144,7 @@ function createRegistry(options) {
   }
   return { call };
 }
-var VERSION = "0.1.8";
+var VERSION = "0.1.9";
 
 // src/database.ts
 var pools = new Map;

package/dist/email.d.ts

@@ -1,8 +1,9 @@
-import { type EmailMessage } from './index';
+import { type EmailBatch, type EmailBatchResult, type EmailMessage } from './index';
 export interface JetEmailConfig {
     /** EU residency endpoint. */
     eu?: boolean;
     endpoint?: string;
+    batchEndpoint?: string;
     fetch?: typeof globalThis.fetch;
 }
 /**
@@ -22,6 +23,8 @@ export interface JetEmailConfig {
 export declare const jetemail: import("./index").ProviderSpec<EmailMessage, {
     id: string;
 }>;
+/** JetEmail's native POST /email-batch capability. */
+export declare const jetemailBatch: import("./index").ProviderSpec<EmailBatch, EmailBatchResult>;
 /**
  * A transport, so this package holds no socket code and no nodemailer.
  *
@@ -60,9 +63,17 @@ export interface SmtpTransport {
 export declare const smtp: import("./index").ProviderSpec<EmailMessage, {
     id: string;
 }>;
+/**
+ * SMTP has no native batch protocol. This adapter deliberately returns one
+ * result per message and never throws after a partial send, so the registry
+ * cannot replay an already-delivered prefix through another provider.
+ */
+export declare const smtpBatch: import("./index").ProviderSpec<EmailBatch, EmailBatchResult>;
 /** Ready to register. Order here is irrelevant; the config decides priority. */
 export declare const emailProviders: readonly [import("./index").ProviderSpec<EmailMessage, {
     id: string;
 }>, import("./index").ProviderSpec<EmailMessage, {
     id: string;
 }>];
+/** The separate batch service attaches the providers' batch methods in priority order. */
+export declare const emailBatchProviders: readonly [import("./index").ProviderSpec<EmailBatch, EmailBatchResult>, import("./index").ProviderSpec<EmailBatch, EmailBatchResult>];

package/dist/email.js

@@ -144,7 +144,7 @@ function createRegistry(options) {
   }
   return { call };
 }
-var VERSION = "0.1.8";
+var VERSION = "0.1.9";
 
 // src/email.ts
 var recipients = (to) => Array.isArray(to) ? [...to] : [to];
@@ -191,7 +191,8 @@ var jetemail = defineProvider({
       signal: context.signal,
       headers: {
         "content-type": "application/json",
-        authorization: `Bearer ${await context.secret("apiKey")}`
+        authorization: `Bearer ${await context.secret("apiKey")}`,
+        ...message.idempotencyKey ? { "idempotency-key": message.idempotencyKey } : {}
       },
       body: JSON.stringify({
         from: message.from ?? config.from,
@@ -222,6 +223,72 @@ var jetemail = defineProvider({
     return "retryable";
   }
 });
+function assertBatch(batch) {
+  if (!Array.isArray(batch.emails) || batch.emails.length < 1 || batch.emails.length > 100) {
+    throw new ProviderError("EMAIL_BATCH_SIZE", "An email batch must contain between 1 and 100 messages.");
+  }
+  for (const message of batch.emails)
+    assertMessage(message);
+}
+var jetemailBatch = defineProvider({
+  id: "jetemail",
+  service: "email.batch",
+  label: "JetEmail",
+  credentials: jetemail.credentials,
+  config: jetemail.config,
+  async invoke(context, batch) {
+    assertBatch(batch);
+    const config = context.config;
+    const doFetch = config.fetch ?? globalThis.fetch;
+    const response = await doFetch(config.batchEndpoint ?? "https://api.jetemail.com/email-batch", {
+      method: "POST",
+      signal: context.signal,
+      headers: {
+        "content-type": "application/json",
+        authorization: `Bearer ${await context.secret("apiKey")}`
+      },
+      body: JSON.stringify({
+        emails: batch.emails.map((message) => ({
+          from: message.from ?? config.from,
+          to: recipients(message.to),
+          subject: message.subject,
+          html: message.html,
+          text: message.text,
+          reply_to: message.replyTo,
+          eu: config.eu ?? false
+        }))
+      })
+    });
+    if (response.status !== 207) {
+      const detail = await response.text().catch(() => "");
+      throw Object.assign(new Error(`JetEmail batch ${response.status}: ${detail.slice(0, 200)}`), {
+        status: response.status,
+        retryAfter: response.headers.get("retry-after")
+      });
+    }
+    const payload = await response.json().catch(() => null);
+    if (!payload?.summary || !Array.isArray(payload.results) || ![payload.summary.total, payload.summary.successful, payload.summary.failed].every((value) => Number.isInteger(value) && value >= 0)) {
+      throw new ProviderError("JETEMAIL_BATCH_RESPONSE", "JetEmail returned a malformed batch response.");
+    }
+    const summary = payload.summary;
+    if (summary.total !== batch.emails.length || summary.successful + summary.failed !== summary.total) {
+      throw new ProviderError("JETEMAIL_BATCH_RESPONSE", "JetEmail batch totals do not match the request.");
+    }
+    const results = payload.results.map((item) => {
+      if (!item || typeof item !== "object")
+        return { status: "failed", error: "Malformed provider result" };
+      const row = item;
+      return {
+        status: row.status === "success" ? "success" : "failed",
+        ...typeof row.id === "string" ? { id: row.id } : {},
+        ...typeof row.response === "string" ? { response: row.response.slice(0, 500) } : {},
+        ...typeof row.error === "string" ? { error: row.error.slice(0, 500) } : {}
+      };
+    });
+    return { summary, results };
+  },
+  classify: jetemail.classify
+});
 var smtp = defineProvider({
   id: "smtp",
   service: "email",
@@ -289,9 +356,45 @@ var smtp = defineProvider({
     return "retryable";
   }
 });
+var smtpBatch = defineProvider({
+  id: "smtp",
+  service: "email.batch",
+  label: "SMTP",
+  multiInstance: true,
+  credentials: smtp.credentials,
+  config: smtp.config,
+  async invoke(context, batch) {
+    assertBatch(batch);
+    const results = [];
+    for (let offset = 0;offset < batch.emails.length; offset += 5) {
+      const rows = await Promise.all(batch.emails.slice(offset, offset + 5).map(async (message) => {
+        try {
+          const sent = await smtp.invoke(context, message);
+          return { status: "success", id: sent.id };
+        } catch (cause) {
+          return {
+            status: "failed",
+            error: cause instanceof Error ? cause.message.slice(0, 500) : "SMTP send failed"
+          };
+        }
+      }));
+      results.push(...rows);
+    }
+    const successful = results.filter((result) => result.status === "success").length;
+    return {
+      summary: { total: results.length, successful, failed: results.length - successful },
+      results
+    };
+  },
+  classify: smtp.classify
+});
 var emailProviders = [jetemail, smtp];
+var emailBatchProviders = [jetemailBatch, smtpBatch];
 export {
+  smtpBatch,
   smtp,
+  jetemailBatch,
   jetemail,
-  emailProviders
+  emailProviders,
+  emailBatchProviders
 };

package/dist/http.js

@@ -144,7 +144,7 @@ function createRegistry(options) {
   }
   return { call };
 }
-var VERSION = "0.1.8";
+var VERSION = "0.1.9";
 
 // src/http.ts
 class BudgetExhausted extends ProviderError {

package/dist/index.d.ts

@@ -155,5 +155,25 @@ export interface EmailMessage {
     text?: string;
     from?: string;
     replyTo?: string;
+    /** Stable caller-owned key for providers that support safe replay. */
+    idempotencyKey?: string;
 }
-export declare const VERSION = "0.1.8";
+export interface EmailBatch {
+    /** Provider-neutral hard ceiling matches JetEmail's native batch contract. */
+    emails: readonly EmailMessage[];
+}
+export interface EmailBatchItemResult {
+    status: 'success' | 'failed';
+    id?: string;
+    response?: string;
+    error?: string;
+}
+export interface EmailBatchResult {
+    summary: {
+        total: number;
+        successful: number;
+        failed: number;
+    };
+    results: readonly EmailBatchItemResult[];
+}
+export declare const VERSION = "0.1.9";

package/dist/index.js

@@ -144,7 +144,7 @@ function createRegistry(options) {
   }
   return { call };
 }
-var VERSION = "0.1.8";
+var VERSION = "0.1.9";
 export {
   staticConfig,
   nextHealth,

package/dist/pool.js

@@ -144,7 +144,7 @@ function createRegistry(options) {
   }
   return { call };
 }
-var VERSION = "0.1.8";
+var VERSION = "0.1.9";
 
 // src/http.ts
 class BudgetExhausted extends ProviderError {

package/dist/realtime.d.ts

@@ -0,0 +1,19 @@
+import { type RealtimeBatch } from '@forgezero/runtime/realtime';
+export interface RealtimeProviderOptions {
+    endpoint: string;
+    secret: string;
+    producer: string;
+    requestTimeoutMs?: number;
+    fetcher?: typeof fetch;
+}
+export declare class RealtimeProviderError extends Error {
+    readonly code: 'INVALID_CONFIG' | 'UNAVAILABLE' | 'REFUSED';
+    constructor(code: 'INVALID_CONFIG' | 'UNAVAILABLE' | 'REFUSED', message: string);
+}
+/** One external request per batch; Worker/DO bindings own the internal fan-out. */
+export declare function cloudflareRealtime(options: RealtimeProviderOptions): {
+    publish(input: RealtimeBatch): Promise<{
+        delivered: number;
+        shards: number;
+    }>;
+};

package/dist/realtime.js

@@ -0,0 +1,66 @@
+// src/realtime.ts
+import { realtimeBatchBytes, realtimeHmac, validateRealtimeBatch } from "@forgezero/runtime/realtime";
+
+class RealtimeProviderError extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "RealtimeProviderError";
+  }
+}
+var producerPattern = /^[A-Za-z0-9][A-Za-z0-9_.:@/-]{0,127}$/;
+function cloudflareRealtime(options) {
+  const endpoint = new URL(options.endpoint);
+  if (endpoint.protocol !== "https:" || endpoint.username || endpoint.password || endpoint.search || endpoint.hash || !producerPattern.test(options.producer) || new TextEncoder().encode(options.secret).byteLength < 32) {
+    throw new RealtimeProviderError("INVALID_CONFIG", "Realtime endpoint, producer, or secret is invalid.");
+  }
+  endpoint.pathname = "/__fz/realtime/publish";
+  const timeout = options.requestTimeoutMs ?? 5000;
+  if (!Number.isSafeInteger(timeout) || timeout < 100 || timeout > 30000) {
+    throw new RealtimeProviderError("INVALID_CONFIG", "Realtime timeout is invalid.");
+  }
+  const fetcher = options.fetcher ?? fetch;
+  return {
+    async publish(input) {
+      const batch = validateRealtimeBatch(input);
+      const body = realtimeBatchBytes(batch);
+      const timestamp = Math.floor(Date.now() / 1000).toString();
+      const signature = await realtimeHmac(options.secret, `publish
+${options.producer}
+${timestamp}
+${body}`);
+      let response;
+      try {
+        response = await fetcher(endpoint, {
+          method: "POST",
+          body,
+          redirect: "error",
+          signal: AbortSignal.timeout(timeout),
+          headers: {
+            "content-type": "application/json",
+            "x-fz-realtime-producer": options.producer,
+            "x-fz-realtime-timestamp": timestamp,
+            "x-fz-realtime-signature": signature,
+            "idempotency-key": batch.batchId
+          }
+        });
+      } catch {
+        throw new RealtimeProviderError("UNAVAILABLE", "Realtime edge is unavailable.");
+      }
+      if (!response.ok) {
+        await response.body?.cancel();
+        throw new RealtimeProviderError(response.status >= 500 ? "UNAVAILABLE" : "REFUSED", `Realtime edge returned HTTP ${response.status}.`);
+      }
+      const result = await response.json();
+      if (!Number.isSafeInteger(result.delivered) || !Number.isSafeInteger(result.shards)) {
+        throw new RealtimeProviderError("UNAVAILABLE", "Realtime edge returned malformed evidence.");
+      }
+      return { delivered: result.delivered, shards: result.shards };
+    }
+  };
+}
+export {
+  cloudflareRealtime,
+  RealtimeProviderError
+};

package/dist/storage.js

@@ -144,7 +144,7 @@ function createRegistry(options) {
   }
   return { call };
 }
-var VERSION = "0.1.8";
+var VERSION = "0.1.9";
 
 // src/storage.ts
 var encoder = new TextEncoder;

package/dist/translation.js

@@ -144,7 +144,7 @@ function createRegistry(options) {
   }
   return { call };
 }
-var VERSION = "0.1.8";
+var VERSION = "0.1.9";
 
 // 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.8",
+  "version": "0.1.9",
   "type": "module",
   "publishConfig": {
     "access": "public",
@@ -43,11 +43,15 @@
       "types": "./dist/translation.d.ts",
       "default": "./dist/translation.js"
     }
-  },
+    },
+    "./realtime": {
+      "types": "./dist/realtime.d.ts",
+      "default": "./dist/realtime.js"
+    },
 	"scripts": {
 		"check": "tsc --noEmit",
 		"prebuild": "rm -rf dist",
-    "build": "bun build src/index.ts src/email.ts src/chain.ts src/database.ts src/http.ts src/pool.ts src/storage.ts src/binance.ts src/translation.ts --root src --outdir dist --target browser --format esm --packages external && tsc --emitDeclarationOnly --declaration --noEmit false --outDir dist",
+    "build": "bun build src/index.ts src/email.ts src/chain.ts src/database.ts src/http.ts src/pool.ts src/storage.ts src/binance.ts src/translation.ts src/realtime.ts --root src --outdir dist --target browser --format esm --packages external && tsc --emitDeclarationOnly --declaration --noEmit false --outDir dist",
     "prepublishOnly": "bun run check && bun run build"
   },
   "devDependencies": {