@prisma/composer-prisma-cloud 0.2.0 → 0.3.0-dev.1

package/dist/email/index.d.mts

@@ -0,0 +1,282 @@
+import { BuildAdapter, DependencyEnd, Deps, Expose, HydratedDeps, ModuleNode, NODE, ParamNeed, Params, RunnableServiceNode, SecretNeed, SecretValues, Secrets, ServiceNode, Values } from "@prisma/composer";
+import { Type } from "arktype";
+import "@standard-schema/spec";
+//#region ../../1-prisma-cloud/1-extensions/target/dist/index.d.mts
+//#endregion
+//#region src/compute.d.ts
+declare const reservedParams: {
+  readonly port: import("@prisma/composer").ConfigParam<import("@standard-schema/spec").StandardSchemaV1<number, number>>;
+};
+type ReservedParams = typeof reservedParams;
+/**
+ * A Prisma Compute service — declarations only (deps + params + build + the
+ * ports it exposes), no descriptor. `params` merges with the reserved
+ * `ReservedParams` (`port`); a user param whose name collides with a reserved
+ * one fails at authoring, the same way a colliding dependency name does.
+ *
+ *   · run(address, boot) — the process controller: deserialize the platform
+ *     environment (keyed off `address`, the extension's ONE env read) into a
+ *     typed Config, re-emit it under address-free process-local stash keys,
+ *     then call boot() to start the app's entry.
+ *   · load() / config() — called from inside the app's entry: read the stash;
+ *     load() hydrates + memoizes the deps, config() returns the typed params.
+ *     Separate accessors so a dep and a param never share a namespace (ADR-0021).
+ *   · origin() — this service's platform-assigned public origin, read from the
+ *     stash `run()` populates; memoized per process.
+ *
+ * The underlying node carries `extension: '@prisma/composer-prisma-cloud'` —
+ * the control-plane registry key `prisma-composer deploy` resolves through the
+ * app's `prisma-composer.config.ts` (ADR-0017). This module loads nothing at
+ * deploy time; nodes are pure data until run() or load() is called.
+ */
+declare class ComputeService<D extends Deps, P extends Params, E extends Expose, S extends Secrets> implements RunnableServiceNode<D, P & ReservedParams, E, S> {
+  #private;
+  readonly [NODE]: true;
+  readonly kind: 'service';
+  readonly name: string;
+  readonly extension: string;
+  readonly type: string;
+  readonly inputs: D;
+  readonly params: P & ReservedParams;
+  readonly secretSlots: S;
+  readonly build: BuildAdapter;
+  readonly expose: E | undefined;
+  constructor(node: ServiceNode<D, P & ReservedParams, E, S>);
+  run(address: string, boot: () => Promise<unknown>): Promise<unknown>;
+  load(): HydratedDeps<D>;
+  config(): Values<P & ReservedParams>;
+  secrets(): SecretValues<S>;
+  /** This service's platform-assigned public origin — read from the stash
+   *  run() populates and memoized per process. Throws if called before run()
+   *  has stashed it (readOrigin's pinned message). */
+  origin(): string;
+}
+//#endregion
+//#region src/postgres.d.ts
+interface PostgresConfig {
+  readonly url: string;
+}
+//#endregion
+//#region ../../1-prisma-cloud/2-shared-modules/email/dist/email-service-Cm-YAvgn.d.mts
+//#region src/email-service.d.ts
+declare function emailService(opts?: {
+  deliveryUrl?: string;
+}): ComputeService<{
+  db: import("@prisma/composer").DependencyEnd<PostgresConfig, import("@prisma/composer").Contract<"postgres", PostgresConfig>>;
+}, {
+  deliveryMode: import("@prisma/composer").ConfigParam<import("arktype/internal/variants/string.ts").StringType<"resend" | "smtp" | "none", {}>>;
+  deliveryUrl: import("@prisma/composer").ConfigParam<import("@standard-schema/spec").StandardSchemaV1<string, string>>;
+  from: import("@prisma/composer").ConfigParam<import("@standard-schema/spec").StandardSchemaV1<string, string>>;
+}, {
+  send: import("@prisma/composer").Contract<"rpc", {
+    send: (input: {
+      templateId: string;
+      to: string[];
+      subject: string;
+      html: string;
+      idempotencyKey: string;
+      cc?: string[];
+      bcc?: string[];
+      replyTo?: string;
+      text?: string;
+    }) => Promise<{
+      id: string;
+      status: "stored" | "queued" | "sent" | "failed";
+      error?: string;
+    }>;
+  }>;
+  outbox: import("@prisma/composer").Contract<"rpc", {
+    getEmail: (input: {
+      id: string;
+    }) => Promise<{
+      email: {
+        id: string;
+        templateId: string;
+        to: string[];
+        cc: string[];
+        bcc: string[];
+        replyTo: string | null;
+        from: string;
+        subject: string;
+        html: string;
+        text: string | null;
+        status: "stored" | "queued" | "sent" | "failed";
+        providerMessageId: string | null;
+        error: string | null;
+        attempts: number;
+        createdAt: string;
+        updatedAt: string;
+      } | null;
+    }>;
+    listEmails: (input: {
+      to?: string;
+      templateId?: string;
+      status?: "stored" | "queued" | "sent" | "failed";
+      cursor?: string;
+      limit?: number;
+    }) => Promise<{
+      emails: {
+        id: string;
+        templateId: string;
+        to: string[];
+        cc: string[];
+        bcc: string[];
+        replyTo: string | null;
+        from: string;
+        subject: string;
+        html: string;
+        text: string | null;
+        status: "stored" | "queued" | "sent" | "failed";
+        providerMessageId: string | null;
+        error: string | null;
+        attempts: number;
+        createdAt: string;
+        updatedAt: string;
+      }[];
+      nextCursor?: string;
+    }>;
+  }>;
+}, {
+  deliveryCredential: import("@prisma/composer").SecretNeed;
+}>;
+//#endregion
+//#region ../../1-prisma-cloud/2-shared-modules/email/dist/index.d.mts
+//#region src/contract.d.ts
+/** What a template's render produces. `text` is optional; `html` is required. */
+interface RenderedEmail {
+  readonly subject: string;
+  readonly html: string;
+  readonly text?: string;
+}
+/**
+ * One template's data schema and its render function. `render` may be
+ * synchronous or async — the sender method awaits its result either way, so
+ * react-email's/jsx-email's async `render()` works directly (spec's
+ * `TemplateDef` amendment, 2026-07-22).
+ */
+interface TemplateDef<D> {
+  readonly data: Type<D>;
+  readonly render: (data: D) => RenderedEmail | Promise<RenderedEmail>;
+}
+type TemplateDefs = Record<string, TemplateDef<any>>;
+/**
+ * Identity helper that infers `T` with literal keys and each entry's own
+ * data type — the `defineSchedule` pattern
+ * (`packages/1-prisma-cloud/2-shared-modules/cron/src/schedule.ts`).
+ * Performs no validation and no transformation.
+ */
+declare function defineTemplates<const T extends { [K in keyof T]: TemplateDef<any>; }>(defs: T): T;
+declare const emailSendContract: import("@prisma/composer").Contract<"rpc", {
+  send: (input: {
+    templateId: string;
+    to: string[];
+    subject: string;
+    html: string;
+    idempotencyKey: string;
+    cc?: string[];
+    bcc?: string[];
+    replyTo?: string;
+    text?: string;
+  }) => Promise<{
+    id: string;
+    status: "stored" | "queued" | "sent" | "failed";
+    error?: string;
+  }>;
+}>;
+declare const emailOutboxContract: import("@prisma/composer").Contract<"rpc", {
+  getEmail: (input: {
+    id: string;
+  }) => Promise<{
+    email: {
+      id: string;
+      templateId: string;
+      to: string[];
+      cc: string[];
+      bcc: string[];
+      replyTo: string | null;
+      from: string;
+      subject: string;
+      html: string;
+      text: string | null;
+      status: "stored" | "queued" | "sent" | "failed";
+      providerMessageId: string | null;
+      error: string | null;
+      attempts: number;
+      createdAt: string;
+      updatedAt: string;
+    } | null;
+  }>;
+  listEmails: (input: {
+    to?: string;
+    templateId?: string;
+    status?: "stored" | "queued" | "sent" | "failed";
+    cursor?: string;
+    limit?: number;
+  }) => Promise<{
+    emails: {
+      id: string;
+      templateId: string;
+      to: string[];
+      cc: string[];
+      bcc: string[];
+      replyTo: string | null;
+      from: string;
+      subject: string;
+      html: string;
+      text: string | null;
+      status: "stored" | "queued" | "sent" | "failed";
+      providerMessageId: string | null;
+      error: string | null;
+      attempts: number;
+      createdAt: string;
+      updatedAt: string;
+    }[];
+    nextCursor?: string;
+  }>;
+}>;
+/**
+ * The per-template send methods a `emailSender(templates)` dependency
+ * hydrates to. Optional fields accept explicit `undefined` — absent and
+ * `undefined` mean the same thing everywhere — so a caller under
+ * `exactOptionalPropertyTypes` can pass a maybe-undefined value straight
+ * through instead of conditionally spreading it (spec's `EmailSender`
+ * amendment, 2026-07-22).
+ */
+type EmailSender<T extends TemplateDefs> = { readonly [K in keyof T]: (input: {
+  readonly to: string | readonly string[];
+  readonly data: T[K] extends TemplateDef<infer D> ? D : never;
+  readonly cc?: readonly string[] | undefined;
+  readonly bcc?: readonly string[] | undefined;
+  readonly replyTo?: string | undefined;
+  /** Omitted (or `undefined`) mints a fresh UUID on every call — that call's own retry is NOT deduped against a previous one. Supply and reuse your own key across retries to get the outbox's dedup guarantee. */
+  readonly idempotencyKey?: string | undefined;
+}) => Promise<{
+  id: string;
+  status: 'stored' | 'queued' | 'sent' | 'failed';
+  error?: string;
+}>; };
+/**
+ * A consumer's dependency on the `send` port: one method per declared
+ * template, each validating its own `data`, rendering, and calling the
+ * generic `send` op. Connection params and hydration reuse `rpc()`'s exactly
+ * — same `url`/`serviceKey` binding, built the same way `rpc(emailSendContract)`
+ * would be, then wrapped.
+ */
+declare function emailSender<T extends TemplateDefs>(templates: T): DependencyEnd<EmailSender<T>, typeof emailSendContract>;
+//#endregion
+//#region src/email-module.d.ts
+declare function email(opts?: {
+  name?: string;
+  deliveryUrl?: string;
+}): ModuleNode<Record<never, never>, {
+  send: typeof emailSendContract;
+  outbox: typeof emailOutboxContract;
+}, {
+  deliveryCredential: SecretNeed;
+}, {
+  deliveryMode: ParamNeed;
+  from: ParamNeed;
+}>;
+//#endregion
+export { type EmailSender, type RenderedEmail, type TemplateDef, type TemplateDefs, defineTemplates, email, emailOutboxContract, emailSendContract, emailSender, emailService };
+//# sourceMappingURL=index.d.mts.map

package/dist/email/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../1-prisma-cloud/1-extensions/target/dist/index.d.mts","../../../../1-prisma-cloud/2-shared-modules/email/dist/email-service-Cm-YAvgn.d.mts","../../../../1-prisma-cloud/2-shared-modules/email/dist/index.d.mts"],"mappings":";;;;;;cA0Cc;WACH,+BAA+B,4CAA4C;;KAEjF,wBAAwB;;;;;;;;;;;;;;;;;;;;;;cAsBf,eAAe,UAAU,MAAM,UAAU,QAAQ,UAAU,QAAQ,UAAU,oBAAoB,oBAAoB,GAAG,IAAI,gBAAgB,GAAG;;YAEjJ;WACD;WACA;WACA;WACA;WACA,QAAQ;WACR,QAAQ,IAAI;WACZ,aAAa;WACb,OAAO;WACP,QAAQ;EACjB,YAAY,MAAM,YAAY,GAAG,IAAI,gBAAgB,GAAG;EACxD,IAAI,iBAAiB,YAAY,mBAAmB;EACpD,QAAQ,aAAa;EACrB,UAAU,OAAO,IAAI;EACrB,WAAW,aAAa;;;;EAIxB;;;;UA+DQ;WACC;;;;;iBCtJM,aAAa;EAC5B;IAsDQ;EApDR,6BAA6B,cAHd,yCAGsG,qBAAzC;;EAE5E,uCAAuC,0DAA0D;EACjG,sCAAsC,4CAA4C;EAClF,+BAA+B,4CAA4C;;EAE3E,+BAA+B;IAC7B,OAAO;MACL;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;UACI;MACJ;MACA;MACA;;;EAGJ,iCAAiC;IAC/B,WAAW;MACT;UACI;MACJ;QACE;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;;;IAGJ,aAAa;MACX;MACA;MACA;MACA;MACA;UACI;MACJ;QACE;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;;MAEF;;;;EAIJ,6CAA6C;;;;;;UC1ErC;WACC;WACA;WACA;;;;;;;;UAQD,YAAY;WACX,MAAM,KAAK;WACX,SAAS,MAAM,MAAM,gBAAgB,QAAQ;;KAEnD,eAAe,eAAe;;;;;;;iBAOlB,sBAAsB,aAAa,WAAW,IAAI,qBAAqB,MAAM,IAAI;cACpF,4CAA4C;EACxD,OAAO;IACL;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;QACI;IACJ;IACA;IACA;;;cAGU,8CAA8C;EAC1D,WAAW;IACT;QACI;IACJ;MACE;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;;;EAGJ,aAAa;IACX;IACA;IACA;IACA;IACA;QACI;IACJ;MACE;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;;IAEF;;;;;;;;;;;KAWC,YAAY,UAAU,4BAA4B,WAAW,KAAK;WAC5D;WACA,MAAM,EAAE,WAAW,kBAAkB,KAAK;WAC1C;WACA;WACA;;WAEA;MACL;EACJ;EACA;EACA;;;;;;;;;iBASe,YAAY,UAAU,cAAc,WAAW,IAAI,cAAc,YAAY,WAAW;;;iBAGxF,MAAM;EACrB;EACA;IACE,WAAW;EACb,aAAa;EACb,eAAe;;EAEf,oBAAoB;;EAEpB,cAAc;EACd,MAAM"}