@foxscheduling/shared 0.1.0

package/README.md

@@ -0,0 +1,56 @@
+# @foxscheduling/shared
+
+Shared utilities and interfaces for FoxScheduling backend and frontend.
+
+## Installation
+
+With npm workspaces (already configured in the root `package.json`):
+
+```bash
+# From project root
+npm install
+```
+
+Then add the dependency to your backend or frontend:
+
+```bash
+# In backend or frontend directory
+npm install @foxscheduling/shared
+```
+
+Or add to `package.json`:
+
+```json
+{
+  "dependencies": {
+    "@foxscheduling/shared": "file:../shared-library"
+  }
+}
+```
+
+(Use `workspace:*` if using pnpm or yarn workspaces.)
+
+## Usage
+
+```ts
+// Import everything
+import { formatCurrency, type CDKConfig, type DeploymentEnvironments } from "@foxscheduling/shared";
+
+// Or import subpaths
+import { formatCurrency } from "@foxscheduling/shared/utils";
+import type { CDKConfig } from "@foxscheduling/shared/types";
+```
+
+## Development
+
+```bash
+cd src/v1/shared-library
+npm run build    # Build once
+npm run dev      # Watch mode
+```
+
+## Structure
+
+- `src/types/` - Shared interfaces and type definitions
+- `src/utils/` - Shared utility functions
+- `src/index.ts` - Main entry point (re-exports all)

package/dist/cjs/constants/emailUnsubscribeReasons.cjs

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMAIL_UNSUBSCRIBE_REASON_IDS = void 0;
+/** Stable ids sent to the API when a user picks an unsubscribe reason. */
+exports.EMAIL_UNSUBSCRIBE_REASON_IDS = [
+    "too_many_emails",
+    "not_relevant",
+    "never_signed_up",
+    "privacy_concerns",
+    "found_alternative",
+    "no_longer_using",
+    "other",
+];

package/dist/cjs/constants/emailUnsubscribeReasons.d.ts

@@ -0,0 +1,4 @@
+/** Stable ids sent to the API when a user picks an unsubscribe reason. */
+export declare const EMAIL_UNSUBSCRIBE_REASON_IDS: readonly ["too_many_emails", "not_relevant", "never_signed_up", "privacy_concerns", "found_alternative", "no_longer_using", "other"];
+export type EmailUnsubscribeReasonId = (typeof EMAIL_UNSUBSCRIBE_REASON_IDS)[number];
+//# sourceMappingURL=emailUnsubscribeReasons.d.ts.map

package/dist/cjs/constants/emailUnsubscribeReasons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emailUnsubscribeReasons.d.ts","sourceRoot":"","sources":["../../../src/constants/emailUnsubscribeReasons.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,eAAO,MAAM,4BAA4B,sIAQ/B,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/cjs/index.cjs

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * @foxscheduling/shared
+ *
+ * Shared utilities and interfaces for FoxScheduling backend and frontend.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types/index.cjs"), exports);
+__exportStar(require("./utils/index.cjs"), exports);
+__exportStar(require("./constants/emailUnsubscribeReasons.cjs"), exports);

package/dist/cjs/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @foxscheduling/shared
+ *
+ * Shared utilities and interfaces for FoxScheduling backend and frontend.
+ */
+export * from "./types/index.js";
+export * from "./utils/index.js";
+export * from "./constants/emailUnsubscribeReasons.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wCAAwC,CAAC"}

package/dist/cjs/types/db.availability.cjs

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WEEKDAY_LABELS = void 0;
+exports.WEEKDAY_LABELS = {
+    0: "Sun",
+    1: "Mon",
+    2: "Tue",
+    3: "Wed",
+    4: "Thu",
+    5: "Fri",
+    6: "Sat",
+};

package/dist/cjs/types/db.availability.d.ts

@@ -0,0 +1,33 @@
+import { DBRecord } from "./db.js";
+export interface TimeWindow {
+    open: string;
+    close: string;
+}
+/** For specific_dates: each date has its own schedule */
+export interface SpecificDateEntry {
+    date: string;
+    schedule: TimeWindow;
+}
+/** Per-day schedule: each weekday has its own time windows */
+export type WeeklySchedule = Record<number, TimeWindow[]>;
+/** Block-off override for weekly: closed or custom hours on specific dates */
+export interface BlockOffOverride {
+    date: string;
+    type: "closed" | "custom";
+    schedule?: TimeWindow;
+}
+export interface Availability extends DBRecord {
+    name: string;
+    recordType: "AVAILABILITY";
+    isDefault: boolean;
+    tenantId: string;
+    type: "weekly" | "specific_dates";
+    /** For weekly: per-day schedule (each day has own windows) */
+    days?: WeeklySchedule;
+    /** For weekly: block off specific dates (override) */
+    blockOffOverrides?: BlockOffOverride[];
+    /** For specific_dates type */
+    specificDates?: SpecificDateEntry[];
+}
+export declare const WEEKDAY_LABELS: Record<number, string>;
+//# sourceMappingURL=db.availability.d.ts.map

package/dist/cjs/types/db.availability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.availability.d.ts","sourceRoot":"","sources":["../../../src/types/db.availability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,UAAU,CAAC;CACxB;AAED,8DAA8D;AAC9D,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;AAE1D,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,QAAQ,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,cAAc,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,GAAG,gBAAgB,CAAC;IAClC,8DAA8D;IAC9D,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACvC,8BAA8B;IAC9B,aAAa,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACvC;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQjD,CAAC"}

package/dist/cjs/types/db.booking.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/types/db.booking.d.ts

@@ -0,0 +1,101 @@
+import { DBRecord } from "./db.js";
+import { DurationUnit, ServiceSlot } from "./db.service.js";
+import type { Service, ServiceLocationType, ServiceReminderOffset } from "./db.service.js";
+export type BookingActionRequired = "deposit" | "confirmation";
+export interface BookingPaymentEntry {
+    id: string;
+    paid: boolean;
+    returnUrl?: string;
+    provider?: string;
+    stripePaymentIntentId?: string;
+}
+export interface Booking extends DBRecord {
+    name: string;
+    slug: string;
+    email: string;
+    /**
+     * The timezone of the booking. This is the timezone of the booking slot.
+     * This could be different from the tenant timezone.
+     */
+    timezone: string;
+    tenantId: string;
+    duration: number;
+    serviceId: string;
+    eventDate: string;
+    /**
+     * The slot of the booking. This is the slot of the booking.
+     * This is in UTC.
+     */
+    slot: ServiceSlot;
+    providerIds: string[];
+    customerId: string;
+    recordType: "BOOKING";
+    payments: {
+        full?: BookingPaymentEntry;
+        deposit?: BookingPaymentEntry;
+        reminder?: BookingPaymentEntry;
+    };
+    locationType: ServiceLocationType;
+    /** Google Meet or other video meeting URL when service uses google_meet */
+    meetingLink?: string;
+    meetingInPersonLocation?: string;
+    /** Google Calendar event id when `locationType` is google_meet (for attendee updates / cancel). */
+    googleCalendarEventId?: string;
+    /** Graph `onlineMeetings` id when `locationType` is microsoft_teams (for cancel/delete). */
+    microsoftOnlineMeetingId?: string;
+    /** Zoom meeting id when `locationType` is zoom (for cancel/delete). */
+    zoomMeetingId?: string;
+    reservedUntil?: string;
+    durationUnit: DurationUnit;
+    providerAutoAssigned: boolean;
+    actionsRequired: Array<BookingActionRequired>;
+    status: "booked" | "cancelled" | "pendingApproval" | "reserved";
+    cancelledByUserOrCustomerId?: string;
+    lastUpdatedByUserOrCustomerId?: string;
+    bookingCancellerType?: "customer" | "serviceProvider" | "system";
+    remindersSent?: Array<{
+        sentOn: string;
+        offset: ServiceReminderOffset;
+    }>;
+    questionAnswers?: Array<{
+        questionId: string;
+        question: string;
+        answer: string;
+    }>;
+    /** 1–5 star rating from the booker after the appointment (set once) */
+    customerRating?: number;
+    /** When the customer submitted their rating (ISO) */
+    customerRatedOn?: string;
+    /** Per email-flow template id → when that follow-up was sent (ISO) */
+    emailFlowSends?: Record<string, string>;
+    /**
+     * When staff triggered the no-show email flow for this booking (ISO).
+     * Used only with flowType `no_show` templates.
+     */
+    noShowFlowTriggeredAt?: string;
+}
+/** Booking enriched with service and provider display info for list views */
+export interface BookingWithDetails extends Booking {
+    serviceName?: string;
+    serviceIconId?: Service["iconId"];
+    /** Display names for each assigned provider (same order as `providerIds` / normalized assignees). */
+    providerNames?: string[];
+    /** Profile image URLs for each assigned provider (parallel to `providerNames`). */
+    providerPictureUrls?: (string | undefined)[];
+    /** For group bookings: number booked into this exact slot (same service + provider). */
+    slotBookedCount?: number;
+    /** For group bookings: max participants allowed for this slot. */
+    slotMaxParticipants?: number;
+    /** For group bookings: slotMaxParticipants - slotBookedCount. */
+    slotRemainingSeats?: number;
+}
+export interface BookingSummary {
+    id: string;
+    meetingLink?: string;
+    /** Copied from the booking so the success UI can show address vs link. */
+    locationType?: ServiceLocationType;
+    meetingInPersonLocation?: string;
+    status: Booking["status"];
+    actionsRequired: Array<BookingActionRequired>;
+}
+//# sourceMappingURL=db.booking.d.ts.map

package/dist/cjs/types/db.booking.d.ts.map

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

package/dist/cjs/types/db.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/types/db.customers.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/types/db.customers.d.ts

@@ -0,0 +1,14 @@
+import { DBRecord } from "./db.js";
+export interface Customer extends DBRecord {
+    name: string;
+    email: string;
+    tenantId: string;
+    /**
+     * Customer ID on JASDK
+     */
+    customerId?: string;
+    /** When true, this customer cannot book or reschedule via the public booking flow */
+    blacklisted?: boolean;
+    recordType: "CUSTOMER";
+}
+//# sourceMappingURL=db.customers.d.ts.map

package/dist/cjs/types/db.customers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.customers.d.ts","sourceRoot":"","sources":["../../../src/types/db.customers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,MAAM,WAAW,QAAS,SAAQ,QAAQ;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;CAC1B"}

package/dist/cjs/types/db.d.ts

@@ -0,0 +1,11 @@
+export interface DBRecord {
+    id?: string;
+    ttl?: number;
+    sortKey?: string;
+    updatedOn?: string;
+    creationDate?: string;
+    schemaVersion?: string;
+    recordType?: DBRecordTypes;
+}
+export type DBRecordTypes = "TAX" | "USER" | "TENANT" | "BOOKING" | "SERVICE" | "CUSTOMER" | "DIRECTORY" | "EMAIL_FLOW" | "NOTIFICATION" | "AVAILABILITY" | "USER_CONFIRMATION" | "USER_LOGIN_SESSION" | "TENANT_GROUPED_STAT" | "MCP_USER_CONTEXT" | "PAYMENT_PENDING" | "OAUTH_CLIENT" | "OAUTH_CODE" | "OAUTH_REFRESH_TOKEN" | "OAUTH_CONSENT" | "WEBHOOK_SUBSCRIPTION" | "PARTNER_API_KEY";
+//# sourceMappingURL=db.d.ts.map

package/dist/cjs/types/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../../src/types/db.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,MAAM,aAAa,GACrB,KAAK,GACL,MAAM,GACN,QAAQ,GACR,SAAS,GACT,SAAS,GACT,UAAU,GACV,WAAW,GACX,YAAY,GACZ,cAAc,GACd,cAAc,GACd,mBAAmB,GACnB,oBAAoB,GACpB,qBAAqB,GACrB,kBAAkB,GAClB,iBAAiB,GACjB,cAAc,GACd,YAAY,GACZ,qBAAqB,GACrB,eAAe,GACf,sBAAsB,GACtB,iBAAiB,CAAC"}

package/dist/cjs/types/db.directory.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/types/db.directory.d.ts

@@ -0,0 +1,38 @@
+import { DBRecord } from "./db.js";
+import { DurationUnit, ServiceCategory, ServiceLocationType, ServiceRatingSummary } from "./db.service.js";
+import type { DiscoverBusinessAddress } from "./discover.js";
+import { BOOKING_PAGE_ICONS } from "../utils/bookingPageIcons.js";
+export interface Directory extends DBRecord {
+    tenantId: string;
+    serviceId: string;
+    data: {
+        business: {
+            name: string;
+            logoUrl: string;
+            accentColor: string;
+            customColor?: string;
+        };
+        /** Optional for backward compatibility with existing records */
+        category?: ServiceCategory;
+        timezone: string;
+        duration: {
+            value: number;
+            unit: DurationUnit;
+        };
+        price: {
+            value: number;
+            currency: string;
+        };
+        url: string;
+        title: string;
+        description: string;
+        iconId: keyof typeof BOOKING_PAGE_ICONS;
+        /** Copied from service when ratings exist (for directory cards) */
+        rating?: ServiceRatingSummary;
+        locationType?: ServiceLocationType;
+        businessAddress?: DiscoverBusinessAddress;
+        tenantSlug?: string;
+    };
+    recordType: "DIRECTORY";
+}
+//# sourceMappingURL=db.directory.d.ts.map

package/dist/cjs/types/db.directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.directory.d.ts","sourceRoot":"","sources":["../../../src/types/db.directory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3G,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,WAAW,SAAU,SAAQ,QAAQ;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE;QACF,QAAQ,EAAE;YACN,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE,MAAM,CAAC;YAChB,WAAW,EAAE,MAAM,CAAC;YACpB,WAAW,CAAC,EAAE,MAAM,CAAC;SACxB,CAAC;QACF,gEAAgE;QAChE,QAAQ,CAAC,EAAE,eAAe,CAAC;QAC3B,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE;YACN,KAAK,EAAE,MAAM,CAAC;YACd,IAAI,EAAE,YAAY,CAAC;SACtB,CAAC;QACF,KAAK,EAAE;YACH,KAAK,EAAE,MAAM,CAAC;YACd,QAAQ,EAAE,MAAM,CAAC;SACpB,CAAC;QACF,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,OAAO,kBAAkB,CAAC;QACxC,mEAAmE;QACnE,MAAM,CAAC,EAAE,oBAAoB,CAAC;QAC9B,YAAY,CAAC,EAAE,mBAAmB,CAAC;QACnC,eAAe,CAAC,EAAE,uBAAuB,CAAC;QAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,UAAU,EAAE,WAAW,CAAC;CAC3B"}

package/dist/cjs/types/db.emailFlow.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/types/db.emailFlow.d.ts

@@ -0,0 +1,29 @@
+import { DBRecord } from "./db.js";
+export type EmailFlowType = "no_show" | "after_care";
+/** API / UI shape for one configurable email automation template */
+export interface EmailFlowTemplate {
+    id: string;
+    name: string;
+    flowType: EmailFlowType;
+    enabled: boolean;
+    subject: string;
+    bodyTemplate: string;
+    sendAfterMinutes: number;
+}
+/**
+ * Persisted email automation template (DynamoDB item).
+ */
+export interface EmailFlow extends DBRecord {
+    recordType: "EMAIL_FLOW";
+    tenantId: string;
+    id: string;
+    /** Label for the dashboard list only */
+    name: string;
+    flowType: EmailFlowType;
+    enabled: boolean;
+    subject: string;
+    /** HTML body with Handlebars variables */
+    bodyTemplate: string;
+    sendAfterMinutes: number;
+}
+//# sourceMappingURL=db.emailFlow.d.ts.map

package/dist/cjs/types/db.emailFlow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.emailFlow.d.ts","sourceRoot":"","sources":["../../../src/types/db.emailFlow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;AAErD,oEAAoE;AACpE,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,QAAQ;IACvC,UAAU,EAAE,YAAY,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;CAC5B"}

package/dist/cjs/types/db.mcpUserContext.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/types/db.mcpUserContext.d.ts

@@ -0,0 +1,29 @@
+import { DBRecord } from "./db.js";
+export interface McpRecentBooking {
+    tenantId: string;
+    serviceId: string;
+    businessName: string;
+    serviceTitle: string;
+    bookedAt: string;
+}
+export interface McpUserLocation {
+    lat?: number;
+    lng?: number;
+    city?: string;
+    state?: string;
+    country?: string;
+    timezone?: string;
+}
+export interface McpUserContext extends DBRecord {
+    recordType: "MCP_USER_CONTEXT";
+    /** Normalized email (lowercase trim) */
+    email: string;
+    name?: string;
+    defaultLocation?: McpUserLocation;
+    /** Boost only on discover — not a scope lock */
+    savedTenantId?: string;
+    savedServiceId?: string;
+    recentBookings?: McpRecentBooking[];
+    linkedAt: string;
+}
+//# sourceMappingURL=db.mcpUserContext.d.ts.map

package/dist/cjs/types/db.mcpUserContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.mcpUserContext.d.ts","sourceRoot":"","sources":["../../../src/types/db.mcpUserContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAe,SAAQ,QAAQ;IAC5C,UAAU,EAAE,kBAAkB,CAAC;IAC/B,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;CACpB"}

package/dist/cjs/types/db.notification.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/types/db.notification.d.ts

@@ -0,0 +1,27 @@
+import { DBRecord } from "./db.js";
+export type NotificationType = "newBookingConfirmed" | "bookingCancelled" | "bookingPendingApproval" | "bookingReserved" | "bookingDeleted" | "bookingReminder" | "bookingUpdated" | "integrationDisconnected";
+export type IntegrationDisconnectReason = "oauth_revoked" | "user_disconnect";
+export type IntegrationNotificationKey = "google" | "microsoft" | "zoom";
+export interface Notification extends DBRecord {
+    recordType: "NOTIFICATION";
+    tenantId: string;
+    userId: string;
+    type: NotificationType;
+    status: "read" | "unread";
+    sendEmail: boolean;
+    group: "notification" | "announcement";
+    titleKey: string;
+    messageKey: string;
+    actionUrl?: string;
+    actionLabelKey?: string;
+    bookingSortKey?: string;
+    serviceId?: string;
+    customerId?: string;
+    serviceProviderId?: string;
+    priority?: "info" | "low" | "medium" | "high";
+    readOn?: string;
+    expiresOn?: string;
+    metadata: Record<string, string | number | boolean>;
+    groupReminderSentAt?: string;
+}
+//# sourceMappingURL=db.notification.d.ts.map

package/dist/cjs/types/db.notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.notification.d.ts","sourceRoot":"","sources":["../../../src/types/db.notification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnC,MAAM,MAAM,gBAAgB,GACtB,qBAAqB,GACrB,kBAAkB,GAClB,wBAAwB,GACxB,iBAAiB,GACjB,gBAAgB,GAChB,iBAAiB,GACjB,gBAAgB,GAChB,yBAAyB,CAAC;AAEhC,MAAM,MAAM,2BAA2B,GAAG,eAAe,GAAG,iBAAiB,CAAC;AAC9E,MAAM,MAAM,0BAA0B,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;AAEzE,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC1C,UAAU,EAAE,cAAc,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IAGf,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IAEnB,KAAK,EAAE,cAAc,GAAG,cAAc,CAAC;IAGvC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IAGnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IAInB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAG3B,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAEpD,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAChC"}

package/dist/cjs/types/db.oauth.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/types/db.oauth.d.ts

@@ -0,0 +1,55 @@
+import { DBRecord } from "./db.js";
+import type { OAuthScope } from "./oauthScopes.js";
+export interface OAuthClient extends DBRecord {
+    recordType: "OAUTH_CLIENT";
+    id: string;
+    userId: string;
+    name: string;
+    clientSecretHash: string;
+    redirectUris: string[];
+    allowedScopes: OAuthScope[];
+}
+export interface OAuthConsent extends DBRecord {
+    recordType: "OAUTH_CONSENT";
+    id: string;
+    userId: string;
+    clientId: string;
+    tenantId: string;
+    scopes: OAuthScope[];
+    grantedAt: string;
+}
+export interface OAuthAuthorizationCode extends DBRecord {
+    recordType: "OAUTH_CODE";
+    id: string;
+    code: string;
+    userId: string;
+    clientId: string;
+    tenantId: string;
+    scopes: OAuthScope[];
+    redirectUri: string;
+    codeChallenge: string;
+    codeChallengeMethod: "S256";
+    expiresAt: string;
+}
+export interface OAuthRefreshToken extends DBRecord {
+    recordType: "OAUTH_REFRESH_TOKEN";
+    id: string;
+    tokenHash: string;
+    userId: string;
+    clientId: string;
+    tenantId: string;
+    scopes: OAuthScope[];
+    expiresAt: string;
+}
+export interface PartnerAccessTokenClaims {
+    sub: string;
+    client_id: string;
+    tenant_id: string;
+    scope: string;
+    aud: string;
+    iss: string;
+    exp: number;
+    iat: number;
+    jti: string;
+}
+//# sourceMappingURL=db.oauth.d.ts.map

package/dist/cjs/types/db.oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.oauth.d.ts","sourceRoot":"","sources":["../../../src/types/db.oauth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,WAAY,SAAQ,QAAQ;IAC3C,UAAU,EAAE,cAAc,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,UAAU,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC5C,UAAU,EAAE,eAAe,CAAC;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAuB,SAAQ,QAAQ;IACtD,UAAU,EAAE,YAAY,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAkB,SAAQ,QAAQ;IACjD,UAAU,EAAE,qBAAqB,CAAC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb"}

package/dist/cjs/types/db.partnerApiKey.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/types/db.partnerApiKey.d.ts

@@ -0,0 +1,15 @@
+import { DBRecord } from "./db.js";
+import type { OAuthScope } from "./oauthScopes.js";
+export interface PartnerApiKey extends DBRecord {
+    recordType: "PARTNER_API_KEY";
+    id: string;
+    tenantId: string;
+    userId: string;
+    name: string;
+    keyPrefix: string;
+    keyHash: string;
+    allowedScopes: OAuthScope[];
+    lastUsedAt?: string;
+    revokedAt?: string;
+}
+//# sourceMappingURL=db.partnerApiKey.d.ts.map

package/dist/cjs/types/db.partnerApiKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.partnerApiKey.d.ts","sourceRoot":"","sources":["../../../src/types/db.partnerApiKey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,aAAc,SAAQ,QAAQ;IAC7C,UAAU,EAAE,iBAAiB,CAAC;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,UAAU,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/cjs/types/db.paymentPending.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/types/db.paymentPending.d.ts

@@ -0,0 +1,16 @@
+import { DBRecord } from "./db.js";
+import type { Booking } from "./db.booking.js";
+/** Short-lived lookup for payment provider return URLs (Paystack reference, Stripe payment_intent). */
+export interface PaymentPending extends DBRecord {
+    recordType: "PAYMENT_PENDING";
+    tenantId: string;
+    bookingId: string;
+    serviceId: string;
+    customerId: string;
+    type: keyof Booking["payments"];
+    provider: string;
+    /** Primary payment attempt id (Paystack reference / JASDK attempt id). */
+    paymentAttemptId: string;
+    returnUrl: string;
+}
+//# sourceMappingURL=db.paymentPending.d.ts.map

package/dist/cjs/types/db.paymentPending.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.paymentPending.d.ts","sourceRoot":"","sources":["../../../src/types/db.paymentPending.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,uGAAuG;AACvG,MAAM,WAAW,cAAe,SAAQ,QAAQ;IAC5C,UAAU,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACrB"}

package/dist/cjs/types/db.service.cjs

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SERVICE_REMINDER_OFFSETS = void 0;
+/** All valid reminder lead times before the appointment (relative to start) */
+exports.SERVICE_REMINDER_OFFSETS = [
+    "15_minutes",
+    "30_minutes",
+    "1_hour",
+    "3_hours",
+    "6_hours",
+    "12_hours",
+    "1_day",
+    "1_week",
+    "1_month",
+];