@voyantjs/crm 0.26.2 → 0.26.4

package/dist/schema-signals.d.ts

@@ -0,0 +1,324 @@
+/**
+ * Customer signals — lighter than `opportunities` (no deal value or
+ * stages), heavier than `segments` (lifecycle + assignment). Records
+ * "person X expressed interest in product/departure Y from source Z,
+ * status pending". The most common use cases:
+ *
+ *   - Notify-availability ("ping me when this departure opens up")
+ *   - Wishlist / saved trips
+ *   - Inquiry captured by an operator (phone call, web form)
+ *   - Request-offer pre-pipeline that may or may not become a booking
+ *   - Abandoned-cart recovery
+ *
+ * Cross-module IDs (`productId`, `optionUnitId`, `resolvedBookingId`)
+ * are intentionally plain `text()` columns rather than FK references
+ * — voyant's project-wide rule is that cross-module FKs go through
+ * link tables or stay loose. The signal is owned by CRM; products
+ * and bookings reference its id, not the other way around.
+ */
+export declare const customerSignalKindEnum: import("drizzle-orm/pg-core").PgEnum<["wishlist", "notify", "inquiry", "request_offer", "referral"]>;
+export declare const customerSignalSourceEnum: import("drizzle-orm/pg-core").PgEnum<["form", "phone", "admin", "abandoned_cart", "website", "booking"]>;
+export declare const customerSignalStatusEnum: import("drizzle-orm/pg-core").PgEnum<["new", "contacted", "qualified", "converted", "lost", "expired"]>;
+export declare const customerSignals: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "customer_signals";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: string;
+            tableName: "customer_signals";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: true;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        personId: import("drizzle-orm/pg-core").PgColumn<{
+            name: string;
+            tableName: "customer_signals";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        productId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "product_id";
+            tableName: "customer_signals";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        optionUnitId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "option_unit_id";
+            tableName: "customer_signals";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        kind: import("drizzle-orm/pg-core").PgColumn<{
+            name: "kind";
+            tableName: "customer_signals";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "wishlist" | "notify" | "inquiry" | "request_offer" | "referral";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["wishlist", "notify", "inquiry", "request_offer", "referral"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        source: import("drizzle-orm/pg-core").PgColumn<{
+            name: "source";
+            tableName: "customer_signals";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "admin" | "form" | "phone" | "website" | "abandoned_cart" | "booking";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["form", "phone", "admin", "abandoned_cart", "website", "booking"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        status: import("drizzle-orm/pg-core").PgColumn<{
+            name: "status";
+            tableName: "customer_signals";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "lost" | "expired" | "new" | "contacted" | "qualified" | "converted";
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["new", "contacted", "qualified", "converted", "lost", "expired"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        priority: import("drizzle-orm/pg-core").PgColumn<{
+            name: "priority";
+            tableName: "customer_signals";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        notes: import("drizzle-orm/pg-core").PgColumn<{
+            name: "notes";
+            tableName: "customer_signals";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        tags: import("drizzle-orm/pg-core").PgColumn<{
+            name: "tags";
+            tableName: "customer_signals";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: string[];
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: string[];
+        }>;
+        assignedToUserId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "assigned_to_user_id";
+            tableName: "customer_signals";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        followUpAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "follow_up_at";
+            tableName: "customer_signals";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        resolvedBookingId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "resolved_booking_id";
+            tableName: "customer_signals";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        sourceSubmissionId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "source_submission_id";
+            tableName: "customer_signals";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        metadata: import("drizzle-orm/pg-core").PgColumn<{
+            name: "metadata";
+            tableName: "customer_signals";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: Record<string, unknown>;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: Record<string, unknown>;
+        }>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "customer_signals";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "customer_signals";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export type CustomerSignal = typeof customerSignals.$inferSelect;
+export type NewCustomerSignal = typeof customerSignals.$inferInsert;
+//# sourceMappingURL=schema-signals.d.ts.map

package/dist/schema-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-signals.d.ts","sourceRoot":"","sources":["../src/schema-signals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,eAAO,MAAM,sBAAsB,sGAMjC,CAAA;AAEF,eAAO,MAAM,wBAAwB,0GAOnC,CAAA;AAEF,eAAO,MAAM,wBAAwB,yGAOnC,CAAA;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2C3B,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,OAAO,eAAe,CAAC,YAAY,CAAA;AAChE,MAAM,MAAM,iBAAiB,GAAG,OAAO,eAAe,CAAC,YAAY,CAAA"}

package/dist/schema-signals.js

@@ -0,0 +1,80 @@
+/**
+ * Customer signals — lighter than `opportunities` (no deal value or
+ * stages), heavier than `segments` (lifecycle + assignment). Records
+ * "person X expressed interest in product/departure Y from source Z,
+ * status pending". The most common use cases:
+ *
+ *   - Notify-availability ("ping me when this departure opens up")
+ *   - Wishlist / saved trips
+ *   - Inquiry captured by an operator (phone call, web form)
+ *   - Request-offer pre-pipeline that may or may not become a booking
+ *   - Abandoned-cart recovery
+ *
+ * Cross-module IDs (`productId`, `optionUnitId`, `resolvedBookingId`)
+ * are intentionally plain `text()` columns rather than FK references
+ * — voyant's project-wide rule is that cross-module FKs go through
+ * link tables or stay loose. The signal is owned by CRM; products
+ * and bookings reference its id, not the other way around.
+ */
+import { typeId, typeIdRef } from "@voyantjs/db/lib/typeid-column";
+import { index, jsonb, pgEnum, pgTable, text, timestamp } from "drizzle-orm/pg-core";
+import { people } from "./schema-accounts.js";
+export const customerSignalKindEnum = pgEnum("customer_signal_kind", [
+    "wishlist",
+    "notify",
+    "inquiry",
+    "request_offer",
+    "referral",
+]);
+export const customerSignalSourceEnum = pgEnum("customer_signal_source", [
+    "form",
+    "phone",
+    "admin",
+    "abandoned_cart",
+    "website",
+    "booking",
+]);
+export const customerSignalStatusEnum = pgEnum("customer_signal_status", [
+    "new",
+    "contacted",
+    "qualified",
+    "converted",
+    "lost",
+    "expired",
+]);
+export const customerSignals = pgTable("customer_signals", {
+    id: typeId("customer_signals"),
+    personId: typeIdRef("person_id")
+        .notNull()
+        .references(() => people.id, { onDelete: "cascade" }),
+    /** Optional reference into `@voyantjs/products`. Plain text — no FK. */
+    productId: text("product_id"),
+    /** Optional reference into a product's `option_units` row (the "departure"-equivalent). Plain text — no FK. */
+    optionUnitId: text("option_unit_id"),
+    kind: customerSignalKindEnum("kind").notNull(),
+    source: customerSignalSourceEnum("source").notNull(),
+    status: customerSignalStatusEnum("status").notNull().default("new"),
+    /**
+     * Free-form priority. The validation layer constrains input to
+     * `low | normal | high | urgent`; storing as text keeps room for
+     * deployment-specific values without a DB migration.
+     */
+    priority: text("priority").notNull().default("normal"),
+    notes: text("notes"),
+    tags: jsonb("tags").$type().notNull().default([]),
+    /** User id (Better Auth user) of the staff member assigned to follow up. */
+    assignedToUserId: text("assigned_to_user_id"),
+    followUpAt: timestamp("follow_up_at", { withTimezone: true }),
+    /** Set when the signal was converted into a real booking. Plain text — cross-module FK. */
+    resolvedBookingId: text("resolved_booking_id"),
+    /** Free-form provenance id (form-submission id, abandoned-cart key, ...). */
+    sourceSubmissionId: text("source_submission_id"),
+    metadata: jsonb("metadata").$type(),
+    createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow(),
+}, (table) => [
+    index("idx_customer_signals_person_status_created").on(table.personId, table.status, table.createdAt),
+    index("idx_customer_signals_assignee_status").on(table.assignedToUserId, table.status),
+    index("idx_customer_signals_kind").on(table.kind),
+    index("idx_customer_signals_resolved_booking").on(table.resolvedBookingId),
+]);

package/dist/schema.d.ts

@@ -4,4 +4,5 @@ export * from "./schema-activities.js";
 export * from "./schema-relations.js";
 export * from "./schema-sales.js";
 export * from "./schema-shared.js";
+export * from "./schema-signals.js";
 //# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,cAAc,sBAAsB,CAAA;AACpC,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,cAAc,sBAAsB,CAAA;AACpC,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA"}

package/dist/schema.js

@@ -4,3 +4,4 @@ export * from "./schema-activities.js";
 export * from "./schema-relations.js";
 export * from "./schema-sales.js";
 export * from "./schema-shared.js";
+export * from "./schema-signals.js";