@q32/core 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Q32 LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,60 @@
+# @q32/core
+
+Shared TypeScript primitives for Q32 Cloudflare Worker projects.
+
+The first release focuses on common infrastructure repeated across Q32 apps:
+
+- AI provider contracts and JSON extraction helpers
+- API operation registries
+- billing plan/status primitives
+- Cloudflare binding guards
+- environment parsing
+- email provider contracts and address helpers
+- IDs, tokens, and signed session cookies
+- HTTP JSON/error helpers
+- D1-like database types and migration runner
+- D1-backed jobs
+- `ops_events`
+- Postgres migration helpers
+- R2 JSON artifacts
+- SEO sitemap, robots, and metadata helpers
+- test helpers for Worker queues, R2, and JSON responses
+- OAuth/MCP discovery metadata
+- D1 rate limiting
+- WebCrypto JSON encryption
+
+## Install
+
+```bash
+pnpm add @q32/core
+```
+
+## Development
+
+```bash
+pnpm install
+pnpm test
+pnpm build
+```
+
+## Release
+
+Publishing is handled by the `Release` GitHub Actions workflow when a GitHub release is published. Configure an npm automation token as the repository secret `NPM_TOKEN` before the first release.
+
+## Modules
+
+```ts
+import {
+  D1JobStore,
+  D1_JOBS_SCHEMA,
+  appUrl,
+  createId,
+  jsonResponse,
+  oauthAuthorizationServerMetadata,
+  renderSitemapXml,
+  recordOpsEvent,
+  signSession,
+} from "@q32/core";
+```
+
+See [docs/evaluation.md](docs/evaluation.md) for the project-inventory replacement matrix.

package/dist/ai.d.ts

@@ -0,0 +1,26 @@
+export type AiMessage = {
+    role: "system" | "user" | "assistant" | "tool";
+    content: string;
+};
+export type AiJsonRequest = {
+    model: string;
+    messages: AiMessage[];
+    responseName?: string;
+    temperature?: number;
+};
+export type AiJsonProvider = {
+    generateJson<T>(request: AiJsonRequest): Promise<T>;
+};
+export type AiUsage = {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+};
+export type AiResult<T> = {
+    value: T;
+    usage?: AiUsage;
+    providerMetadata?: Record<string, unknown>;
+};
+export declare function systemUserMessages(system: string, user: string): AiMessage[];
+export declare function extractJsonObject(text: string): unknown;
+//# sourceMappingURL=ai.d.ts.map

package/dist/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;IACxB,KAAK,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAK5E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMvD"}

package/dist/ai.js

@@ -0,0 +1,16 @@
+export function systemUserMessages(system, user) {
+    return [
+        { role: "system", content: system },
+        { role: "user", content: user },
+    ];
+}
+export function extractJsonObject(text) {
+    const trimmed = text.trim();
+    if (trimmed.startsWith("{") && trimmed.endsWith("}"))
+        return JSON.parse(trimmed);
+    const fenced = trimmed.match(/```(?:json)?\s*([\s\S]*?)```/i);
+    if (fenced)
+        return JSON.parse(fenced[1].trim());
+    throw new Error("No JSON object found in model output.");
+}
+//# sourceMappingURL=ai.js.map

package/dist/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"AA4BA,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,IAAY;IAC7D,OAAO;QACL,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE;QACnC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjF,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC9D,IAAI,MAAM;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/api.d.ts

@@ -0,0 +1,25 @@
+export type ApiMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+export interface SchemaLike<T = unknown> {
+    parse(value: unknown): T;
+}
+export type ApiOperationSpec<TInput = unknown> = {
+    name: string;
+    title: string;
+    description: string;
+    method: ApiMethod;
+    path: string;
+    scope?: string;
+    inputSchema?: SchemaLike<TInput>;
+    openapi?: boolean;
+};
+export type ApiOperation<TContext, TInput = unknown, TOutput = unknown> = ApiOperationSpec<TInput> & {
+    handler: (context: TContext, input: TInput) => Promise<TOutput> | TOutput;
+};
+export type ApiOperationRegistry<TContext> = Record<string, ApiOperation<TContext, unknown, unknown>>;
+export declare function defineApiOperation<TContext, TInput = unknown, TOutput = unknown>(operation: ApiOperation<TContext, TInput, TOutput>): ApiOperation<TContext, TInput, TOutput>;
+export declare function defineApiRegistry<TContext, TRegistry extends ApiOperationRegistry<TContext>>(registry: TRegistry): TRegistry;
+export declare function dispatchApiOperation<TContext>(registry: ApiOperationRegistry<TContext>, name: string, context: TContext, input: unknown): Promise<unknown>;
+export declare function operationPathParameters(path: string): string[];
+export declare function interpolateOperationPath(path: string, input: Record<string, unknown>): string;
+export declare function openApiPathsForRegistry<TContext>(registry: ApiOperationRegistry<TContext>): Record<string, Record<string, Record<string, unknown>>>;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEpE,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC;CAC1B;AAED,MAAM,MAAM,gBAAgB,CAAC,MAAM,GAAG,OAAO,IAAI;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,GAAG;IACnG,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC3E,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAAC,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAEtG,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAC9E,SAAS,EAAE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,GACjD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAEzC;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,SAAS,oBAAoB,CAAC,QAAQ,CAAC,EAC1F,QAAQ,EAAE,SAAS,GAClB,SAAS,CAQX;AAED,wBAAsB,oBAAoB,CAAC,QAAQ,EACjD,QAAQ,EAAE,oBAAoB,CAAC,QAAQ,CAAC,EACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,QAAQ,EACjB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAI9D;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAQ7F;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAC9C,QAAQ,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GACvC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CA0BzD"}

package/dist/api.js

@@ -0,0 +1,66 @@
+import { HttpError } from "./http.js";
+export function defineApiOperation(operation) {
+    return operation;
+}
+export function defineApiRegistry(registry) {
+    const names = new Set();
+    for (const [key, operation] of Object.entries(registry)) {
+        if (operation.name !== key)
+            throw new Error(`API operation key/name mismatch: ${key} != ${operation.name}`);
+        if (names.has(operation.name))
+            throw new Error(`Duplicate API operation name: ${operation.name}`);
+        names.add(operation.name);
+    }
+    return registry;
+}
+export async function dispatchApiOperation(registry, name, context, input) {
+    const operation = registry[name];
+    if (!operation)
+        throw new HttpError(404, `Unknown API operation: ${name}`, "unknown_operation");
+    const parsed = operation.inputSchema ? operation.inputSchema.parse(input) : input;
+    return operation.handler(context, parsed);
+}
+export function operationPathParameters(path) {
+    const params = new Set();
+    for (const match of path.matchAll(/\{([A-Za-z_][A-Za-z0-9_]*)\}/g))
+        params.add(match[1]);
+    return [...params];
+}
+export function interpolateOperationPath(path, input) {
+    return path.replace(/\{([A-Za-z_][A-Za-z0-9_]*)\}/g, (_, key) => {
+        const value = input[key];
+        if (value === undefined || value === null || value === "") {
+            throw new HttpError(400, `Missing path parameter: ${key}`, "missing_path_parameter");
+        }
+        return encodeURIComponent(String(value));
+    });
+}
+export function openApiPathsForRegistry(registry) {
+    const paths = {};
+    for (const operation of Object.values(registry)) {
+        if (operation.openapi === false)
+            continue;
+        const path = operation.path.replace(/\{([A-Za-z_][A-Za-z0-9_]*)\}/g, "{$1}");
+        const method = operation.method.toLowerCase();
+        paths[path] ??= {};
+        paths[path][method] = {
+            operationId: operation.name,
+            summary: operation.title,
+            description: operation.description,
+            security: operation.scope ? [{ bearerAuth: [operation.scope] }] : undefined,
+            parameters: operationPathParameters(operation.path).map((name) => ({
+                name,
+                in: "path",
+                required: true,
+                schema: { type: "string" },
+            })),
+            responses: {
+                "200": {
+                    description: "OK",
+                },
+            },
+        };
+    }
+    return paths;
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/billing.d.ts

@@ -0,0 +1,21 @@
+export type BillingPlan = {
+    id: string;
+    name: string;
+    rank: number;
+    stripePriceId?: string;
+    limits?: Record<string, number>;
+};
+export type SubscriptionStatus = "trialing" | "active" | "past_due" | "canceled" | "unpaid" | "incomplete" | "incomplete_expired" | "paused";
+export type BillingCustomer = {
+    customerId: string;
+    email?: string;
+    planId?: string;
+    stripeCustomerId?: string;
+    stripeSubscriptionId?: string;
+    subscriptionStatus?: SubscriptionStatus;
+};
+export declare function planAtLeast(plans: BillingPlan[], actualPlanId: string | null | undefined, requiredPlanId: string): boolean;
+export declare function activeSubscriptionStatuses(): SubscriptionStatus[];
+export declare function isActiveSubscriptionStatus(status: SubscriptionStatus | null | undefined): boolean;
+export declare function stripeEventAlreadyProcessedMessage(eventId: string): string;
+//# sourceMappingURL=billing.d.ts.map

package/dist/billing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../src/billing.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAC1B,UAAU,GACV,QAAQ,GACR,UAAU,GACV,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,oBAAoB,GACpB,QAAQ,CAAC;AAEb,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAM1H;AAED,wBAAgB,0BAA0B,IAAI,kBAAkB,EAAE,CAEjE;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAEjG;AAED,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1E"}

package/dist/billing.js

@@ -0,0 +1,18 @@
+export function planAtLeast(plans, actualPlanId, requiredPlanId) {
+    const byId = new Map(plans.map((plan) => [plan.id, plan]));
+    const actual = actualPlanId ? byId.get(actualPlanId) : undefined;
+    const required = byId.get(requiredPlanId);
+    if (!actual || !required)
+        return false;
+    return actual.rank >= required.rank;
+}
+export function activeSubscriptionStatuses() {
+    return ["trialing", "active"];
+}
+export function isActiveSubscriptionStatus(status) {
+    return status === "trialing" || status === "active";
+}
+export function stripeEventAlreadyProcessedMessage(eventId) {
+    return `Stripe event already processed: ${eventId}`;
+}
+//# sourceMappingURL=billing.js.map

package/dist/billing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.js","sourceRoot":"","sources":["../src/billing.ts"],"names":[],"mappings":"AA2BA,MAAM,UAAU,WAAW,CAAC,KAAoB,EAAE,YAAuC,EAAE,cAAsB;IAC/G,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,MAAM,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAA6C;IACtF,OAAO,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,QAAQ,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,OAAe;IAChE,OAAO,mCAAmC,OAAO,EAAE,CAAC;AACtD,CAAC"}

package/dist/cloudflare.d.ts

@@ -0,0 +1,12 @@
+export type WorkerQueueMessage<T = unknown> = {
+    jobId: string;
+    payload?: T;
+};
+export type DurableObjectIdLike = {
+    toString(): string;
+};
+export declare function requireD1(env: Record<string, unknown>, binding?: string): D1Database;
+export declare function requireR2(env: Record<string, unknown>, binding: string): R2Bucket;
+export declare function requireQueue<T = unknown>(env: Record<string, unknown>, binding: string): Queue<T>;
+export declare function isCloudflareScheduledEvent(value: unknown): value is ScheduledEvent;
+//# sourceMappingURL=cloudflare.d.ts.map

package/dist/cloudflare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../src/cloudflare.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,OAAO,IAAI;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,CAAC,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,IAAI,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,SAAO,GAAG,UAAU,CAMlF;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAMjF;AAED,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAMjG;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAElF"}

package/dist/cloudflare.js

@@ -0,0 +1,25 @@
+export function requireD1(env, binding = "DB") {
+    const db = env[binding];
+    if (!db || typeof db !== "object" || typeof db.prepare !== "function") {
+        throw new Error(`Missing D1 binding: ${binding}`);
+    }
+    return db;
+}
+export function requireR2(env, binding) {
+    const bucket = env[binding];
+    if (!bucket || typeof bucket !== "object" || typeof bucket.put !== "function") {
+        throw new Error(`Missing R2 binding: ${binding}`);
+    }
+    return bucket;
+}
+export function requireQueue(env, binding) {
+    const queue = env[binding];
+    if (!queue || typeof queue !== "object" || typeof queue.send !== "function") {
+        throw new Error(`Missing Queue binding: ${binding}`);
+    }
+    return queue;
+}
+export function isCloudflareScheduledEvent(value) {
+    return Boolean(value && typeof value === "object" && "scheduledTime" in value && "cron" in value);
+}
+//# sourceMappingURL=cloudflare.js.map

package/dist/cloudflare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare.js","sourceRoot":"","sources":["../src/cloudflare.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,SAAS,CAAC,GAA4B,EAAE,OAAO,GAAG,IAAI;IACpE,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;IACxB,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,OAAQ,EAAiB,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACtF,MAAM,IAAI,KAAK,CAAC,uBAAuB,OAAO,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,EAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAA4B,EAAE,OAAe;IACrE,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAQ,MAAmB,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;QAC5F,MAAM,IAAI,KAAK,CAAC,uBAAuB,OAAO,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAkB,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,YAAY,CAAc,GAA4B,EAAE,OAAe;IACrF,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAQ,KAAkB,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC1F,MAAM,IAAI,KAAK,CAAC,0BAA0B,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,KAAiB,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAc;IACvD,OAAO,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,eAAe,IAAI,KAAK,IAAI,MAAM,IAAI,KAAK,CAAC,CAAC;AACpG,CAAC"}

package/dist/crypto.d.ts

@@ -0,0 +1,10 @@
+export type EncryptedJsonEnvelope = {
+    v: 1;
+    alg: "A256GCM";
+    iv: string;
+    ciphertext: string;
+};
+export declare function createEncryptionKey(): string;
+export declare function encryptJson(value: unknown, keyMaterial: string): Promise<EncryptedJsonEnvelope>;
+export declare function decryptJson<T>(envelope: EncryptedJsonEnvelope, keyMaterial: string): Promise<T>;
+//# sourceMappingURL=crypto.d.ts.map

package/dist/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,qBAAqB,GAAG;IAClC,CAAC,EAAE,CAAC,CAAC;IACL,GAAG,EAAE,SAAS,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAWrG;AAED,wBAAsB,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CASrG"}

package/dist/crypto.js

@@ -0,0 +1,42 @@
+import { fromBase64Url, randomBase64Url, toBase64Url } from "./ids.js";
+const AES_GCM_IV_BYTES = 12;
+const AES_GCM_KEY_BYTES = 32;
+export function createEncryptionKey() {
+    return randomBase64Url(AES_GCM_KEY_BYTES);
+}
+export async function encryptJson(value, keyMaterial) {
+    const iv = crypto.getRandomValues(new Uint8Array(AES_GCM_IV_BYTES));
+    const key = await importAesKey(keyMaterial);
+    const plaintext = new TextEncoder().encode(JSON.stringify(value));
+    const ciphertext = await crypto.subtle.encrypt({ name: "AES-GCM", iv }, key, plaintext);
+    return {
+        v: 1,
+        alg: "A256GCM",
+        iv: toBase64Url(iv),
+        ciphertext: toBase64Url(new Uint8Array(ciphertext)),
+    };
+}
+export async function decryptJson(envelope, keyMaterial) {
+    if (envelope.v !== 1 || envelope.alg !== "A256GCM")
+        throw new Error("Unsupported encrypted JSON envelope.");
+    const key = await importAesKey(keyMaterial);
+    const plaintext = await crypto.subtle.decrypt({ name: "AES-GCM", iv: toArrayBuffer(fromBase64Url(envelope.iv)) }, key, toArrayBuffer(fromBase64Url(envelope.ciphertext)));
+    return JSON.parse(new TextDecoder().decode(plaintext));
+}
+async function importAesKey(keyMaterial) {
+    let raw;
+    try {
+        raw = fromBase64Url(keyMaterial);
+    }
+    catch {
+        throw new Error("Encryption key must be 32 base64url-encoded bytes.");
+    }
+    if (raw.byteLength !== AES_GCM_KEY_BYTES) {
+        throw new Error("Encryption key must be 32 base64url-encoded bytes.");
+    }
+    return crypto.subtle.importKey("raw", toArrayBuffer(raw), "AES-GCM", false, ["encrypt", "decrypt"]);
+}
+function toArrayBuffer(bytes) {
+    return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+}
+//# sourceMappingURL=crypto.js.map

package/dist/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvE,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAS7B,MAAM,UAAU,mBAAmB;IACjC,OAAO,eAAe,CAAC,iBAAiB,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAc,EAAE,WAAmB;IACnE,MAAM,EAAE,GAAG,MAAM,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACpE,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IACxF,OAAO;QACL,CAAC,EAAE,CAAC;QACJ,GAAG,EAAE,SAAS;QACd,EAAE,EAAE,WAAW,CAAC,EAAE,CAAC;QACnB,UAAU,EAAE,WAAW,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;KACpD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAI,QAA+B,EAAE,WAAmB;IACvF,IAAI,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,GAAG,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC5G,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAC3C,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,aAAa,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,EAClE,GAAG,EACH,aAAa,CAAC,aAAa,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAClD,CAAC;IACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAM,CAAC;AAC9D,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,WAAmB;IAC7C,IAAI,GAAe,CAAC;IACpB,IAAI,CAAC;QACH,GAAG,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,GAAG,CAAC,UAAU,KAAK,iBAAiB,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AACtG,CAAC;AAED,SAAS,aAAa,CAAC,KAAiB;IACtC,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAgB,CAAC;AAClG,CAAC"}

package/dist/d1.d.ts

@@ -0,0 +1,34 @@
+export type D1Primitive = string | number | boolean | null | Uint8Array;
+export interface D1StatementResult {
+    success: boolean;
+    meta: Record<string, unknown>;
+    results?: Record<string, unknown>[];
+}
+export interface D1PreparedStatementLike {
+    bind(...values: D1Primitive[]): D1PreparedStatementLike;
+    run(): Promise<D1StatementResult>;
+    first<T extends object = Record<string, unknown>>(): Promise<T | null>;
+    all<T extends object = Record<string, unknown>>(): Promise<{
+        results: T[];
+    }>;
+}
+export interface D1DatabaseLike {
+    prepare(query: string): D1PreparedStatementLike;
+    batch(statements: D1PreparedStatementLike[]): Promise<D1StatementResult[]>;
+    exec(query: string): Promise<unknown>;
+}
+export type Migration = {
+    id: string;
+    sql: string;
+};
+export type MigrationResult = {
+    applied: string[];
+    skipped: string[];
+};
+export declare function ensureMigrationsTable(db: D1DatabaseLike, tableName?: string): Promise<void>;
+export declare function applyD1Migrations(db: D1DatabaseLike, migrations: Migration[], options?: {
+    tableName?: string;
+}): Promise<MigrationResult>;
+export declare function parseJsonColumn<T>(value: string | null | undefined, fallback: T): T;
+export declare function stringifyJsonColumn(value: unknown): string;
+//# sourceMappingURL=d1.d.ts.map

package/dist/d1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"d1.d.ts","sourceRoot":"","sources":["../src/d1.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,UAAU,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,uBAAuB,CAAC;IACxD,GAAG,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAClC,KAAK,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvE,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC,EAAE,CAAA;KAAE,CAAC,CAAC;CAC9E;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,uBAAuB,CAAC;IAChD,KAAK,CAAC,UAAU,EAAE,uBAAuB,EAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC3E,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,cAAc,EAAE,SAAS,SAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ9G;AAED,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,cAAc,EAClB,UAAU,EAAE,SAAS,EAAE,EACvB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnC,OAAO,CAAC,eAAe,CAAC,CAqB1B;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAOnF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE1D"}

package/dist/d1.js

@@ -0,0 +1,44 @@
+export async function ensureMigrationsTable(db, tableName = "schema_migrations") {
+    assertSafeIdentifier(tableName);
+    await db.exec(`CREATE TABLE IF NOT EXISTS ${tableName} (
+      id TEXT PRIMARY KEY,
+      applied_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP
+    )`);
+}
+export async function applyD1Migrations(db, migrations, options = {}) {
+    const tableName = options.tableName ?? "schema_migrations";
+    assertSafeIdentifier(tableName);
+    await ensureMigrationsTable(db, tableName);
+    const applied = [];
+    const skipped = [];
+    for (const migration of migrations) {
+        const existing = await db.prepare(`SELECT id FROM ${tableName} WHERE id = ? LIMIT 1`).bind(migration.id).first();
+        if (existing) {
+            skipped.push(migration.id);
+            continue;
+        }
+        await db.exec(migration.sql);
+        await db.prepare(`INSERT INTO ${tableName} (id) VALUES (?)`).bind(migration.id).run();
+        applied.push(migration.id);
+    }
+    return { applied, skipped };
+}
+export function parseJsonColumn(value, fallback) {
+    if (!value)
+        return fallback;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return fallback;
+    }
+}
+export function stringifyJsonColumn(value) {
+    return JSON.stringify(value ?? null);
+}
+function assertSafeIdentifier(value) {
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(value)) {
+        throw new Error(`Unsafe SQL identifier: ${value}`);
+    }
+}
+//# sourceMappingURL=d1.js.map

package/dist/d1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"d1.js","sourceRoot":"","sources":["../src/d1.ts"],"names":[],"mappings":"AA+BA,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,EAAkB,EAAE,SAAS,GAAG,mBAAmB;IAC7F,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,EAAE,CAAC,IAAI,CACX,8BAA8B,SAAS;;;MAGrC,CACH,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,EAAkB,EAClB,UAAuB,EACvB,UAAkC,EAAE;IAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,mBAAmB,CAAC;IAC3D,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,qBAAqB,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IAE3C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,kBAAkB,SAAS,uBAAuB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QACjH,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC3B,SAAS;QACX,CAAC;QAED,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,EAAE,CAAC,OAAO,CAAC,eAAe,SAAS,kBAAkB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;QACtF,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,eAAe,CAAI,KAAgC,EAAE,QAAW;IAC9E,IAAI,CAAC,KAAK;QAAE,OAAO,QAAQ,CAAC;IAC5B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAM,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa;IACzC,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/dist/email.d.ts

@@ -0,0 +1,33 @@
+export type EmailAddress = {
+    email: string;
+    name?: string;
+};
+export type EmailAttachment = {
+    filename: string;
+    contentType: string;
+    data: Uint8Array | string;
+};
+export type SendEmailInput = {
+    from: EmailAddress;
+    to: EmailAddress[];
+    cc?: EmailAddress[];
+    bcc?: EmailAddress[];
+    replyTo?: EmailAddress[];
+    subject: string;
+    text?: string;
+    html?: string;
+    attachments?: EmailAttachment[];
+    tags?: Record<string, string>;
+};
+export type SendEmailResult = {
+    id: string;
+    provider?: string;
+    metadata?: Record<string, unknown>;
+};
+export interface EmailProvider {
+    send(input: SendEmailInput): Promise<SendEmailResult>;
+}
+export declare function formatEmailAddress(address: EmailAddress): string;
+export declare function normalizeEmailAddress(email: string): string;
+export declare function appendUnsubscribeFooter(text: string, unsubscribeUrl: string): string;
+//# sourceMappingURL=email.d.ts.map

package/dist/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../src/email.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,YAAY,EAAE,CAAC;IACnB,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC;IACpB,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACvD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAIhE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAEpF"}

package/dist/email.js

@@ -0,0 +1,16 @@
+export function formatEmailAddress(address) {
+    if (!address.name)
+        return address.email;
+    const escaped = address.name.replace(/"/g, '\\"');
+    return `"${escaped}" <${address.email}>`;
+}
+export function normalizeEmailAddress(email) {
+    const normalized = email.trim().toLowerCase();
+    if (!/^[^@\s]+@[^@\s]+\.[^@\s]+$/.test(normalized))
+        throw new Error(`Invalid email address: ${email}`);
+    return normalized;
+}
+export function appendUnsubscribeFooter(text, unsubscribeUrl) {
+    return `${text.trim()}\n\nUnsubscribe: ${unsubscribeUrl}\n`;
+}
+//# sourceMappingURL=email.js.map

package/dist/email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.js","sourceRoot":"","sources":["../src/email.ts"],"names":[],"mappings":"AAkCA,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACtD,IAAI,CAAC,OAAO,CAAC,IAAI;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC;IACxC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAClD,OAAO,IAAI,OAAO,MAAM,OAAO,CAAC,KAAK,GAAG,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC;IACvG,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,cAAsB;IAC1E,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,oBAAoB,cAAc,IAAI,CAAC;AAC9D,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1,11 @@
+export type EnvSource = Record<string, unknown>;
+export declare class EnvError extends Error {
+    constructor(message: string);
+}
+export declare function requiredString(env: EnvSource, key: string): string;
+export declare function optionalString(env: EnvSource, key: string, fallback?: string): string | undefined;
+export declare function requiredUrl(env: EnvSource, key: string): string;
+export declare function optionalBoolean(env: EnvSource, key: string, fallback?: boolean): boolean;
+export declare function requiredBinding<T>(env: EnvSource, key: string): T;
+export declare function appUrl(env: EnvSource, fallback?: string): string;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEhD,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAMlE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKjG;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAO/D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAQtF;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,CAIjE;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,SAA0B,GAAG,MAAM,CAGjF"}

package/dist/env.js

@@ -0,0 +1,55 @@
+export class EnvError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "EnvError";
+    }
+}
+export function requiredString(env, key) {
+    const value = env[key];
+    if (typeof value !== "string" || value.trim() === "") {
+        throw new EnvError(`Missing required env var: ${key}`);
+    }
+    return value;
+}
+export function optionalString(env, key, fallback) {
+    const value = env[key];
+    if (value === undefined || value === null || value === "")
+        return fallback;
+    if (typeof value !== "string")
+        throw new EnvError(`Expected ${key} to be a string.`);
+    return value;
+}
+export function requiredUrl(env, key) {
+    const value = requiredString(env, key);
+    try {
+        return new URL(value).toString().replace(/\/$/, "");
+    }
+    catch {
+        throw new EnvError(`Expected ${key} to be a valid URL.`);
+    }
+}
+export function optionalBoolean(env, key, fallback = false) {
+    const value = env[key];
+    if (value === undefined || value === null || value === "")
+        return fallback;
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value !== "string")
+        throw new EnvError(`Expected ${key} to be boolean-like.`);
+    if (/^(1|true|yes|on)$/i.test(value))
+        return true;
+    if (/^(0|false|no|off)$/i.test(value))
+        return false;
+    throw new EnvError(`Expected ${key} to be boolean-like.`);
+}
+export function requiredBinding(env, key) {
+    const value = env[key];
+    if (value === undefined || value === null)
+        throw new EnvError(`Missing required binding: ${key}`);
+    return value;
+}
+export function appUrl(env, fallback = "http://localhost:8787") {
+    const value = optionalString(env, "APP_URL") ?? optionalString(env, "BASE_URL") ?? optionalString(env, "PUBLIC_APP_URL") ?? fallback;
+    return value.replace(/\/$/, "");
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,GAAc,EAAE,GAAW;IACxD,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,IAAI,QAAQ,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAc,EAAE,GAAW,EAAE,QAAiB;IAC3E,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAC3E,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,QAAQ,CAAC,YAAY,GAAG,kBAAkB,CAAC,CAAC;IACrF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAc,EAAE,GAAW;IACrD,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAAC,YAAY,GAAG,qBAAqB,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAc,EAAE,GAAW,EAAE,QAAQ,GAAG,KAAK;IAC3E,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAC3E,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,QAAQ,CAAC,YAAY,GAAG,sBAAsB,CAAC,CAAC;IACzF,IAAI,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACpD,MAAM,IAAI,QAAQ,CAAC,YAAY,GAAG,sBAAsB,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,eAAe,CAAI,GAAc,EAAE,GAAW;IAC5D,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,MAAM,IAAI,QAAQ,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;IAClG,OAAO,KAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAc,EAAE,QAAQ,GAAG,uBAAuB;IACvE,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,cAAc,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,cAAc,CAAC,GAAG,EAAE,gBAAgB,CAAC,IAAI,QAAQ,CAAC;IACrI,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAClC,CAAC"}