@wildo-ai/saas-models 1.0.1

package/dist/esm/config/frontend/onboarding.shared.schemas.js

@@ -0,0 +1,391 @@
+import { z } from 'zod';
+import { createSchemaFamily } from '../../resources/utils/schema-family-builder.utils.js';
+/** ──────────────────────────────────────────────────────────────
+ * OnboardingView – Core primitives
+ * ────────────────────────────────────────────────────────────── */
+/** Onboarding Trigger Types - when/how onboarding flows are activated */
+export const OnboardingTriggerType = {
+    /** Triggered when user first visits the app */
+    FIRST_VISIT: 'first-visit',
+    /** Triggered when a specific URL/route is visited */
+    ROUTE_MATCH: 'route-match',
+    /** Triggered by a specific event */
+    EVENT: 'event',
+    /** Triggered manually (via API or user action) */
+    MANUAL: 'manual',
+    /** Triggered after a specific time delay */
+    DELAYED: 'delayed',
+};
+/** Onboarding Element Types */
+export var OnboardingElementType;
+(function (OnboardingElementType) {
+    OnboardingElementType["CHECKLIST"] = "checklist";
+    OnboardingElementType["CHECKLIST_ITEM"] = "checklist-item";
+    OnboardingElementType["TOUR"] = "tour";
+    OnboardingElementType["TOOLTIP"] = "tooltip";
+    OnboardingElementType["MODAL"] = "modal";
+    OnboardingElementType["BANNER"] = "banner";
+    OnboardingElementType["ANNOUNCEMENT"] = "announcement";
+    OnboardingElementType["BADGE"] = "badge";
+    OnboardingElementType["CARD"] = "card";
+    OnboardingElementType["SURVEY"] = "survey";
+})(OnboardingElementType || (OnboardingElementType = {}));
+/** Onboarding Status */
+export var OnboardingStatus;
+(function (OnboardingStatus) {
+    OnboardingStatus["NOT_STARTED"] = "not-started";
+    OnboardingStatus["IN_PROGRESS"] = "in-progress";
+    OnboardingStatus["COMPLETED"] = "completed";
+    OnboardingStatus["SKIPPED"] = "skipped";
+    OnboardingStatus["DISMISSED"] = "dismissed";
+})(OnboardingStatus || (OnboardingStatus = {}));
+/** Tour Step Placement */
+export var TourStepPlacement;
+(function (TourStepPlacement) {
+    TourStepPlacement["TOP"] = "top";
+    TourStepPlacement["BOTTOM"] = "bottom";
+    TourStepPlacement["LEFT"] = "left";
+    TourStepPlacement["RIGHT"] = "right";
+    TourStepPlacement["CENTER"] = "center";
+})(TourStepPlacement || (TourStepPlacement = {}));
+/** Onboarding Position */
+export var OnboardingPosition;
+(function (OnboardingPosition) {
+    OnboardingPosition["CENTER"] = "center";
+    OnboardingPosition["TOP"] = "top";
+    OnboardingPosition["BOTTOM"] = "bottom";
+    OnboardingPosition["LEFT"] = "left";
+    OnboardingPosition["RIGHT"] = "right";
+})(OnboardingPosition || (OnboardingPosition = {}));
+/** Onboarding Variant */
+export var OnboardingVariant;
+(function (OnboardingVariant) {
+    OnboardingVariant["INFO"] = "info";
+    OnboardingVariant["SUCCESS"] = "success";
+    OnboardingVariant["WARNING"] = "warning";
+    OnboardingVariant["ERROR"] = "error";
+})(OnboardingVariant || (OnboardingVariant = {}));
+/** Badge Variant */
+export var OnboardingBadgeVariant;
+(function (OnboardingBadgeVariant) {
+    OnboardingBadgeVariant["DEFAULT"] = "default";
+    OnboardingBadgeVariant["PRIMARY"] = "primary";
+    OnboardingBadgeVariant["SECONDARY"] = "secondary";
+    OnboardingBadgeVariant["SUCCESS"] = "success";
+    OnboardingBadgeVariant["WARNING"] = "warning";
+    OnboardingBadgeVariant["ERROR"] = "error";
+})(OnboardingBadgeVariant || (OnboardingBadgeVariant = {}));
+/** Card Variant */
+export var OnboardingCardVariant;
+(function (OnboardingCardVariant) {
+    OnboardingCardVariant["DEFAULT"] = "default";
+    OnboardingCardVariant["OUTLINED"] = "outlined";
+    OnboardingCardVariant["ELEVATED"] = "elevated";
+})(OnboardingCardVariant || (OnboardingCardVariant = {}));
+/** Survey Question Type */
+export var OnboardingSurveyQuestionType;
+(function (OnboardingSurveyQuestionType) {
+    OnboardingSurveyQuestionType["TEXT"] = "text";
+    OnboardingSurveyQuestionType["RADIO"] = "radio";
+    OnboardingSurveyQuestionType["CHECKBOX"] = "checkbox";
+    OnboardingSurveyQuestionType["RATING"] = "rating";
+    OnboardingSurveyQuestionType["TEXTAREA"] = "textarea";
+    OnboardingSurveyQuestionType["SINGLE_CHOICE"] = "single-choice";
+})(OnboardingSurveyQuestionType || (OnboardingSurveyQuestionType = {}));
+/** Banner Position */
+export var OnboardingBannerPosition;
+(function (OnboardingBannerPosition) {
+    OnboardingBannerPosition["TOP"] = "top";
+    OnboardingBannerPosition["BOTTOM"] = "bottom";
+})(OnboardingBannerPosition || (OnboardingBannerPosition = {}));
+/** ──────────────────────────────────────────────────────────────
+ * OnboardingView – Schemas
+ * ────────────────────────────────────────────────────────────── */
+/** Onboarding Trigger Conditions Schema */
+export const OnboardingTriggerConditionsSchema = z.object({
+    /** Only trigger for users who haven't completed this onboarding before */
+    newUsersOnly: z.boolean().default(true),
+    /** Only trigger once per user (persisted via user preferences) */
+    triggerOnce: z.boolean().default(true),
+    /** Required user roles to trigger this onboarding */
+    requiredRoles: z.array(z.string()).optional(),
+});
+/** Onboarding Trigger Schema - defines when/how an onboarding or guidance flow is activated.
+ *  Important runtime note:
+ *  - `EVENT` is the only trigger type evaluated by the backend operation pipeline.
+ *  - `FIRST_VISIT`, `ROUTE_MATCH`, `DELAYED`, and `MANUAL` are frontend/manual concerns. */
+export const OnboardingTriggerSchema = z.object({
+    /** The type of trigger that activates this onboarding */
+    type: z.enum(OnboardingTriggerType).default(OnboardingTriggerType.FIRST_VISIT),
+    /** For ROUTE_MATCH: Route pattern to match (regex or glob) */
+    routePattern: z.string().optional(),
+    /** For EVENT: Event name to listen for */
+    eventName: z.string().optional(),
+    /** For DELAYED: Delay in milliseconds before triggering */
+    delayMs: z.number().positive().optional(),
+    /** Conditions that must be met for the trigger to activate */
+    conditions: OnboardingTriggerConditionsSchema.optional(),
+});
+/** Onboarding View Options Schema */
+export const OnboardingViewOptionsSchema = z.object({
+    showProgress: z.boolean().default(true),
+    allowDismiss: z.boolean().default(true),
+    persistState: z.boolean().default(true),
+    autoStart: z.boolean().default(false),
+    allowSkip: z.boolean().default(true),
+    className: z.string().optional(),
+});
+/** ──────────────────────────────────────────────────────────────
+ * OnboardingView – Reusable Config Schemas
+ *
+ * These config schemas define the type-specific properties for each
+ * onboarding element, separated from base fields (ref, type, title, etc.)
+ * for reuse across packages.
+ * ────────────────────────────────────────────────────────────── */
+/** Tour Step Schema */
+export const OnboardingTourStepSchema = z.object({
+    ref: z.string(),
+    title: z.string(),
+    description: z.string().optional(),
+    order: z.number().int().nonnegative(),
+    placement: z.enum(TourStepPlacement).default(TourStepPlacement.BOTTOM),
+    targetSelector: z.string().optional(),
+    /** Optional resource field name this step targets — resolved to [data-guidance-field="..."] at render time */
+    targetField: z.string().optional(),
+    content: z.string().optional(),
+    imageUrl: z.url().optional(),
+    videoUrl: z.url().optional(),
+});
+/** Survey Question Schema */
+export const OnboardingSurveyQuestionSchema = z.object({
+    id: z.string(),
+    ref: z.string().optional(),
+    question: z.string(),
+    type: z.enum(OnboardingSurveyQuestionType),
+    options: z.array(z.object({ ref: z.string(), value: z.string().optional() })).optional(),
+    required: z.boolean().default(false),
+});
+/** Checklist Config Schema - type-specific fields only */
+export const OnboardingChecklistConfigSchema = z.object({
+    showProgress: z.boolean().default(true),
+});
+/** Checklist Item Config Schema - type-specific fields only */
+export const OnboardingChecklistItemConfigSchema = z.object({
+    actionLabel: z.string().optional(),
+    actionRef: z.string().optional(),
+});
+/** Tour Config Schema - type-specific fields only */
+export const OnboardingTourConfigSchema = z.object({
+    steps: z.array(OnboardingTourStepSchema).default([]),
+    autoStart: z.boolean().default(false),
+    allowSkip: z.boolean().default(true),
+});
+/** Tooltip Config Schema - type-specific fields only */
+export const OnboardingTooltipConfigSchema = z.object({
+    targetSelector: z.string(),
+    placement: z.enum(TourStepPlacement).default(TourStepPlacement.BOTTOM),
+    content: z.string(),
+    showOnce: z.boolean().default(true),
+});
+/** Modal Config Schema - type-specific fields only */
+export const OnboardingModalConfigSchema = z.object({
+    content: z.string(),
+    imageUrl: z.url().optional(),
+    videoUrl: z.url().optional(),
+    ctaText: z.string().optional(),
+    ctaAction: z.string().optional(),
+    dismissible: z.boolean().default(true),
+});
+/** Banner Config Schema - type-specific fields only */
+export const OnboardingBannerConfigSchema = z.object({
+    content: z.string(),
+    variant: z.enum(OnboardingVariant).default(OnboardingVariant.INFO),
+    dismissible: z.boolean().default(true),
+    position: z.enum(OnboardingBannerPosition).default(OnboardingBannerPosition.TOP),
+    actionLabel: z.string().optional(),
+    actionRef: z.string().optional(),
+});
+/** Announcement Config Schema - type-specific fields only */
+export const OnboardingAnnouncementConfigSchema = z.object({
+    content: z.string(),
+    variant: z.enum(OnboardingVariant).default(OnboardingVariant.INFO),
+    dismissible: z.boolean().default(true),
+    icon: z.string().optional(),
+    actionLabel: z.string().optional(),
+    actionRef: z.string().optional(),
+});
+/** Badge Config Schema - type-specific fields only */
+export const OnboardingBadgeConfigSchema = z.object({
+    content: z.string().optional(),
+    icon: z.string().optional(),
+    variant: z.enum(OnboardingBadgeVariant).default(OnboardingBadgeVariant.DEFAULT),
+    color: z.string().optional(),
+    unlocked: z.boolean().default(false),
+    actionLabel: z.string().optional(),
+    actionRef: z.string().optional(),
+});
+/** Card Config Schema - type-specific fields only */
+export const OnboardingCardConfigSchema = z.object({
+    content: z.string(),
+    icon: z.string().optional(),
+    imageUrl: z.url().optional(),
+    variant: z.enum(OnboardingCardVariant).default(OnboardingCardVariant.DEFAULT),
+    actionLabel: z.string().optional(),
+    actionRef: z.string().optional(),
+});
+/** Survey Config Schema - type-specific fields only */
+export const OnboardingSurveyConfigSchema = z.object({
+    questions: z.array(OnboardingSurveyQuestionSchema).default([]),
+    submitLabel: z.string().optional(),
+    allowSkip: z.boolean().default(true),
+});
+/** ──────────────────────────────────────────────────────────────
+ * OnboardingView – Element Base Schema (for reuse)
+ *
+ * Contains common fields shared by all onboarding element types.
+ * Extracted for reuse across packages.
+ * ────────────────────────────────────────────────────────────── */
+export const OnboardingElementBaseSchema = z.object({
+    /** Unique reference for this element */
+    ref: z.string(),
+    /** Element type discriminator */
+    type: z.enum(OnboardingElementType),
+    /** Display title */
+    title: z.string(),
+    /** Optional description */
+    description: z.string().optional(),
+    /** Current status */
+    status: z.enum(OnboardingStatus).default(OnboardingStatus.NOT_STARTED),
+    /** Display order */
+    order: z.number().int().nonnegative(),
+    /** Optional resource field name this element targets — resolved to a CSS selector [data-guidance-field="..."] at render time */
+    targetField: z.string().optional(),
+});
+/** ──────────────────────────────────────────────────────────────
+ * OnboardingView – Element Schema Family
+ *
+ * Uses createSchemaFamily for discriminated union with automatic
+ * inheritance configuration generation. Each variant extends the
+ * base with type-specific fields from config schemas.
+ * ────────────────────────────────────────────────────────────── */
+export const OnboardingElementSchemaFamily = createSchemaFamily({
+    base: OnboardingElementBaseSchema,
+    discriminator: {
+        field: 'type',
+        baseValues: [], // All element types have variants
+    },
+    variants: {
+        [OnboardingElementType.CHECKLIST]: {
+            extend: z.object({
+                /** References to checklist item elements */
+                items: z.array(z.string()),
+                ...OnboardingChecklistConfigSchema.shape,
+            }),
+        },
+        [OnboardingElementType.CHECKLIST_ITEM]: {
+            extend: z.object({
+                /** Whether this item is completed */
+                completed: z.boolean().default(false),
+                ...OnboardingChecklistItemConfigSchema.shape,
+            }),
+        },
+        [OnboardingElementType.TOUR]: {
+            extend: z.object({
+                /** Current step index in the tour */
+                currentStepIndex: z.number().int().nonnegative().default(0),
+                ...OnboardingTourConfigSchema.shape,
+            }),
+        },
+        [OnboardingElementType.TOOLTIP]: {
+            extend: z.object({
+                ...OnboardingTooltipConfigSchema.shape,
+            }),
+        },
+        [OnboardingElementType.MODAL]: {
+            extend: z.object({
+                ...OnboardingModalConfigSchema.shape,
+            }),
+        },
+        [OnboardingElementType.BANNER]: {
+            extend: z.object({
+                ...OnboardingBannerConfigSchema.shape,
+            }),
+        },
+        [OnboardingElementType.ANNOUNCEMENT]: {
+            extend: z.object({
+                ...OnboardingAnnouncementConfigSchema.shape,
+            }),
+        },
+        [OnboardingElementType.BADGE]: {
+            extend: z.object({
+                ...OnboardingBadgeConfigSchema.shape,
+            }),
+        },
+        [OnboardingElementType.CARD]: {
+            extend: z.object({
+                ...OnboardingCardConfigSchema.shape,
+            }),
+        },
+        [OnboardingElementType.SURVEY]: {
+            extend: z.object({
+                ...OnboardingSurveyConfigSchema.shape,
+            }),
+        },
+    },
+});
+/**
+ * Schema family with full access to base, variants, union, and inheritenceSchemaDefinition.
+ * Use for resource configuration and cross-package integration.
+ * Access variants via: OnboardingElementSchemaFamily.variants[OnboardingElementType.CHECKLIST]
+ */
+/**
+ * Typed discriminated union of all onboarding element types.
+ * Use this for runtime validation and type inference.
+ * Note: Created separately from SchemaFamily to preserve full TypeScript type inference.
+ */
+export const OnboardingElementSchema = z.discriminatedUnion('type', [
+    OnboardingElementBaseSchema.extend({
+        type: z.literal(OnboardingElementType.CHECKLIST),
+        items: z.array(z.string()),
+        ...OnboardingChecklistConfigSchema.shape,
+    }),
+    OnboardingElementBaseSchema.extend({
+        type: z.literal(OnboardingElementType.CHECKLIST_ITEM),
+        completed: z.boolean().default(false),
+        ...OnboardingChecklistItemConfigSchema.shape,
+    }),
+    OnboardingElementBaseSchema.extend({
+        type: z.literal(OnboardingElementType.TOUR),
+        currentStepIndex: z.number().int().nonnegative().default(0),
+        ...OnboardingTourConfigSchema.shape,
+    }),
+    OnboardingElementBaseSchema.extend({
+        type: z.literal(OnboardingElementType.TOOLTIP),
+        ...OnboardingTooltipConfigSchema.shape,
+    }),
+    OnboardingElementBaseSchema.extend({
+        type: z.literal(OnboardingElementType.MODAL),
+        ...OnboardingModalConfigSchema.shape,
+    }),
+    OnboardingElementBaseSchema.extend({
+        type: z.literal(OnboardingElementType.BANNER),
+        ...OnboardingBannerConfigSchema.shape,
+    }),
+    OnboardingElementBaseSchema.extend({
+        type: z.literal(OnboardingElementType.ANNOUNCEMENT),
+        ...OnboardingAnnouncementConfigSchema.shape,
+    }),
+    OnboardingElementBaseSchema.extend({
+        type: z.literal(OnboardingElementType.BADGE),
+        ...OnboardingBadgeConfigSchema.shape,
+    }),
+    OnboardingElementBaseSchema.extend({
+        type: z.literal(OnboardingElementType.CARD),
+        ...OnboardingCardConfigSchema.shape,
+    }),
+    OnboardingElementBaseSchema.extend({
+        type: z.literal(OnboardingElementType.SURVEY),
+        ...OnboardingSurveyConfigSchema.shape,
+    }),
+]);
+//# sourceMappingURL=onboarding.shared.schemas.js.map

package/dist/esm/config/frontend/onboarding.shared.schemas.js.map

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

package/dist/esm/config/postgresql.shared.schemas.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared PostgreSQL connection semantics.
+ *
+ * These values are used across backend runtime code and platform/bootstrap
+ * tooling, so they must live in a neutral shared package instead of either
+ * side depending on the other for pure database connection meaning.
+ */
+/**
+ * PostgreSQL SSL modes for connection security.
+ */
+export declare enum PostgreSQLSSLMode {
+    DISABLE = "disable",
+    REQUIRE = "require",
+    VERIFY_CA = "verify-ca",
+    VERIFY_FULL = "verify-full"
+}
+/**
+ * Build a PostgreSQL connection URL from individual connection components.
+ */
+export declare function buildPostgreSQLConnectionUrl(params: {
+    host: string;
+    port?: number;
+    database: string;
+    username: string;
+    password: string;
+    sslMode?: PostgreSQLSSLMode;
+    schema?: string;
+}): string;
+//# sourceMappingURL=postgresql.shared.schemas.d.ts.map

package/dist/esm/config/postgresql.shared.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgresql.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/config/postgresql.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,oBAAY,iBAAiB;IAC3B,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,WAAW,gBAAgB;CAC5B;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAoBT"}

package/dist/esm/config/postgresql.shared.schemas.js

@@ -0,0 +1,37 @@
+/**
+ * Shared PostgreSQL connection semantics.
+ *
+ * These values are used across backend runtime code and platform/bootstrap
+ * tooling, so they must live in a neutral shared package instead of either
+ * side depending on the other for pure database connection meaning.
+ */
+/**
+ * PostgreSQL SSL modes for connection security.
+ */
+export var PostgreSQLSSLMode;
+(function (PostgreSQLSSLMode) {
+    PostgreSQLSSLMode["DISABLE"] = "disable";
+    PostgreSQLSSLMode["REQUIRE"] = "require";
+    PostgreSQLSSLMode["VERIFY_CA"] = "verify-ca";
+    PostgreSQLSSLMode["VERIFY_FULL"] = "verify-full";
+})(PostgreSQLSSLMode || (PostgreSQLSSLMode = {}));
+/**
+ * Build a PostgreSQL connection URL from individual connection components.
+ */
+export function buildPostgreSQLConnectionUrl(params) {
+    const { host, port = 5432, database, username, password, sslMode, schema } = params;
+    const encodedPassword = encodeURIComponent(password);
+    let url = `postgresql://${username}:${encodedPassword}@${host}:${port}/${database}`;
+    const queryParams = [];
+    if (sslMode) {
+        queryParams.push(`sslmode=${sslMode}`);
+    }
+    if (schema) {
+        queryParams.push(`schema=${schema}`);
+    }
+    if (queryParams.length > 0) {
+        url += `?${queryParams.join('&')}`;
+    }
+    return url;
+}
+//# sourceMappingURL=postgresql.shared.schemas.js.map

package/dist/esm/config/postgresql.shared.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgresql.shared.schemas.js","sourceRoot":"","sources":["../../../src/config/postgresql.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,wCAAmB,CAAA;IACnB,wCAAmB,CAAA;IACnB,4CAAuB,CAAA;IACvB,gDAA2B,CAAA;AAC7B,CAAC,EALW,iBAAiB,KAAjB,iBAAiB,QAK5B;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAQ5C;IACC,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEpF,MAAM,eAAe,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAErD,IAAI,GAAG,GAAG,gBAAgB,QAAQ,IAAI,eAAe,IAAI,IAAI,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC;IAEpF,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,IAAI,OAAO,EAAE,CAAC;QACZ,WAAW,CAAC,IAAI,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,MAAM,EAAE,CAAC;QACX,WAAW,CAAC,IAAI,CAAC,UAAU,MAAM,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,GAAG,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACrC,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/esm/crdt/crdt-merge.shared.utils.d.ts

@@ -0,0 +1,50 @@
+import type { FieldMetaEntry } from '../requests/websocket.shared.schemas.js';
+/**
+ * Perspective-neutral CRDT resolution outcome.
+ * - INCOMING: the candidate/challenger timestamp wins
+ * - EXISTING: the incumbent/current timestamp wins
+ *
+ * Backend interprets: INCOMING = client wins, EXISTING = server wins.
+ * Frontend interprets: INCOMING = remote wins, EXISTING = local wins.
+ */
+export declare enum CrdtResolutionWinner {
+    INCOMING = "INCOMING",
+    EXISTING = "EXISTING"
+}
+/**
+ * LWW field-level winner determination.
+ * Tie-break: EXISTING wins on equal timestamps (strict `>` required for INCOMING to win).
+ * This is the single source of truth for the LWW tie-break policy.
+ */
+export declare function lwwFieldWinner(incomingTs: number, existingTs: number): CrdtResolutionWinner;
+/**
+ * Monotonic timestamp guard.
+ * Ensures the new timestamp is always strictly greater than the previous one,
+ * even if the system clock jumped backward (NTP step, VM migration).
+ */
+export declare function nextMonotonicTimestamp(now: number, previousTs: number): number;
+/**
+ * Determines whether an update contains only CRDT-managed fields.
+ * CRDT-only updates are safely retriable after version conflicts because
+ * field-level LWW merge can resolve them without data loss.
+ *
+ * @param userDataKeys — keys from the $set payload, excluding engine fields (those starting with `_`)
+ * @param crdtFieldSet — set of field names marked with isCRDT() on the resource schema
+ */
+export declare function isCrdtOnlyUpdate(userDataKeys: string[], crdtFieldSet: ReadonlySet<string>): boolean;
+/**
+ * Defensive type guard for _field_meta values read from storage or network.
+ * Returns a safe Record<string, FieldMetaEntry> even if the input is corrupted
+ * (null, undefined, string, number, array). Prevents garbage spread via `{ ...corruptedValue }`.
+ */
+export declare function sanitizeFieldMeta(rawMeta: unknown): Record<string, FieldMetaEntry>;
+/**
+ * Extracts the set of top-level field names marked with the `isCRDT()` decorator
+ * from a Zod object schema. Only top-level fields are supported for field-level
+ * CRDT merge — nested CRDT markers are detected and warned about.
+ *
+ * @param schema — a Zod object schema (must have `.shape`)
+ * @param warnOnNested — if true, logs a warning when nested fields have isCRDT() (default: true)
+ */
+export declare function extractCrdtFieldNames(schema: unknown, warnOnNested?: boolean): ReadonlySet<string>;
+//# sourceMappingURL=crdt-merge.shared.utils.d.ts.map

package/dist/esm/crdt/crdt-merge.shared.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crdt-merge.shared.utils.d.ts","sourceRoot":"","sources":["../../../src/crdt/crdt-merge.shared.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAG3E;;;;;;;GAOG;AACH,oBAAY,oBAAoB;IAC9B,QAAQ,aAAa;IACrB,QAAQ,aAAa;CACtB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAE3F;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAEnG;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAUlF;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,GAAE,OAAc,GAAG,WAAW,CAAC,MAAM,CAAC,CAqBxG"}

package/dist/esm/crdt/crdt-merge.shared.utils.js

@@ -0,0 +1,120 @@
+import { FieldMetaEntrySchema } from '../requests/websocket.shared.schemas.js';
+import { SCHEMA_METADATA, ZodDecorator } from '@wildo-ai/zod-decorators';
+/**
+ * Perspective-neutral CRDT resolution outcome.
+ * - INCOMING: the candidate/challenger timestamp wins
+ * - EXISTING: the incumbent/current timestamp wins
+ *
+ * Backend interprets: INCOMING = client wins, EXISTING = server wins.
+ * Frontend interprets: INCOMING = remote wins, EXISTING = local wins.
+ */
+export var CrdtResolutionWinner;
+(function (CrdtResolutionWinner) {
+    CrdtResolutionWinner["INCOMING"] = "INCOMING";
+    CrdtResolutionWinner["EXISTING"] = "EXISTING";
+})(CrdtResolutionWinner || (CrdtResolutionWinner = {}));
+/**
+ * LWW field-level winner determination.
+ * Tie-break: EXISTING wins on equal timestamps (strict `>` required for INCOMING to win).
+ * This is the single source of truth for the LWW tie-break policy.
+ */
+export function lwwFieldWinner(incomingTs, existingTs) {
+    return incomingTs > existingTs ? CrdtResolutionWinner.INCOMING : CrdtResolutionWinner.EXISTING;
+}
+/**
+ * Monotonic timestamp guard.
+ * Ensures the new timestamp is always strictly greater than the previous one,
+ * even if the system clock jumped backward (NTP step, VM migration).
+ */
+export function nextMonotonicTimestamp(now, previousTs) {
+    return Math.max(now, previousTs + 1);
+}
+/**
+ * Determines whether an update contains only CRDT-managed fields.
+ * CRDT-only updates are safely retriable after version conflicts because
+ * field-level LWW merge can resolve them without data loss.
+ *
+ * @param userDataKeys — keys from the $set payload, excluding engine fields (those starting with `_`)
+ * @param crdtFieldSet — set of field names marked with isCRDT() on the resource schema
+ */
+export function isCrdtOnlyUpdate(userDataKeys, crdtFieldSet) {
+    return crdtFieldSet.size > 0 && userDataKeys.every(k => crdtFieldSet.has(k));
+}
+/**
+ * Defensive type guard for _field_meta values read from storage or network.
+ * Returns a safe Record<string, FieldMetaEntry> even if the input is corrupted
+ * (null, undefined, string, number, array). Prevents garbage spread via `{ ...corruptedValue }`.
+ */
+export function sanitizeFieldMeta(rawMeta) {
+    if (rawMeta != null && typeof rawMeta === 'object' && !Array.isArray(rawMeta)) {
+        return Object.fromEntries(Object.entries(rawMeta).flatMap(([fieldName, candidate]) => {
+            const parsed = FieldMetaEntrySchema.safeParse(candidate);
+            return parsed.success ? [[fieldName, parsed.data]] : [];
+        }));
+    }
+    return {};
+}
+/**
+ * Extracts the set of top-level field names marked with the `isCRDT()` decorator
+ * from a Zod object schema. Only top-level fields are supported for field-level
+ * CRDT merge — nested CRDT markers are detected and warned about.
+ *
+ * @param schema — a Zod object schema (must have `.shape`)
+ * @param warnOnNested — if true, logs a warning when nested fields have isCRDT() (default: true)
+ */
+export function extractCrdtFieldNames(schema, warnOnNested = true) {
+    const names = new Set();
+    if (!schema || typeof schema !== 'object' || !('shape' in schema))
+        return names;
+    const shape = schema.shape;
+    if (!shape || typeof shape !== 'object')
+        return names;
+    for (const [fieldName, fieldSchema] of Object.entries(shape)) {
+        const meta = fieldSchema?.[SCHEMA_METADATA];
+        if (meta?.[ZodDecorator.IS_CRDT]) {
+            names.add(fieldName);
+        }
+        if (warnOnNested) {
+            const nestedShape = _unwrapToShape(fieldSchema);
+            if (nestedShape) {
+                _warnNestedCrdtFields(nestedShape, fieldName);
+            }
+        }
+    }
+    return names;
+}
+/**
+ * Peels off common Zod wrappers (optional, nullable, default, readonly, branded, piped, etc.)
+ * until it finds a ZodObject with `.shape`, or gives up after 10 layers.
+ */
+function _unwrapToShape(schema) {
+    let current = schema;
+    for (let i = 0; i < 10; i++) {
+        if (!current || typeof current !== 'object')
+            return null;
+        if ('shape' in current && typeof current.shape === 'object') {
+            return current.shape;
+        }
+        const inner = current?._def?.innerType ?? current?._def?.schema;
+        if (!inner)
+            return null;
+        current = inner;
+    }
+    return null;
+}
+function _warnNestedCrdtFields(shape, parentPath) {
+    if (!shape || typeof shape !== 'object')
+        return;
+    for (const [fieldName, fieldSchema] of Object.entries(shape)) {
+        const path = `${parentPath}.${fieldName}`;
+        const meta = fieldSchema?.[SCHEMA_METADATA];
+        if (meta?.[ZodDecorator.IS_CRDT]) {
+            console.warn(`isCRDT() on nested field '${path}' is not supported. Only top-level fields support field-level CRDT merge.`);
+        }
+        const nestedShape = _unwrapToShape(fieldSchema);
+        if (nestedShape) {
+            _warnNestedCrdtFields(nestedShape, path);
+        }
+    }
+}
+//# sourceMappingURL=crdt-merge.shared.utils.js.map