@intelligo-dev/core 1.0.0-beta.1

package/dist/documents/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Documents Module (ADR-0009)
+ *
+ * Document lifecycle: save, list, read, delete versions, plus
+ * ownership and workspace/user access checks. See ./service.ts for
+ * the full module doc comment.
+ *
+ * Use via subpath import: @intelligo-dev/core/documents
+ */
+export { getUserDocuments, getDocument, saveDocument, deleteDocumentVersions, } from "./service";
+export { DocumentServiceError, isDocumentServiceError, type DocumentServiceErrorCode, } from "./errors";
+export type { DocumentActor, DocumentFilter, DocumentListItem } from "./types";
+export { registerDocumentPatterns, classifyDocumentTitle, isProductDocument, listRegisteredDocumentPatterns, clearDocumentPatternRegistry, type DocumentPatternEntry, } from "./classifier";
+//# sourceMappingURL=index.d.ts.map

package/dist/documents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/documents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,wBAAwB,GAC9B,MAAM,UAAU,CAAC;AAElB,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE/E,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB,EACjB,8BAA8B,EAC9B,4BAA4B,EAC5B,KAAK,oBAAoB,GAC1B,MAAM,cAAc,CAAC"}

package/dist/documents/index.js

@@ -0,0 +1,13 @@
+/**
+ * Documents Module (ADR-0009)
+ *
+ * Document lifecycle: save, list, read, delete versions, plus
+ * ownership and workspace/user access checks. See ./service.ts for
+ * the full module doc comment.
+ *
+ * Use via subpath import: @intelligo-dev/core/documents
+ */
+export { getUserDocuments, getDocument, saveDocument, deleteDocumentVersions, } from "./service";
+export { DocumentServiceError, isDocumentServiceError, } from "./errors";
+export { registerDocumentPatterns, classifyDocumentTitle, isProductDocument, listRegisteredDocumentPatterns, clearDocumentPatternRegistry, } from "./classifier";
+//# sourceMappingURL=index.js.map

package/dist/documents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/documents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GAEvB,MAAM,UAAU,CAAC;AAIlB,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB,EACjB,8BAA8B,EAC9B,4BAA4B,GAE7B,MAAM,cAAc,CAAC"}

package/dist/documents/service.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Document Persistence Service — Server-only
+ *
+ * Core CRUD operations for AI-generated document artifacts with
+ * workspace + user isolation. Ported from
+ * @intelligo-dev/agents/documents (ADR-0009): the tables (`documents`,
+ * `document_types`) always lived in @intelligo-dev/core's schema, only the
+ * service layer sat in a dissolving package.
+ *
+ * Callers pass a resolved actor (workspaceId, userId) rather than this
+ * module resolving one itself — @intelligo-dev/core cannot depend on
+ * @intelligo-dev/auth (see tests/architecture/dependency-direction.test.ts),
+ * so `requireWorkspace()` moved to the caller. Every query still
+ * filters by workspaceId AND userId internally; the actor is never
+ * trusted to have done that itself.
+ *
+ * Failure is reported by throwing `DocumentServiceError` (a small,
+ * typed code set) rather than returning a `{ success, error }`
+ * envelope — that shaping, plus any error-reporting side effect
+ * (Sentry, logging), is a transport concern the caller applies at the
+ * Server Action / route boundary.
+ *
+ * This module is SERVER-ONLY. Do not import from client components.
+ */
+import type { DocumentActor, DocumentFilter, DocumentListItem } from "./types";
+/**
+ * Get all documents for the actor. Ordered by most recently created
+ * first. Uses DISTINCT ON to get the latest version of each document.
+ */
+export declare function getUserDocuments(actor: DocumentActor, filter?: DocumentFilter): Promise<DocumentListItem[]>;
+/**
+ * Get a single document by id, scoped to the actor.
+ * Throws DocumentServiceError("not_found") if no such document exists.
+ */
+export declare function getDocument(actor: DocumentActor, id: string): Promise<DocumentListItem>;
+/**
+ * Save (create new version of) a document.
+ * Throws DocumentServiceError("forbidden") if a document with this id
+ * already exists in the workspace under a different user.
+ */
+export declare function saveDocument(actor: DocumentActor, params: {
+    id: string;
+    title: string;
+    content: string;
+    kind: string;
+}): Promise<DocumentListItem>;
+/**
+ * Delete all versions of a document created after `timestamp`.
+ * Throws DocumentServiceError("invalid_input") for an unparsable
+ * timestamp or one older than the delete window, and ("not_found") if
+ * no document exists at that id within the actor's scope.
+ */
+export declare function deleteDocumentVersions(actor: DocumentActor, id: string, timestamp: string): Promise<DocumentListItem[]>;
+//# sourceMappingURL=service.d.ts.map

package/dist/documents/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/documents/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAyB/E;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,aAAa,EACpB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAuB7B;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,aAAa,EACpB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,gBAAgB,CAAC,CAkB3B;AAMD;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE;IACN,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,GACA,OAAO,CAAC,gBAAgB,CAAC,CAuC3B;AAQD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,aAAa,EACpB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA4C7B"}

package/dist/documents/service.js

@@ -0,0 +1,146 @@
+/**
+ * Document Persistence Service — Server-only
+ *
+ * Core CRUD operations for AI-generated document artifacts with
+ * workspace + user isolation. Ported from
+ * @intelligo-dev/agents/documents (ADR-0009): the tables (`documents`,
+ * `document_types`) always lived in @intelligo-dev/core's schema, only the
+ * service layer sat in a dissolving package.
+ *
+ * Callers pass a resolved actor (workspaceId, userId) rather than this
+ * module resolving one itself — @intelligo-dev/core cannot depend on
+ * @intelligo-dev/auth (see tests/architecture/dependency-direction.test.ts),
+ * so `requireWorkspace()` moved to the caller. Every query still
+ * filters by workspaceId AND userId internally; the actor is never
+ * trusted to have done that itself.
+ *
+ * Failure is reported by throwing `DocumentServiceError` (a small,
+ * typed code set) rather than returning a `{ success, error }`
+ * envelope — that shaping, plus any error-reporting side effect
+ * (Sentry, logging), is a transport concern the caller applies at the
+ * Server Action / route boundary.
+ *
+ * This module is SERVER-ONLY. Do not import from client components.
+ */
+import { and, desc, eq, gt } from "drizzle-orm";
+import { db } from "../db";
+import { documents } from "../db/schema";
+import { classifyDocumentTitle, isProductDocument } from "./classifier";
+import { DocumentServiceError } from "./errors";
+function toListItem(doc) {
+    return {
+        id: doc.id,
+        title: doc.title,
+        kind: doc.kind,
+        createdAt: doc.createdAt.toISOString(),
+        agentLabel: classifyDocumentTitle(doc.title).agentLabel,
+        content: doc.content,
+    };
+}
+// ---------------------------------------------------------------------------
+// Query Operations
+// ---------------------------------------------------------------------------
+/**
+ * Get all documents for the actor. Ordered by most recently created
+ * first. Uses DISTINCT ON to get the latest version of each document.
+ */
+export async function getUserDocuments(actor, filter) {
+    const uniqueDocs = await db
+        .selectDistinctOn([documents.id])
+        .from(documents)
+        .where(and(eq(documents.workspaceId, actor.workspaceId), eq(documents.userId, actor.userId)))
+        .orderBy(documents.id, desc(documents.createdAt));
+    let result = uniqueDocs.map(toListItem);
+    const filterType = filter?.type ?? "all";
+    if (filterType !== "all") {
+        result =
+            filterType === "report"
+                ? result.filter((doc) => isProductDocument(doc.title))
+                : result.filter((doc) => doc.kind === filterType);
+    }
+    return result;
+}
+/**
+ * Get a single document by id, scoped to the actor.
+ * Throws DocumentServiceError("not_found") if no such document exists.
+ */
+export async function getDocument(actor, id) {
+    const [doc] = await db
+        .selectDistinctOn([documents.id])
+        .from(documents)
+        .where(and(eq(documents.id, id), eq(documents.workspaceId, actor.workspaceId), eq(documents.userId, actor.userId)))
+        .orderBy(documents.id, desc(documents.createdAt));
+    if (!doc) {
+        throw new DocumentServiceError("not_found", "Document not found");
+    }
+    return toListItem(doc);
+}
+// ---------------------------------------------------------------------------
+// Mutation Operations
+// ---------------------------------------------------------------------------
+/**
+ * Save (create new version of) a document.
+ * Throws DocumentServiceError("forbidden") if a document with this id
+ * already exists in the workspace under a different user.
+ */
+export async function saveDocument(actor, params) {
+    const existingDocs = await db
+        .select()
+        .from(documents)
+        .where(and(eq(documents.id, params.id), eq(documents.workspaceId, actor.workspaceId)));
+    if (existingDocs.length > 0) {
+        const firstDoc = existingDocs[0];
+        if (firstDoc && firstDoc.userId !== actor.userId) {
+            throw new DocumentServiceError("forbidden", "Document belongs to a different user");
+        }
+    }
+    const [newDocument] = await db
+        .insert(documents)
+        .values({
+        id: params.id,
+        userId: actor.userId,
+        workspaceId: actor.workspaceId,
+        title: params.title,
+        content: params.content,
+        kind: params.kind,
+        createdAt: new Date(),
+    })
+        .returning();
+    if (!newDocument) {
+        throw new DocumentServiceError("database_error", "Failed to save document");
+    }
+    return toListItem(newDocument);
+}
+// ---------------------------------------------------------------------------
+// Delete Operations
+// ---------------------------------------------------------------------------
+const MAX_DELETE_WINDOW_DAYS = 30;
+/**
+ * Delete all versions of a document created after `timestamp`.
+ * Throws DocumentServiceError("invalid_input") for an unparsable
+ * timestamp or one older than the delete window, and ("not_found") if
+ * no document exists at that id within the actor's scope.
+ */
+export async function deleteDocumentVersions(actor, id, timestamp) {
+    const parsedTimestamp = new Date(timestamp);
+    if (Number.isNaN(parsedTimestamp.getTime())) {
+        throw new DocumentServiceError("invalid_input", "Invalid timestamp");
+    }
+    const oldestAllowed = new Date(Date.now() - MAX_DELETE_WINDOW_DAYS * 24 * 60 * 60 * 1000);
+    if (parsedTimestamp < oldestAllowed) {
+        throw new DocumentServiceError("invalid_input", `timestamp must be within the last ${MAX_DELETE_WINDOW_DAYS} days`);
+    }
+    const existingDocs = await db
+        .select()
+        .from(documents)
+        .where(and(eq(documents.id, id), eq(documents.workspaceId, actor.workspaceId), eq(documents.userId, actor.userId)));
+    if (existingDocs.length === 0) {
+        throw new DocumentServiceError("not_found", "Document not found");
+    }
+    const deletedDocs = await db
+        .delete(documents)
+        .where(and(eq(documents.id, id), eq(documents.workspaceId, actor.workspaceId), eq(documents.userId, actor.userId), gt(documents.createdAt, parsedTimestamp)))
+        .returning();
+    return deletedDocs.map(toListItem);
+}
+//# sourceMappingURL=service.js.map

package/dist/documents/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/documents/service.ts"],"names":[],"mappings":"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"}

package/dist/documents/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Shared types for the documents service.
+ */
+/** Resolved actor identity — every query is scoped to this pair. */
+export type DocumentActor = {
+    workspaceId: string;
+    userId: string;
+};
+/**
+ * Document filter type
+ */
+export type DocumentFilter = {
+    type?: "all" | "report" | "text" | "code" | "sheet" | "image";
+};
+/**
+ * Document list item returned by getUserDocuments / getDocument /
+ * saveDocument / deleteDocumentVersions.
+ */
+export type DocumentListItem = {
+    id: string;
+    title: string;
+    kind: string;
+    createdAt: string;
+    agentLabel: string;
+    content: string | null;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/documents/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/documents/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oEAAoE;AACpE,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;CAC/D,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC"}

package/dist/documents/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared types for the documents service.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/documents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/documents/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/email/index.d.ts

@@ -0,0 +1,5 @@
+export { sendEmail, type SendEmailParams, type SendEmailWithComponentParams, type SendEmailResult, } from "./send";
+export { getEmailProvider, resetEmailProviderCache, type EmailProvider, type EmailProviderName, type EmailSendParams, type EmailTemplateRef, ResendProvider, LoopsProvider, ConsoleProvider, } from "./provider";
+export * from "./templates";
+export * from "./senders";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/email/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,eAAe,EACpB,KAAK,4BAA4B,EACjC,KAAK,eAAe,GACrB,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/email/index.js

@@ -0,0 +1,5 @@
+export { sendEmail, } from "./send";
+export { getEmailProvider, resetEmailProviderCache, ResendProvider, LoopsProvider, ConsoleProvider, } from "./provider";
+export * from "./templates";
+export * from "./senders";
+//# sourceMappingURL=index.js.map

package/dist/email/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/email/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,GAIV,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EAKvB,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/email/provider.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Provider-neutral template descriptor attached to every framework email.
+ *
+ * HTML-capable providers (Resend) ignore it — they send the rendered HTML.
+ * Template-based providers (Loops) require it: `key` is resolved to the
+ * provider-side template id and `variables` become the template's dynamic
+ * data. Keys are stable framework identifiers, e.g. "verify-email".
+ */
+export interface EmailTemplateRef {
+    key: string;
+    variables?: Record<string, string | number>;
+}
+export interface EmailSendParams {
+    to: string | string[];
+    subject: string;
+    html: string;
+    from?: string;
+    replyTo?: string;
+    template?: EmailTemplateRef;
+}
+/**
+ * Common interface every email provider must implement.
+ */
+export interface EmailProvider {
+    send(params: EmailSendParams): Promise<{
+        id: string;
+    }>;
+}
+export declare class ResendProvider implements EmailProvider {
+    private client;
+    constructor(apiKey: string);
+    send(params: EmailSendParams): Promise<{
+        id: string;
+    }>;
+}
+export declare class LoopsProvider implements EmailProvider {
+    private apiKey;
+    private transactionalIds?;
+    constructor(apiKey: string, transactionalIds?: Record<string, string> | undefined);
+    private resolveTransactionalId;
+    send(params: EmailSendParams): Promise<{
+        id: string;
+    }>;
+}
+export declare class ConsoleProvider implements EmailProvider {
+    send(params: EmailSendParams): Promise<{
+        id: string;
+    }>;
+}
+export type EmailProviderName = "resend" | "loops" | "console";
+/** Test-only: clear the cached provider so env changes take effect. */
+export declare function resetEmailProviderCache(): void;
+/**
+ * Returns the email provider based on environment variables.
+ *
+ * Priority:
+ *   1. EMAIL_PROVIDER env var → explicit selection (with API key validation)
+ *   2. RESEND_API_KEY → ResendProvider (auto-detect; preferred because it can
+ *      send every framework email without per-template setup)
+ *   3. LOOPS_API_KEY  → LoopsProvider (auto-detect; needs
+ *      LOOPS_TRANSACTIONAL_ID_* mappings for the templates you use)
+ *   4. (none)         → ConsoleProvider
+ *
+ * The provider instance is cached (singleton) so a new client is NOT created
+ * on every call.
+ */
+export declare function getEmailProvider(): EmailProvider;
+//# sourceMappingURL=provider.d.ts.map

package/dist/email/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/email/provider.ts"],"names":[],"mappings":"AAcA;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD;AAaD,qBAAa,cAAe,YAAW,aAAa;IAClD,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAIpB,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAwB7D;AAiBD,qBAAa,aAAc,YAAW,aAAa;IAE/C,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,gBAAgB,CAAC;gBADjB,MAAM,EAAE,MAAM,EACd,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,YAAA;IAGnD,OAAO,CAAC,sBAAsB;IAWxB,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CA6D7D;AAMD,qBAAa,eAAgB,YAAW,aAAa;IAC7C,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAW7D;AAMD,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAI/D,uEAAuE;AACvE,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAoChD"}

package/dist/email/provider.js

@@ -0,0 +1,199 @@
+import { Resend } from "resend";
+/** Error with an HTTP-ish status code so send.ts can decide retryability. */
+function statusError(message, statusCode) {
+    const err = new Error(message);
+    err.statusCode = statusCode;
+    return err;
+}
+// ---------------------------------------------------------------------------
+// ResendProvider
+// ---------------------------------------------------------------------------
+export class ResendProvider {
+    constructor(apiKey) {
+        this.client = new Resend(apiKey);
+    }
+    async send(params) {
+        const { data, error } = await this.client.emails.send({
+            from: params.from ?? "Intelligo <noreply@intelligo.dev>",
+            to: Array.isArray(params.to) ? params.to : [params.to],
+            subject: params.subject,
+            html: params.html,
+            replyTo: params.replyTo,
+        });
+        if (error) {
+            // Resend returns an error object rather than throwing
+            const err = new Error(error.message);
+            // Resend error names map to HTTP status categories
+            if (error.name === "validation_error" ||
+                error.name === "missing_required_field") {
+                err.statusCode = 400;
+            }
+            throw err;
+        }
+        return { id: data?.id ?? "unknown" };
+    }
+}
+// ---------------------------------------------------------------------------
+// LoopsProvider
+// ---------------------------------------------------------------------------
+// Loops transactional emails are designed in the Loops dashboard and sent by
+// template id — the API accepts no raw HTML and exactly one recipient per
+// call. Template keys resolve to ids through (in order):
+//   1. the `transactionalIds` map passed to the constructor
+//   2. env: LOOPS_TRANSACTIONAL_ID_<KEY> (key upper-snaked,
+//      e.g. "verify-email" → LOOPS_TRANSACTIONAL_ID_VERIFY_EMAIL)
+// `from`/`replyTo` are ignored — the sender is configured per template in
+// Loops itself.
+// ---------------------------------------------------------------------------
+const LOOPS_API_URL = "https://app.loops.so/api/v1/transactional";
+export class LoopsProvider {
+    constructor(apiKey, transactionalIds) {
+        this.apiKey = apiKey;
+        this.transactionalIds = transactionalIds;
+    }
+    resolveTransactionalId(key) {
+        const mapped = this.transactionalIds?.[key];
+        if (mapped) {
+            return mapped;
+        }
+        const envName = `LOOPS_TRANSACTIONAL_ID_${key
+            .toUpperCase()
+            .replace(/-/g, "_")}`;
+        return process.env[envName];
+    }
+    async send(params) {
+        const template = params.template;
+        if (!template) {
+            throw statusError(`Loops requires a template key (subject: "${params.subject}") — Loops cannot send raw HTML. Use a framework sender or pass { template }.`, 400);
+        }
+        const transactionalId = this.resolveTransactionalId(template.key);
+        if (!transactionalId) {
+            throw statusError(`No Loops transactional id mapped for template "${template.key}". Set LOOPS_TRANSACTIONAL_ID_${template.key
+                .toUpperCase()
+                .replace(/-/g, "_")} or pass a transactionalIds map to LoopsProvider.`, 400);
+        }
+        const recipients = Array.isArray(params.to) ? params.to : [params.to];
+        // Loops accepts a single recipient per request — fan out sequentially so
+        // a failure surfaces with normal retry semantics in send.ts.
+        for (const email of recipients) {
+            const response = await fetch(LOOPS_API_URL, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${this.apiKey}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({
+                    transactionalId,
+                    email,
+                    dataVariables: template.variables ?? {},
+                }),
+            });
+            if (!response.ok) {
+                let detail = "";
+                try {
+                    const body = (await response.json());
+                    detail = body.message ?? body.error?.message ?? "";
+                }
+                catch {
+                    // Non-JSON error body — status code alone is enough
+                }
+                throw statusError(`Loops send failed (${response.status}) for template "${template.key}"${detail ? `: ${detail}` : ""}`, response.status);
+            }
+        }
+        // Loops returns { success: true } with no message id
+        return { id: `loops:${transactionalId}` };
+    }
+}
+// ---------------------------------------------------------------------------
+// ConsoleProvider (development fallback)
+// ---------------------------------------------------------------------------
+export class ConsoleProvider {
+    async send(params) {
+        const recipient = Array.isArray(params.to)
+            ? params.to.join(", ")
+            : params.to;
+        console.log(`[Email] Would send to: ${recipient}, subject: ${params.subject}`);
+        return { id: `console-${Date.now()}` };
+    }
+}
+let cachedProvider = null;
+/** Test-only: clear the cached provider so env changes take effect. */
+export function resetEmailProviderCache() {
+    cachedProvider = null;
+}
+/**
+ * Returns the email provider based on environment variables.
+ *
+ * Priority:
+ *   1. EMAIL_PROVIDER env var → explicit selection (with API key validation)
+ *   2. RESEND_API_KEY → ResendProvider (auto-detect; preferred because it can
+ *      send every framework email without per-template setup)
+ *   3. LOOPS_API_KEY  → LoopsProvider (auto-detect; needs
+ *      LOOPS_TRANSACTIONAL_ID_* mappings for the templates you use)
+ *   4. (none)         → ConsoleProvider
+ *
+ * The provider instance is cached (singleton) so a new client is NOT created
+ * on every call.
+ */
+export function getEmailProvider() {
+    if (cachedProvider) {
+        return cachedProvider;
+    }
+    const explicit = process.env.EMAIL_PROVIDER?.toLowerCase();
+    if (explicit) {
+        cachedProvider = resolveExplicitProvider(explicit);
+        if (cachedProvider) {
+            return cachedProvider;
+        }
+        // Unknown value — warn and fall through to auto-detect
+        console.warn(`[Email] Unknown EMAIL_PROVIDER="${process.env.EMAIL_PROVIDER}", falling back to auto-detect`);
+    }
+    // Auto-detect from available API keys (backwards compatible)
+    const resendKey = process.env.RESEND_API_KEY;
+    if (resendKey) {
+        console.log("[Email] Using Resend provider");
+        cachedProvider = new ResendProvider(resendKey);
+        return cachedProvider;
+    }
+    const loopsKey = process.env.LOOPS_API_KEY;
+    if (loopsKey) {
+        console.log("[Email] Using Loops provider");
+        cachedProvider = new LoopsProvider(loopsKey);
+        return cachedProvider;
+    }
+    console.log("[Email] Using console provider (no API key set)");
+    cachedProvider = new ConsoleProvider();
+    return cachedProvider;
+}
+/**
+ * Resolve an explicit EMAIL_PROVIDER value to a provider instance.
+ * Returns null for unknown values so the caller can fall through to auto-detect.
+ */
+function resolveExplicitProvider(provider) {
+    switch (provider) {
+        case "resend": {
+            const key = process.env.RESEND_API_KEY;
+            if (!key) {
+                console.warn("[Email] EMAIL_PROVIDER=resend but RESEND_API_KEY is not set, falling back to console");
+                return new ConsoleProvider();
+            }
+            console.log("[Email] Using Resend provider (explicit)");
+            return new ResendProvider(key);
+        }
+        case "loops": {
+            const key = process.env.LOOPS_API_KEY;
+            if (!key) {
+                console.warn("[Email] EMAIL_PROVIDER=loops but LOOPS_API_KEY is not set, falling back to console");
+                return new ConsoleProvider();
+            }
+            console.log("[Email] Using Loops provider (explicit)");
+            return new LoopsProvider(key);
+        }
+        case "console":
+            console.log("[Email] Using console provider (explicit)");
+            return new ConsoleProvider();
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/email/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/email/provider.ts"],"names":[],"mappings":"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"}

package/dist/email/send.d.ts

@@ -0,0 +1,47 @@
+import type React from "react";
+import { type EmailTemplateRef } from "./provider";
+export interface SendEmailParams {
+    to: string | string[];
+    subject: string;
+    html: string;
+    /** Defaults to EMAIL_FROM env var or "Intelligo <noreply@intelligo.dev>" */
+    from?: string;
+    replyTo?: string;
+    /**
+     * Provider-neutral template descriptor. Required by template-based
+     * providers (Loops); ignored by HTML-capable providers (Resend).
+     */
+    template?: EmailTemplateRef;
+}
+export interface SendEmailWithComponentParams {
+    to: string | string[];
+    subject: string;
+    /** A React Email component element. Will be rendered to HTML before sending. */
+    react: React.ReactElement;
+    /** Defaults to EMAIL_FROM env var or "Intelligo <noreply@intelligo.dev>" */
+    from?: string;
+    replyTo?: string;
+    /**
+     * Provider-neutral template descriptor. Required by template-based
+     * providers (Loops); ignored by HTML-capable providers (Resend).
+     */
+    template?: EmailTemplateRef;
+}
+export interface SendEmailResult {
+    success: boolean;
+    id?: string;
+    error?: string;
+}
+/**
+ * Send an email through the configured provider with retry logic.
+ *
+ * Accepts either raw HTML via `{ html }` or a React Email component via
+ * `{ react }`. When a React element is provided, it is rendered to HTML
+ * using `@react-email/components`'s `render()` before sending.
+ *
+ * This function NEVER throws. All errors are caught and returned as
+ * `{ success: false, error: "..." }`. This prevents email failures
+ * from crashing the application (TECH-08).
+ */
+export declare function sendEmail(params: SendEmailParams | SendEmailWithComponentParams): Promise<SendEmailResult>;
+//# sourceMappingURL=send.d.ts.map

package/dist/email/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../src/email/send.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAcrE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC;IAC1B,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA2CD;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,eAAe,GAAG,4BAA4B,GACrD,OAAO,CAAC,eAAe,CAAC,CAgF1B"}