// --------------------------------------------------------------------------- // Autumn billing service — wraps the autumn-js SDK with Effect // --------------------------------------------------------------------------- import { env } from "cloudflare:workers"; import { Autumn } from "autumn-js"; import { Context, Data, Effect, Layer } from "effect"; import { captureCauseEffect } from "../../observability"; // --------------------------------------------------------------------------- // Errors // --------------------------------------------------------------------------- export class AutumnError extends Data.TaggedError("AutumnError")<{ message: string; cause?: unknown; }> {} // --------------------------------------------------------------------------- // Service interface // --------------------------------------------------------------------------- export type IAutumnService = Readonly<{ use: (fn: (client: Autumn) => Promise) => Effect.Effect; checkExecutionBalance: ( organizationId: string, ) => Effect.Effect<{ readonly allowed: boolean }, AutumnError, never>; /** * Fire-and-forget-safe execution usage tracker. Errors are caught and * logged; the returned Effect never fails. Callers typically * `Effect.runFork` it at the boundary so the billing call can't stall a * user-facing request. */ trackExecution: (organizationId: string) => Effect.Effect; }>; // --------------------------------------------------------------------------- // Implementation // --------------------------------------------------------------------------- const make = Effect.sync(() => { const secretKey = env.AUTUMN_SECRET_KEY; if (!secretKey) { const notConfigured = Effect.fail( new AutumnError({ message: "Autumn not configured: AUTUMN_SECRET_KEY is empty" }), ); return { use: () => notConfigured, checkExecutionBalance: () => notConfigured, trackExecution: () => Effect.void, } satisfies IAutumnService; } // AUTUMN_API_URL points the real SDK at an Autumn emulator in tests/dev. const client = new Autumn({ secretKey, ...(env.AUTUMN_API_URL ? { serverURL: env.AUTUMN_API_URL } : {}), }); const use = (fn: (client: Autumn) => Promise) => Effect.tryPromise({ try: () => fn(client), catch: (cause) => new AutumnError({ message: "Autumn SDK request failed", cause }), }).pipe(Effect.withSpan(`autumn.${fn.name ?? "use"}`)); const trackExecution = (organizationId: string) => Effect.gen(function* () { yield* Effect.annotateCurrentSpan({ "autumn.customer.id": organizationId }); yield* use((c) => c.track({ customerId: organizationId, featureId: "executions", value: 1 }), ).pipe( Effect.catchTag("AutumnError", (error) => Effect.gen(function* () { // Silent billing data loss is worth paging on: autumn.trackExecution // is fire-and-forget so the caller doesn't handle it themselves. yield* Effect.sync(() => { console.error("[billing] track failed:", error); }); yield* captureCauseEffect(error); yield* Effect.annotateCurrentSpan({ "autumn.track.failed": true }); }), ), ); }).pipe(Effect.withSpan("autumn.trackExecution")); const checkExecutionBalance = (organizationId: string) => Effect.gen(function* () { yield* Effect.annotateCurrentSpan({ "autumn.customer.id": organizationId }); const check = yield* use((c) => c.check({ customerId: organizationId, featureId: "executions" }), ); return { allowed: check.allowed }; }).pipe(Effect.withSpan("autumn.checkExecutionBalance")); return { use, checkExecutionBalance, trackExecution } satisfies IAutumnService; }); export class AutumnService extends Context.Service()( "@executor-js/cloud/AutumnService", ) { static Default = Layer.effect(this)(make); }