@beorchid-llc/thrivo-contracts 0.10.0 → 0.11.0

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export * from "./admin-analytics";
 export * from "./admin-content";
 export * from "./admin-logs";
 export * from "./admin-subscriptions";
+export * from "./leads";
 export * from "./dashboard";
 export * from "./foods";
 export * from "./metrics";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -6,6 +6,7 @@ export * from "./admin-analytics";
 export * from "./admin-content";
 export * from "./admin-logs";
 export * from "./admin-subscriptions";
+export * from "./leads";
 export * from "./dashboard";
 export * from "./foods";
 export * from "./metrics";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC"}

package/dist/leads.d.ts

@@ -0,0 +1,247 @@
+import { z } from "zod";
+/**
+ * Lead capture (pre-signup email captures -- "leads"). Extend this enum as new
+ * capture points are added; the DB column itself stays plain text so new
+ * sources don't require a migration, only a contract minor-bump.
+ */
+export declare const leadSourceSchema: z.ZodEnum<["cta", "landing", "waitlist"]>;
+export type LeadSource = z.infer<typeof leadSourceSchema>;
+/** POST /leads/capture payload -- public, unauthenticated. */
+export declare const leadCapturePayloadSchema: z.ZodObject<{
+    email: z.ZodEffects<z.ZodString, string, string>;
+    source: z.ZodEnum<["cta", "landing", "waitlist"]>;
+    utmSource: z.ZodOptional<z.ZodString>;
+    utmMedium: z.ZodOptional<z.ZodString>;
+    utmCampaign: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    email: string;
+    source: "cta" | "landing" | "waitlist";
+    utmSource?: string | undefined;
+    utmMedium?: string | undefined;
+    utmCampaign?: string | undefined;
+}, {
+    email: string;
+    source: "cta" | "landing" | "waitlist";
+    utmSource?: string | undefined;
+    utmMedium?: string | undefined;
+    utmCampaign?: string | undefined;
+}>;
+export type LeadCapturePayload = z.infer<typeof leadCapturePayloadSchema>;
+/**
+ * Deliberately minimal -- identical on first submission and every resubmission,
+ * so the response never reveals whether an email was already registered.
+ */
+export declare const leadCaptureResponseSchema: z.ZodObject<{
+    captured: z.ZodLiteral<true>;
+}, "strip", z.ZodTypeAny, {
+    captured: true;
+}, {
+    captured: true;
+}>;
+export type LeadCaptureResponse = z.infer<typeof leadCaptureResponseSchema>;
+/** Admin list/detail row -- full email_captures shape (minus the raw user-agent). */
+export declare const adminLeadSchema: z.ZodObject<{
+    id: z.ZodString;
+    email: z.ZodString;
+    source: z.ZodNullable<z.ZodString>;
+    reconciledUserId: z.ZodNullable<z.ZodString>;
+    capturedAt: z.ZodString;
+    lastSubmittedAt: z.ZodString;
+    submissionCount: z.ZodNumber;
+    country: z.ZodNullable<z.ZodString>;
+    deviceType: z.ZodNullable<z.ZodString>;
+    osName: z.ZodNullable<z.ZodString>;
+    osVersion: z.ZodNullable<z.ZodString>;
+    browserName: z.ZodNullable<z.ZodString>;
+    browserVersion: z.ZodNullable<z.ZodString>;
+    referrer: z.ZodNullable<z.ZodString>;
+    utmSource: z.ZodNullable<z.ZodString>;
+    utmMedium: z.ZodNullable<z.ZodString>;
+    utmCampaign: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    email: string;
+    source: string | null;
+    utmSource: string | null;
+    utmMedium: string | null;
+    utmCampaign: string | null;
+    reconciledUserId: string | null;
+    capturedAt: string;
+    lastSubmittedAt: string;
+    submissionCount: number;
+    country: string | null;
+    deviceType: string | null;
+    osName: string | null;
+    osVersion: string | null;
+    browserName: string | null;
+    browserVersion: string | null;
+    referrer: string | null;
+}, {
+    id: string;
+    email: string;
+    source: string | null;
+    utmSource: string | null;
+    utmMedium: string | null;
+    utmCampaign: string | null;
+    reconciledUserId: string | null;
+    capturedAt: string;
+    lastSubmittedAt: string;
+    submissionCount: number;
+    country: string | null;
+    deviceType: string | null;
+    osName: string | null;
+    osVersion: string | null;
+    browserName: string | null;
+    browserVersion: string | null;
+    referrer: string | null;
+}>;
+export type AdminLead = z.infer<typeof adminLeadSchema>;
+export declare const adminLeadListResponseSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        email: z.ZodString;
+        source: z.ZodNullable<z.ZodString>;
+        reconciledUserId: z.ZodNullable<z.ZodString>;
+        capturedAt: z.ZodString;
+        lastSubmittedAt: z.ZodString;
+        submissionCount: z.ZodNumber;
+        country: z.ZodNullable<z.ZodString>;
+        deviceType: z.ZodNullable<z.ZodString>;
+        osName: z.ZodNullable<z.ZodString>;
+        osVersion: z.ZodNullable<z.ZodString>;
+        browserName: z.ZodNullable<z.ZodString>;
+        browserVersion: z.ZodNullable<z.ZodString>;
+        referrer: z.ZodNullable<z.ZodString>;
+        utmSource: z.ZodNullable<z.ZodString>;
+        utmMedium: z.ZodNullable<z.ZodString>;
+        utmCampaign: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        email: string;
+        source: string | null;
+        utmSource: string | null;
+        utmMedium: string | null;
+        utmCampaign: string | null;
+        reconciledUserId: string | null;
+        capturedAt: string;
+        lastSubmittedAt: string;
+        submissionCount: number;
+        country: string | null;
+        deviceType: string | null;
+        osName: string | null;
+        osVersion: string | null;
+        browserName: string | null;
+        browserVersion: string | null;
+        referrer: string | null;
+    }, {
+        id: string;
+        email: string;
+        source: string | null;
+        utmSource: string | null;
+        utmMedium: string | null;
+        utmCampaign: string | null;
+        reconciledUserId: string | null;
+        capturedAt: string;
+        lastSubmittedAt: string;
+        submissionCount: number;
+        country: string | null;
+        deviceType: string | null;
+        osName: string | null;
+        osVersion: string | null;
+        browserName: string | null;
+        browserVersion: string | null;
+        referrer: string | null;
+    }>, "many">;
+    pagination: z.ZodObject<{
+        page: z.ZodNumber;
+        pageSize: z.ZodNumber;
+        total: z.ZodNumber;
+        totalPages: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        page: number;
+        pageSize: number;
+        total: number;
+        totalPages: number;
+    }, {
+        page: number;
+        pageSize: number;
+        total: number;
+        totalPages: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    items: {
+        id: string;
+        email: string;
+        source: string | null;
+        utmSource: string | null;
+        utmMedium: string | null;
+        utmCampaign: string | null;
+        reconciledUserId: string | null;
+        capturedAt: string;
+        lastSubmittedAt: string;
+        submissionCount: number;
+        country: string | null;
+        deviceType: string | null;
+        osName: string | null;
+        osVersion: string | null;
+        browserName: string | null;
+        browserVersion: string | null;
+        referrer: string | null;
+    }[];
+    pagination: {
+        page: number;
+        pageSize: number;
+        total: number;
+        totalPages: number;
+    };
+}, {
+    items: {
+        id: string;
+        email: string;
+        source: string | null;
+        utmSource: string | null;
+        utmMedium: string | null;
+        utmCampaign: string | null;
+        reconciledUserId: string | null;
+        capturedAt: string;
+        lastSubmittedAt: string;
+        submissionCount: number;
+        country: string | null;
+        deviceType: string | null;
+        osName: string | null;
+        osVersion: string | null;
+        browserName: string | null;
+        browserVersion: string | null;
+        referrer: string | null;
+    }[];
+    pagination: {
+        page: number;
+        pageSize: number;
+        total: number;
+        totalPages: number;
+    };
+}>;
+export type AdminLeadListResponse = z.infer<typeof adminLeadListResponseSchema>;
+export declare const leadRoutes: {
+    capture: {
+        method: "POST";
+        path: "/api/v1/leads/capture";
+        auth: "public";
+    };
+    adminList: {
+        method: "GET";
+        path: "/api/v1/admin/leads";
+        auth: "admin";
+    };
+    adminDelete: {
+        method: "DELETE";
+        path: "/api/v1/admin/leads/:id";
+        auth: "admin";
+    };
+    adminExport: {
+        method: "GET";
+        path: "/api/v1/admin/leads/export";
+        auth: "admin";
+    };
+};
+//# sourceMappingURL=leads.d.ts.map

package/dist/leads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leads.d.ts","sourceRoot":"","sources":["../src/leads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,2CAAyC,CAAC;AACvE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,8DAA8D;AAC9D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;EAUnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;EAA0C,CAAC;AACjF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,qFAAqF;AACrF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkB1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAkC,CAAC;AAC3E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;CAsBkB,CAAC"}

package/dist/leads.js

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import { idSchema, isoDateSchema } from "./common";
+import { adminPaginated } from "./admin";
+/**
+ * Lead capture (pre-signup email captures -- "leads"). Extend this enum as new
+ * capture points are added; the DB column itself stays plain text so new
+ * sources don't require a migration, only a contract minor-bump.
+ */
+export const leadSourceSchema = z.enum(["cta", "landing", "waitlist"]);
+/** POST /leads/capture payload -- public, unauthenticated. */
+export const leadCapturePayloadSchema = z.object({
+    email: z
+        .string()
+        .email()
+        .max(254)
+        .transform((e) => e.toLowerCase()),
+    source: leadSourceSchema,
+    utmSource: z.string().max(255).optional(),
+    utmMedium: z.string().max(255).optional(),
+    utmCampaign: z.string().max(255).optional(),
+});
+/**
+ * Deliberately minimal -- identical on first submission and every resubmission,
+ * so the response never reveals whether an email was already registered.
+ */
+export const leadCaptureResponseSchema = z.object({ captured: z.literal(true) });
+/** Admin list/detail row -- full email_captures shape (minus the raw user-agent). */
+export const adminLeadSchema = z.object({
+    id: idSchema,
+    email: z.string().email(),
+    source: z.string().nullable(),
+    reconciledUserId: z.string().nullable(),
+    capturedAt: isoDateSchema,
+    lastSubmittedAt: isoDateSchema,
+    submissionCount: z.number().int(),
+    country: z.string().nullable(),
+    deviceType: z.string().nullable(),
+    osName: z.string().nullable(),
+    osVersion: z.string().nullable(),
+    browserName: z.string().nullable(),
+    browserVersion: z.string().nullable(),
+    referrer: z.string().nullable(),
+    utmSource: z.string().nullable(),
+    utmMedium: z.string().nullable(),
+    utmCampaign: z.string().nullable(),
+});
+export const adminLeadListResponseSchema = adminPaginated(adminLeadSchema);
+export const leadRoutes = {
+    capture: {
+        method: "POST",
+        path: "/api/v1/leads/capture",
+        auth: "public",
+    },
+    adminList: {
+        method: "GET",
+        path: "/api/v1/admin/leads",
+        auth: "admin",
+    },
+    adminDelete: {
+        method: "DELETE",
+        path: "/api/v1/admin/leads/:id",
+        auth: "admin",
+    },
+    // CSV body, not JSON -- no response schema; route metadata only.
+    adminExport: {
+        method: "GET",
+        path: "/api/v1/admin/leads/export",
+        auth: "admin",
+    },
+};
+//# sourceMappingURL=leads.js.map

package/dist/leads.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beorchid-llc/thrivo-contracts",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Shared Thrivo API request and response contracts.",
   "type": "module",
   "private": false,