@forklaunch/core 3.0.0 → 3.1.0

package/bin/gateway-mock/server.mjs

@@ -49,7 +49,9 @@
  *   MOCK_INSTANCE_HMAC_KEY  verify instance signatures and sign events
  *                           (unset: accept any signature; events unsigned)
  *   MOCK_EVENTS_URL         the app's base URL for event delivery
- *   MOCK_EVENTS_URL_<FEATURE>  per-feature override (the service that declared it)
+ *   MOCK_EVENTS_URL_<FEATURE>  per-feature override (the service that declared it);
+ *                           a comma-separated list when several projects hold
+ *                           the feature — each event goes to every entry
  *   (plus each feature's own MOCK_* settings; see its route file)
  *
  * Usage: npx -p @forklaunch/core forklaunch-gateway-mock
@@ -141,34 +143,50 @@ export async function startGatewayMock(env = process.env) {
       occurredAt: new Date().toISOString(),
       data: data ?? {}
     };
-    const record = { event, status: null, error: null };
+    const record = { event, status: null, error: null, deliveries: [] };
     events.push(record);
-    // A feature's events can go to its own service (MOCK_EVENTS_URL_<FEATURE>).
-    const target =
+    // A feature's events can go to its own service (MOCK_EVENTS_URL_<FEATURE>),
+    // or to several: every project that holds the feature, comma-separated.
+    const targets = (
       env[`MOCK_EVENTS_URL_${feature.toUpperCase().replace(/-/g, '_')}`] ||
-      eventsUrl;
-    if (!target) {
+      eventsUrl
+    )
+      .split(',')
+      .map((t) => t.trim())
+      .filter(Boolean);
+    if (targets.length === 0) {
       record.error = 'MOCK_EVENTS_URL is not set; event recorded, not delivered';
       return record;
     }
     const path = `/platform-events/${feature}`;
     const body = JSON.stringify(event);
-    const headers = { 'content-type': 'application/json' };
-    if (hmacKey) {
-      const ts = new Date().toISOString();
-      const nonce = randomUUID();
-      headers.authorization = `HMAC keyId=platform ts=${ts} nonce=${nonce} signature=${sign(hmacKey, 'POST', path, `${body}\n`, ts, nonce)}`;
-    }
-    try {
-      const response = await fetch(`${target.replace(/\/$/, '')}${path}`, {
-        method: 'POST',
-        headers,
-        body
-      });
-      record.status = response.status;
-    } catch (error) {
-      record.error = String(error?.message ?? error);
+    for (const target of targets) {
+      // A fresh signature per destination: each app rejects a reused nonce.
+      const headers = { 'content-type': 'application/json' };
+      if (hmacKey) {
+        const ts = new Date().toISOString();
+        const nonce = randomUUID();
+        headers.authorization = `HMAC keyId=platform ts=${ts} nonce=${nonce} signature=${sign(hmacKey, 'POST', path, `${body}\n`, ts, nonce)}`;
+      }
+      const delivery = { target, status: null, error: null };
+      try {
+        const response = await fetch(`${target.replace(/\/$/, '')}${path}`, {
+          method: 'POST',
+          headers,
+          body
+        });
+        delivery.status = response.status;
+      } catch (error) {
+        delivery.error = String(error?.message ?? error);
+      }
+      record.deliveries.push(delivery);
     }
+    // The summary: the first failed delivery, else the last one.
+    const summary =
+      record.deliveries.find((d) => d.error || d.status >= 300) ??
+      record.deliveries[record.deliveries.length - 1];
+    record.status = summary.status;
+    record.error = summary.error;
     return record;
   }
 

package/lib/http/index.d.ts

@@ -6,6 +6,7 @@ export * from './createHmacToken';
 export * from './generateHmacAuthHeaders';
 export * from './instanceGateway';
 export * from './modelGatewayClient';
+export * from './previewModelGatewayClient';
 export * from './emailClient';
 export * from './smsClient';
 export * from './whatsappClient';

package/lib/http/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AACnC,cAAc,sCAAsC,CAAC;AACrD,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0CAA0C,CAAC;AACzD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+CAA+C,CAAC;AAC9D,cAAc,wDAAwD,CAAC;AACvE,cAAc,yCAAyC,CAAC;AACxD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oCAAoC,CAAC;AACnD,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AACnC,cAAc,sCAAsC,CAAC;AACrD,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0CAA0C,CAAC;AACzD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+CAA+C,CAAC;AAC9D,cAAc,wDAAwD,CAAC;AACvE,cAAc,yCAAyC,CAAC;AACxD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oCAAoC,CAAC;AACnD,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,cAAc,4BAA4B,CAAC"}

package/lib/http/index.js

@@ -69,6 +69,7 @@ __export(http_exports, {
   createInstanceGatewayTransport: () => createInstanceGatewayTransport,
   createModelGatewayClient: () => createModelGatewayClient,
   createPaymentsClient: () => createPaymentsClient,
+  createPreviewModelGatewayClient: () => createPreviewModelGatewayClient,
   createSmsClient: () => createSmsClient,
   createStripeClient: () => createStripeClient,
   createVoiceClient: () => createVoiceClient,
@@ -2738,6 +2739,92 @@ async function* sseData(stream) {
   }
 }
 
+// src/http/previewModelGatewayClient.ts
+function record(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function invalidCatalog() {
+  throw new ModelGatewayRequestError(
+    502,
+    "The local preview model catalog is invalid or expired."
+  );
+}
+function previewCatalog(raw) {
+  if (!record(raw) || !record(raw.preview)) return invalidCatalog();
+  const preview = raw.preview;
+  if (Object.keys(raw).some((key) => !["models", "preview"].includes(key)) || Object.keys(preview).some(
+    (key) => !["expiresAt", "maxCalls", "maxUnits"].includes(key)
+  ) || !Array.isArray(raw.models) || raw.models.length !== 1 || !record(raw.models[0]) || Object.keys(raw.models[0]).some((key) => key !== "id") || typeof raw.models[0].id !== "string" || !/^[\w.:-]{1,160}$/.test(raw.models[0].id) || typeof preview.expiresAt !== "number" || !Number.isSafeInteger(preview.expiresAt) || preview.expiresAt <= Date.now() || preview.expiresAt > Date.now() + 15 * 6e4 || typeof preview.maxCalls !== "number" || !Number.isSafeInteger(preview.maxCalls) || preview.maxCalls < 1 || preview.maxCalls > 20 || typeof preview.maxUnits !== "number" || !Number.isSafeInteger(preview.maxUnits) || preview.maxUnits < 1 || preview.maxUnits > 1e5)
+    return invalidCatalog();
+  return {
+    models: [{ id: raw.models[0].id }],
+    preview: {
+      expiresAt: preview.expiresAt,
+      maxCalls: preview.maxCalls,
+      maxUnits: preview.maxUnits
+    }
+  };
+}
+async function readPreviewCatalog(response) {
+  if (!response.body) return invalidCatalog();
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  let text = "", bytes = 0;
+  try {
+    for (; ; ) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      bytes += value.byteLength;
+      if (bytes > 8192) return invalidCatalog();
+      text += decoder.decode(value, { stream: true });
+    }
+    text += decoder.decode();
+    return previewCatalog(JSON.parse(text));
+  } catch {
+    return invalidCatalog();
+  } finally {
+    await reader.cancel().catch(() => {
+    });
+    reader.releaseLock();
+  }
+}
+function createPreviewModelGatewayClient(options2 = {}) {
+  const transport = createInstanceGatewayTransport(
+    options2,
+    "The local preview model gateway"
+  );
+  async function send(method, route, body) {
+    try {
+      return await transport.request(method, route, body);
+    } catch (error) {
+      if (error instanceof InstanceGatewayRequestError)
+        throw new ModelGatewayRequestError(
+          error.status,
+          "The local preview model request was refused or is unavailable.",
+          error.retryAfterSeconds
+        );
+      throw error;
+    }
+  }
+  return {
+    async models() {
+      const response = await send("GET", "/models");
+      return readPreviewCatalog(response);
+    },
+    chat: {
+      completions: {
+        async create(request) {
+          return await (await send(
+            "POST",
+            "/models/chat/completions",
+            request
+          )).json();
+        }
+      }
+    }
+  };
+}
+
 // src/http/emailClient.ts
 var EmailRequestError = class extends InstanceGatewayRequestError {
   name = "EmailRequestError";
@@ -2823,7 +2910,7 @@ function createEmailClient(options2 = {}) {
     INSTANCE_HMAC_KEY: options2.hmacKey ?? process.env.INSTANCE_HMAC_KEY
   })) {
     throw new Error(
-      "Email is sent by the ForkLaunch platform and is only available to managed instances: PLATFORM_GATEWAY_URL, INSTANCE_ID and INSTANCE_HMAC_KEY must be set. Locally, `forklaunch infra add <service> email` sets them to the gateway mock in docker-compose."
+      "Email is sent by the ForkLaunch platform: PLATFORM_GATEWAY_URL, INSTANCE_ID and INSTANCE_HMAC_KEY must be set. A managed instance and an app deployed with `forklaunch deploy create` get them from the platform at deploy. Locally, `forklaunch infra add <service> email` sets them to the gateway mock in docker-compose."
     );
   }
   const transport = createInstanceGatewayTransport(options2, "Email");
@@ -3251,6 +3338,9 @@ function createStripeClient(options2 = {}) {
   const explicitGateway = Boolean(
     options2.gatewayUrl || options2.instanceId || options2.hmacKey
   );
+  if (!explicitGateway && options2.apiKey) {
+    return new StripeClass(options2.apiKey, options2.config);
+  }
   if (!explicitGateway && !isManagedInstance()) {
     if (!options2.apiKey) {
       throw new Error(
@@ -5325,8 +5415,8 @@ var RateLimiter = class {
       const now = Date.now();
       let counter;
       try {
-        const record = await this.cache.readRecord(key);
-        counter = record.value;
+        const record2 = await this.cache.readRecord(key);
+        counter = record2.value;
         if (now >= counter.resetAt) {
           counter = { count: 0, resetAt: now + windowMs };
         }
@@ -5410,6 +5500,7 @@ var RateLimiter = class {
   createInstanceGatewayTransport,
   createModelGatewayClient,
   createPaymentsClient,
+  createPreviewModelGatewayClient,
   createSmsClient,
   createStripeClient,
   createVoiceClient,