@ekairos/domain 1.8.3 → 1.8.5-beta.0

package/dist/__type_tests__/domain-builder.typecheck.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=domain-builder.typecheck.d.ts.map

package/dist/__type_tests__/domain-builder.typecheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-builder.typecheck.d.ts","sourceRoot":"","sources":["../../src/__type_tests__/domain-builder.typecheck.ts"],"names":[],"mappings":""}

package/dist/__type_tests__/domain-builder.typecheck.js

@@ -0,0 +1,211 @@
+"use strict";
+// Type tests for domain builder with dependsOn
+// These should fail initially, then pass after implementation
+Object.defineProperty(exports, "__esModule", { value: true });
+const __1 = require("..");
+const core_1 = require("@instantdb/core");
+// Base entities ($users, $files) are automatically included by domain builder
+// Core domain (hosts organizations)
+const otherDomain = (0, __1.domain)({
+    entities: {
+        organizations: core_1.i.entity({
+            clerkOrgId: core_1.i.string().indexed().unique(),
+            timezone: core_1.i.string().optional(),
+        }),
+    },
+    links: {},
+    rooms: {},
+});
+// OK: cross-domain links after includes (runtime automatically merges entities)
+const management = (0, __1.domain)("management")
+    .includes(otherDomain)
+    .schema({
+    entities: {
+        management_projects: core_1.i.entity({
+            name: core_1.i.string(),
+            createdAt: core_1.i.date(),
+            updatedAt: core_1.i.date(),
+            description: core_1.i.string().optional(),
+            linearProjectId: core_1.i.string().optional(),
+        }),
+        management_tasks: core_1.i.entity({
+            title: core_1.i.string(),
+            status: core_1.i.string(),
+            createdAt: core_1.i.date(),
+            updatedAt: core_1.i.date(),
+            description: core_1.i.string().optional(),
+        }),
+    },
+    links: {
+        management_projectsOrganization: {
+            forward: { on: "management_projects", has: "one", label: "organization" },
+            reverse: { on: "organizations", has: "many", label: "management_projects" },
+        },
+        management_tasksUser: {
+            forward: { on: "management_tasks", has: "one", label: "assignee" },
+            reverse: { on: "$users", has: "many", label: "management_tasks" },
+        },
+    },
+    rooms: {},
+});
+// OK: link only to base entities ($users/$files) without deps
+const filesOnly = (0, __1.domain)("filesOnly").schema({
+    entities: {
+        assets: core_1.i.entity({
+            name: core_1.i.string(),
+        }),
+    },
+    links: {
+        assetsFiles: {
+            forward: { on: "assets", has: "many", label: "$files" },
+            reverse: { on: "$files", has: "one", label: "asset" },
+        },
+    },
+    rooms: {},
+});
+// Note: Cross-domain link validation is now runtime-only for simplicity
+// The domain builder automatically includes base entities and merges included domains
+const runtimeValidatedExample = (0, __1.domain)("management")
+    .includes(otherDomain)
+    .schema({
+    entities: {
+        management_projects: core_1.i.entity({
+            name: core_1.i.string(),
+        }),
+        management_tasks: core_1.i.entity({
+            title: core_1.i.string(),
+        }),
+    },
+    links: {
+        // This will work because runtime merges in organizations from otherDomain
+        management_projectsOrganization: {
+            forward: { on: "management_projects", has: "one", label: "organization" },
+            reverse: { on: "organizations", has: "many", label: "management_projects" },
+        },
+        // Base entities are automatically available
+        management_tasksUser: {
+            forward: { on: "management_tasks", has: "one", label: "assignee" },
+            reverse: { on: "$users", has: "many", label: "management_tasks" },
+        },
+    },
+    rooms: {},
+});
+// OK: Base entities are automatically available without explicit declaration
+const baseEntitiesOnly = (0, __1.domain)("baseTest").schema({
+    entities: {
+        test_entity: core_1.i.entity({
+            name: core_1.i.string(),
+        }),
+    },
+    links: {
+        testEntityFiles: {
+            forward: { on: "test_entity", has: "many", label: "$files" },
+            reverse: { on: "$files", has: "one", label: "test_entity" },
+        },
+        testEntityUsers: {
+            forward: { on: "test_entity", has: "one", label: "owner" },
+            reverse: { on: "$users", has: "many", label: "owned_entities" },
+        },
+    },
+    rooms: {},
+});
+// Example usage of includes method
+const coreDomain = (0, __1.domain)({
+    entities: {
+        organizations: core_1.i.entity({
+            clerkOrgId: core_1.i.string().indexed().unique(),
+            timezone: core_1.i.string().optional(),
+        }),
+    },
+    links: {},
+    rooms: {},
+});
+const managementDomain = (0, __1.domain)("management")
+    .includes(coreDomain) // Include entities from coreDomain for cross-references
+    .schema({
+    entities: {
+        management_projects: core_1.i.entity({
+            name: core_1.i.string(),
+            createdAt: core_1.i.date(),
+            updatedAt: core_1.i.date(),
+        }),
+        management_tasks: core_1.i.entity({
+            title: core_1.i.string(),
+            status: core_1.i.string(),
+            createdAt: core_1.i.date(),
+            updatedAt: core_1.i.date(),
+        }),
+    },
+    links: {
+        // Can reference organizations from included coreDomain
+        management_projectsOrganization: {
+            forward: { on: "management_projects", has: "one", label: "organization" },
+            reverse: { on: "organizations", has: "many", label: "management_projects" },
+        },
+        // Can reference base entities ($users, $files) automatically
+        management_tasksUser: {
+            forward: { on: "management_tasks", has: "one", label: "assignee" },
+            reverse: { on: "$users", has: "many", label: "management_tasks" },
+        },
+    },
+    rooms: {},
+});
+// Flat schema construction - domains can be spread directly
+const completeSchema = core_1.i.schema({
+    entities: {
+        ...managementDomain.entities, // Includes base + core + management entities
+    },
+    links: {
+        ...managementDomain.links,
+    },
+    rooms: {
+        ...managementDomain.rooms,
+    },
+});
+// Test compose still works with domain instances
+const classicDomain = (0, __1.domain)({
+    entities: { test: core_1.i.entity({ name: core_1.i.string() }) },
+    links: {},
+    rooms: {},
+});
+const composed = classicDomain.compose((0, __1.domain)({
+    entities: { other: core_1.i.entity({ value: core_1.i.number() }) },
+    links: {},
+    rooms: {},
+}));
+// Test: Domain builder produces flat objects compatible with i.schema
+// This demonstrates the flat approach - domains return plain objects
+const managementEntities = management.entities;
+const managementLinks = management.links;
+const filesOnlyEntities = filesOnly.entities;
+// These can be spread directly into i.schema in real usage
+const _entities = managementEntities;
+const _links = managementLinks;
+// Type assertions for runtime verification (these should not fail)
+const _management = management;
+const _filesOnly = filesOnly;
+const _composed = composed;
+// Test toInstantSchema method compatibility
+const domainWithInstantSchema = (0, __1.domain)("instantTest")
+    .includes(otherDomain)
+    .schema({
+    entities: {
+        instant_entities: core_1.i.entity({
+            name: core_1.i.string(),
+        }),
+    },
+    links: {
+        instantEntityOrg: {
+            forward: { on: "instant_entities", has: "one", label: "organization" },
+            reverse: { on: "organizations", has: "many", label: "instant_entities" },
+        },
+    },
+    rooms: {},
+});
+const _instantSchemaCheck = true;
+// =====================================================================================
+// ❌ COMPILE-TIME VALIDATION: Links and Entity Conflicts
+// =====================================================================================
+// (Omitted negative tests that intentionally fail compilation)
+// (Known limitation) Duplicate entity names across includes are not detected at compile time
+//# sourceMappingURL=domain-builder.typecheck.js.map

package/dist/__type_tests__/domain-builder.typecheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-builder.typecheck.js","sourceRoot":"","sources":["../../src/__type_tests__/domain-builder.typecheck.ts"],"names":[],"mappings":";AAAA,+CAA+C;AAC/C,8DAA8D;;AAE9D,0BAA4B;AAC5B,0CAAoC;AAEpC,8EAA8E;AAE9E,oCAAoC;AACpC,MAAM,WAAW,GAAG,IAAA,UAAM,EAAC;IACzB,QAAQ,EAAE;QACR,aAAa,EAAE,QAAC,CAAC,MAAM,CAAC;YACtB,UAAU,EAAE,QAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE;YACzC,QAAQ,EAAE,QAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAChC,CAAC;KACH;IACD,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;CACV,CAAC,CAAC;AAEH,gFAAgF;AAChF,MAAM,UAAU,GAAG,IAAA,UAAM,EAAC,YAAY,CAAC;KACpC,QAAQ,CAAC,WAAW,CAAC;KACrB,MAAM,CAAC;IACN,QAAQ,EAAE;QACR,mBAAmB,EAAE,QAAC,CAAC,MAAM,CAAC;YAC5B,IAAI,EAAE,QAAC,CAAC,MAAM,EAAE;YAChB,SAAS,EAAE,QAAC,CAAC,IAAI,EAAE;YACnB,SAAS,EAAE,QAAC,CAAC,IAAI,EAAE;YACnB,WAAW,EAAE,QAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,eAAe,EAAE,QAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACvC,CAAC;QACF,gBAAgB,EAAE,QAAC,CAAC,MAAM,CAAC;YACzB,KAAK,EAAE,QAAC,CAAC,MAAM,EAAE;YACjB,MAAM,EAAE,QAAC,CAAC,MAAM,EAAE;YAClB,SAAS,EAAE,QAAC,CAAC,IAAI,EAAE;YACnB,SAAS,EAAE,QAAC,CAAC,IAAI,EAAE;YACnB,WAAW,EAAE,QAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACnC,CAAC;KACH;IACD,KAAK,EAAE;QACL,+BAA+B,EAAE;YAC/B,OAAO,EAAE,EAAE,EAAE,EAAE,qBAAqB,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE;YACzE,OAAO,EAAE,EAAE,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,EAAE;SAC5E;QACD,oBAAoB,EAAE;YACpB,OAAO,EAAE,EAAE,EAAE,EAAE,kBAAkB,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE;YAClE,OAAO,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE;SAClE;KACF;IACD,KAAK,EAAE,EAAE;CACV,CAAC,CAAC;AAEL,8DAA8D;AAC9D,MAAM,SAAS,GAAG,IAAA,UAAM,EAAC,WAAW,CAAC,CAAC,MAAM,CAAC;IAC3C,QAAQ,EAAE;QACR,MAAM,EAAE,QAAC,CAAC,MAAM,CAAC;YACf,IAAI,EAAE,QAAC,CAAC,MAAM,EAAE;SACjB,CAAC;KACH;IACD,KAAK,EAAE;QACL,WAAW,EAAE;YACX,OAAO,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE;YACvD,OAAO,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE;SACtD;KACF;IACD,KAAK,EAAE,EAAE;CACV,CAAC,CAAC;AAEH,wEAAwE;AACxE,sFAAsF;AACtF,MAAM,uBAAuB,GAAG,IAAA,UAAM,EAAC,YAAY,CAAC;KACjD,QAAQ,CAAC,WAAW,CAAC;KACrB,MAAM,CAAC;IACN,QAAQ,EAAE;QACR,mBAAmB,EAAE,QAAC,CAAC,MAAM,CAAC;YAC5B,IAAI,EAAE,QAAC,CAAC,MAAM,EAAE;SACjB,CAAC;QACF,gBAAgB,EAAE,QAAC,CAAC,MAAM,CAAC;YACzB,KAAK,EAAE,QAAC,CAAC,MAAM,EAAE;SAClB,CAAC;KACH;IACD,KAAK,EAAE;QACL,0EAA0E;QAC1E,+BAA+B,EAAE;YAC/B,OAAO,EAAE,EAAE,EAAE,EAAE,qBAAqB,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE;YACzE,OAAO,EAAE,EAAE,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,EAAE;SAC5E;QACD,4CAA4C;QAC5C,oBAAoB,EAAE;YACpB,OAAO,EAAE,EAAE,EAAE,EAAE,kBAAkB,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE;YAClE,OAAO,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE;SAClE;KACF;IACD,KAAK,EAAE,EAAE;CACV,CAAC,CAAC;AAEL,6EAA6E;AAC7E,MAAM,gBAAgB,GAAG,IAAA,UAAM,EAAC,UAAU,CAAC,CAAC,MAAM,CAAC;IACjD,QAAQ,EAAE;QACR,WAAW,EAAE,QAAC,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,QAAC,CAAC,MAAM,EAAE;SACjB,CAAC;KACH;IACD,KAAK,EAAE;QACL,eAAe,EAAE;YACf,OAAO,EAAE,EAAE,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE;YAC5D,OAAO,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE;SAC5D;QACD,eAAe,EAAE;YACf,OAAO,EAAE,EAAE,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE;YAC1D,OAAO,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE;SAChE;KACF;IACD,KAAK,EAAE,EAAE;CACV,CAAC,CAAC;AAEH,mCAAmC;AACnC,MAAM,UAAU,GAAG,IAAA,UAAM,EAAC;IACxB,QAAQ,EAAE;QACR,aAAa,EAAE,QAAC,CAAC,MAAM,CAAC;YACtB,UAAU,EAAE,QAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE;YACzC,QAAQ,EAAE,QAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAChC,CAAC;KACH;IACD,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;CACV,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,IAAA,UAAM,EAAC,YAAY,CAAC;KAC1C,QAAQ,CAAC,UAAU,CAAC,CAAE,wDAAwD;KAC9E,MAAM,CAAC;IACN,QAAQ,EAAE;QACR,mBAAmB,EAAE,QAAC,CAAC,MAAM,CAAC;YAC5B,IAAI,EAAE,QAAC,CAAC,MAAM,EAAE;YAChB,SAAS,EAAE,QAAC,CAAC,IAAI,EAAE;YACnB,SAAS,EAAE,QAAC,CAAC,IAAI,EAAE;SACpB,CAAC;QACF,gBAAgB,EAAE,QAAC,CAAC,MAAM,CAAC;YACzB,KAAK,EAAE,QAAC,CAAC,MAAM,EAAE;YACjB,MAAM,EAAE,QAAC,CAAC,MAAM,EAAE;YAClB,SAAS,EAAE,QAAC,CAAC,IAAI,EAAE;YACnB,SAAS,EAAE,QAAC,CAAC,IAAI,EAAE;SACpB,CAAC;KACH;IACD,KAAK,EAAE;QACL,uDAAuD;QACvD,+BAA+B,EAAE;YAC/B,OAAO,EAAE,EAAE,EAAE,EAAE,qBAAqB,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE;YACzE,OAAO,EAAE,EAAE,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,EAAE;SAC5E;QACD,6DAA6D;QAC7D,oBAAoB,EAAE;YACpB,OAAO,EAAE,EAAE,EAAE,EAAE,kBAAkB,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE;YAClE,OAAO,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE;SAClE;KACF;IACD,KAAK,EAAE,EAAE;CACV,CAAC,CAAC;AAEL,4DAA4D;AAC5D,MAAM,cAAc,GAAG,QAAC,CAAC,MAAM,CAAC;IAC9B,QAAQ,EAAE;QACR,GAAG,gBAAgB,CAAC,QAAQ,EAAE,6CAA6C;KAC5E;IACD,KAAK,EAAE;QACL,GAAG,gBAAgB,CAAC,KAAK;KAC1B;IACD,KAAK,EAAE;QACL,GAAG,gBAAgB,CAAC,KAAK;KAC1B;CACF,CAAC,CAAC;AAEH,iDAAiD;AACjD,MAAM,aAAa,GAAG,IAAA,UAAM,EAAC;IAC3B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE;IAClD,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;CACV,CAAC,CAAC;AACH,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,IAAA,UAAM,EAAC;IAC5C,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE;IACpD,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;CACV,CAAC,CAAC,CAAC;AAEJ,sEAAsE;AACtE,qEAAqE;AACrE,MAAM,kBAAkB,GAAG,UAAU,CAAC,QAAQ,CAAC;AAC/C,MAAM,eAAe,GAAG,UAAU,CAAC,KAAK,CAAC;AACzC,MAAM,iBAAiB,GAAG,SAAS,CAAC,QAAQ,CAAC;AAE7C,2DAA2D;AAC3D,MAAM,SAAS,GAAwB,kBAAkB,CAAC;AAC1D,MAAM,MAAM,GAAwB,eAAe,CAAC;AAEpD,mEAAmE;AACnE,MAAM,WAAW,GAAsB,UAAU,CAAC;AAClD,MAAM,UAAU,GAAqB,SAAS,CAAC;AAC/C,MAAM,SAAS,GAAoB,QAAQ,CAAC;AAE5C,4CAA4C;AAC5C,MAAM,uBAAuB,GAAG,IAAA,UAAM,EAAC,aAAa,CAAC;KAClD,QAAQ,CAAC,WAAW,CAAC;KACrB,MAAM,CAAC;IACN,QAAQ,EAAE;QACR,gBAAgB,EAAE,QAAC,CAAC,MAAM,CAAC;YACzB,IAAI,EAAE,QAAC,CAAC,MAAM,EAAE;SACjB,CAAC;KACH;IACD,KAAK,EAAE;QACL,gBAAgB,EAAE;YAChB,OAAO,EAAE,EAAE,EAAE,EAAE,kBAAkB,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE;YACtE,OAAO,EAAE,EAAE,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE;SACzE;KACF;IACD,KAAK,EAAE,EAAE;CACV,CAAC,CAAC;AAKL,MAAM,mBAAmB,GAAyB,IAAI,CAAC;AAEvD,wFAAwF;AACxF,wDAAwD;AACxD,wFAAwF;AAExF,+DAA+D;AAE/D,6FAA6F"}

package/dist/__type_tests__/domain-conflicts-examples.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=domain-conflicts-examples.d.ts.map

package/dist/__type_tests__/domain-conflicts-examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-conflicts-examples.d.ts","sourceRoot":"","sources":["../../src/__type_tests__/domain-conflicts-examples.ts"],"names":[],"mappings":"AAwMA,OAAO,EAAE,CAAC"}

package/dist/__type_tests__/domain-conflicts-examples.js

@@ -0,0 +1,8 @@
+"use strict";
+// =====================================================================================
+// ⚠️  DOMAIN CONFLICTS AND EDGE CASES
+// =====================================================================================
+// This file demonstrates scenarios where entity name conflicts can occur
+// and how the domain builder handles them.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=domain-conflicts-examples.js.map

package/dist/__type_tests__/domain-conflicts-examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-conflicts-examples.js","sourceRoot":"","sources":["../../src/__type_tests__/domain-conflicts-examples.ts"],"names":[],"mappings":";AAAA,wFAAwF;AACxF,sCAAsC;AACtC,wFAAwF;AACxF,yEAAyE;AACzE,2CAA2C"}

package/dist/__type_tests__/instant-schema-example.d.ts

@@ -0,0 +1,3 @@
+declare const instantSchema: any;
+export default instantSchema;
+//# sourceMappingURL=instant-schema-example.d.ts.map

package/dist/__type_tests__/instant-schema-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instant-schema-example.d.ts","sourceRoot":"","sources":["../../src/__type_tests__/instant-schema-example.ts"],"names":[],"mappings":"AAyKA,QAAA,MAAM,aAAa,KAA8B,CAAC;AAIlD,eAAe,aAAa,CAAC"}

package/dist/__type_tests__/instant-schema-example.js

@@ -0,0 +1,188 @@
+"use strict";
+// Example: instant.schema.ts using domain builder
+// This shows how to build a complete InstantDB schema using domains
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@instantdb/core");
+const index_1 = require("../index");
+// 1. Base/Core domain - defines fundamental entities
+const coreDomain = (0, index_1.domain)({
+    entities: {
+        organizations: core_1.i.entity({
+            clerkOrgId: core_1.i.string().indexed().unique(),
+            name: core_1.i.string(),
+            timezone: core_1.i.string().optional(),
+            createdAt: core_1.i.date(),
+        }),
+    },
+    links: {},
+    rooms: {},
+});
+// 2. Finance domain - includes core entities for financial operations
+const financeDomain = (0, index_1.domain)("finance")
+    .includes(coreDomain) // Include core entities (orgs, users) for cross-references
+    .schema({
+    entities: {
+        transactions: core_1.i.entity({
+            provider: core_1.i.string().indexed(),
+            externalId: core_1.i.string().indexed(),
+            amount: core_1.i.number(),
+            currency: core_1.i.string().optional(),
+            status: core_1.i.string().indexed(),
+            description: core_1.i.string().optional(),
+            createdAt: core_1.i.date().indexed(),
+            updatedAt: core_1.i.date().indexed().optional(),
+        }),
+        payments: core_1.i.entity({
+            provider: core_1.i.string().indexed(),
+            externalPaymentId: core_1.i.string().indexed(),
+            amount: core_1.i.number(),
+            currency: core_1.i.string().optional(),
+            status: core_1.i.string().indexed(),
+            method: core_1.i.string().optional(),
+            createdAt: core_1.i.date(),
+        }),
+    },
+    links: {
+        // Cross-reference to organizations from coreDomain
+        transactionOrganization: {
+            forward: { on: "transactions", has: "one", label: "organization" },
+            reverse: { on: "organizations", has: "many", label: "transactions" },
+        },
+        // Cross-reference to users (base entity, automatically available)
+        transactionUser: {
+            forward: { on: "transactions", has: "one", label: "createdBy" },
+            reverse: { on: "$users", has: "many", label: "transactions" },
+        },
+        // Base entities are automatically available
+        paymentFiles: {
+            forward: { on: "payments", has: "many", label: "$files" },
+            reverse: { on: "$files", has: "one", label: "payment" },
+        },
+        transactionPayment: {
+            forward: { on: "transactions", has: "one", label: "payment" },
+            reverse: { on: "payments", has: "one", label: "transaction" },
+        },
+    },
+    rooms: {},
+});
+// 3. Management domain - includes core entities for project management
+const managementDomain = (0, index_1.domain)("management")
+    .includes(coreDomain) // Include core entities (orgs, users)
+    .schema({
+    entities: {
+        projects: core_1.i.entity({
+            name: core_1.i.string(),
+            description: core_1.i.string().optional(),
+            status: core_1.i.string(),
+            createdAt: core_1.i.date(),
+            updatedAt: core_1.i.date(),
+        }),
+        tasks: core_1.i.entity({
+            title: core_1.i.string(),
+            description: core_1.i.string().optional(),
+            status: core_1.i.string(),
+            priority: core_1.i.string().optional(),
+            createdAt: core_1.i.date(),
+            updatedAt: core_1.i.date(),
+        }),
+    },
+    links: {
+        // Cross-reference to organizations from coreDomain
+        projectOrganization: {
+            forward: { on: "projects", has: "one", label: "organization" },
+            reverse: { on: "organizations", has: "many", label: "projects" },
+        },
+        // Cross-reference to users (base entity, automatically available)
+        taskAssignee: {
+            forward: { on: "tasks", has: "one", label: "assignee" },
+            reverse: { on: "$users", has: "many", label: "assignedTasks" },
+        },
+        taskCreator: {
+            forward: { on: "tasks", has: "one", label: "creator" },
+            reverse: { on: "$users", has: "many", label: "createdTasks" },
+        },
+        // Project-Task relationship
+        projectTasks: {
+            forward: { on: "projects", has: "many", label: "tasks" },
+            reverse: { on: "tasks", has: "one", label: "project" },
+        },
+        // Base entities automatically available
+        projectFiles: {
+            forward: { on: "projects", has: "many", label: "$files" },
+            reverse: { on: "$files", has: "one", label: "project" },
+        },
+    },
+    rooms: {},
+});
+// 4. App domain - combines all domains for the complete application schema
+const appDomain = (0, index_1.domain)("app")
+    .includes(coreDomain) // ✅ Include core domain
+    .includes(financeDomain) // ✅ Include finance domain
+    .includes(managementDomain) // ✅ Include management domain
+    .schema({
+    entities: {
+        // App-specific entities
+        app_settings: core_1.i.entity({
+            key: core_1.i.string().unique().indexed(),
+            value: core_1.i.any(),
+            createdAt: core_1.i.date(),
+            updatedAt: core_1.i.date(),
+        }),
+        notifications: core_1.i.entity({
+            type: core_1.i.string(),
+            message: core_1.i.string(),
+            read: core_1.i.boolean().optional(),
+            createdAt: core_1.i.date(),
+        }),
+    },
+    links: {
+        // Cross-references to all included domains
+        organizationMembers: {
+            forward: { on: "organizations", has: "many", label: "members" },
+            reverse: { on: "$users", has: "many", label: "organizations" },
+        },
+        settingsOrganization: {
+            forward: { on: "app_settings", has: "one", label: "organization" },
+            reverse: { on: "organizations", has: "many", label: "settings" },
+        },
+        notificationUser: {
+            forward: { on: "notifications", has: "one", label: "user" },
+            reverse: { on: "$users", has: "many", label: "notifications" },
+        },
+        // Can reference entities from transitively included domains
+        notificationTransaction: {
+            forward: { on: "notifications", has: "one", label: "relatedTransaction" },
+            reverse: { on: "transactions", has: "many", label: "notifications" },
+        },
+        notificationProject: {
+            forward: { on: "notifications", has: "one", label: "relatedProject" },
+            reverse: { on: "projects", has: "many", label: "notifications" },
+        },
+    },
+    rooms: {},
+});
+// FINAL SCHEMA: Complete InstantDB schema using domain toInstantSchema()
+// This would be in your instant.schema.ts file:
+const instantSchema = appDomain.toInstantSchema(); // That's it!
+exports.default = instantSchema;
+/*
+USAGE NOTES:
+
+1. When you .includes() a domain, you get ALL its entities transitively:
+   - appDomain.includes(coreDomain) → gets core entities
+   - appDomain.includes(financeDomain) → gets finance + core entities (transitive)
+   - appDomain.includes(managementDomain) → gets management + core entities (transitive)
+
+2. Base entities ($users, $files) are automatically included in ALL domains
+
+3. Cross-domain links work automatically - you can reference entities from included domains
+
+4. toInstantSchema() returns the complete InstantDB schema directly:
+   - domain.toInstantSchema() ✅ Returns ready-to-use schema
+   - No need to wrap with i.schema() or manual spreading
+
+5. No manual duplication of base entities or transitive dependencies needed
+
+6. Anywhere you need an InstantDB schema object, you can use domain.toInstantSchema()
+*/
+//# sourceMappingURL=instant-schema-example.js.map

package/dist/__type_tests__/instant-schema-example.js.map

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

package/dist/__type_tests__/instant-schema-migration-example.d.ts

@@ -0,0 +1,4 @@
+export declare const instantSchema: import("@instantdb/core").InstantSchemaDef<import("@instantdb/core").EntitiesWithLinks<import("@instantdb/core").EntitiesDef, import("@instantdb/core").LinksDef<import("@instantdb/core").EntitiesDef>>, import("@instantdb/core").LinksDef<any>, import("@instantdb/core").RoomsDef>;
+export type AppSchema = typeof instantSchema;
+export default instantSchema;
+//# sourceMappingURL=instant-schema-migration-example.d.ts.map

package/dist/__type_tests__/instant-schema-migration-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instant-schema-migration-example.d.ts","sourceRoot":"","sources":["../../src/__type_tests__/instant-schema-migration-example.ts"],"names":[],"mappings":"AAoKA,eAAO,MAAM,aAAa,wRAAwC,CAAC;AASnE,MAAM,MAAM,SAAS,GAAG,OAAO,aAAa,CAAC;AAC7C,eAAe,aAAa,CAAC"}

package/dist/__type_tests__/instant-schema-migration-example.js

@@ -0,0 +1,178 @@
+"use strict";
+// Example: Migrating from manual instant.schema.ts to domain-based schema
+// This shows how to convert your existing ekairos-web instant.schema.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instantSchema = void 0;
+const core_1 = require("@instantdb/core");
+const index_1 = require("../index");
+// BEFORE: Manual schema with 400+ lines
+// const _schema = i.schema({
+//   entities: { /* 200+ lines of entities */ },
+//   links: { /* 200+ lines of links */ },
+//   rooms: { /* rooms */ },
+// });
+// AFTER: Domain-based schema - modular and maintainable
+// Core domain - fundamental entities shared across all domains
+const coreDomain = (0, index_1.domain)({
+    entities: {
+        organizations: core_1.i.entity({
+            clerkOrgId: core_1.i.string().indexed().unique(),
+            name: core_1.i.string(),
+            timezone: core_1.i.string().optional(),
+        }),
+    },
+    links: {},
+    rooms: {},
+});
+// Finance domain - all financial entities and operations
+const financeDomain = (0, index_1.domain)("finance")
+    .includes(coreDomain)
+    .schema({
+    entities: {
+        transactions: core_1.i.entity({
+            provider: core_1.i.string().indexed(),
+            externalId: core_1.i.string().indexed(),
+            amount: core_1.i.number(),
+            currency: core_1.i.string().optional(),
+            status: core_1.i.string().indexed(),
+            description: core_1.i.string().optional(),
+            createdAt: core_1.i.date().indexed(),
+            updatedAt: core_1.i.date().indexed().optional(),
+        }),
+        payments: core_1.i.entity({
+            provider: core_1.i.string().indexed(),
+            externalPaymentId: core_1.i.string().indexed(),
+            amount: core_1.i.number(),
+            currency: core_1.i.string().optional(),
+            status: core_1.i.string().indexed(),
+            method: core_1.i.string().optional(),
+            createdAt: core_1.i.date(),
+        }),
+    },
+    links: {
+        transactionOrganization: {
+            forward: { on: "transactions", has: "one", label: "organization" },
+            reverse: { on: "organizations", has: "many", label: "transactions" },
+        },
+        transactionUser: {
+            forward: { on: "transactions", has: "one", label: "createdBy" },
+            reverse: { on: "$users", has: "many", label: "transactions" },
+        },
+        transactionPayment: {
+            forward: { on: "transactions", has: "one", label: "payment" },
+            reverse: { on: "payments", has: "one", label: "transaction" },
+        },
+    },
+    rooms: {},
+});
+// Management domain - project and task management
+const managementDomain = (0, index_1.domain)("management")
+    .includes(coreDomain)
+    .schema({
+    entities: {
+        projects: core_1.i.entity({
+            name: core_1.i.string(),
+            description: core_1.i.string().optional(),
+            status: core_1.i.string(),
+            createdAt: core_1.i.date(),
+            updatedAt: core_1.i.date(),
+        }),
+        tasks: core_1.i.entity({
+            title: core_1.i.string(),
+            description: core_1.i.string().optional(),
+            status: core_1.i.string(),
+            priority: core_1.i.string().optional(),
+            createdAt: core_1.i.date(),
+            updatedAt: core_1.i.date(),
+        }),
+    },
+    links: {
+        projectOrganization: {
+            forward: { on: "projects", has: "one", label: "organization" },
+            reverse: { on: "organizations", has: "many", label: "projects" },
+        },
+        taskAssignee: {
+            forward: { on: "tasks", has: "one", label: "assignee" },
+            reverse: { on: "$users", has: "many", label: "assignedTasks" },
+        },
+        projectTasks: {
+            forward: { on: "projects", has: "many", label: "tasks" },
+            reverse: { on: "tasks", has: "one", label: "project" },
+        },
+    },
+    rooms: {},
+});
+// App domain - combines everything for the complete application
+const appDomain = (0, index_1.domain)("app")
+    .includes(coreDomain) // Include core entities
+    .includes(financeDomain) // Include finance (transitively includes core)
+    .includes(managementDomain) // Include management (transitively includes core)
+    .schema({
+    entities: {
+        // App-specific entities
+        app_settings: core_1.i.entity({
+            key: core_1.i.string().unique().indexed(),
+            value: core_1.i.any(),
+            createdAt: core_1.i.date(),
+            updatedAt: core_1.i.date(),
+        }),
+        notifications: core_1.i.entity({
+            type: core_1.i.string(),
+            message: core_1.i.string(),
+            read: core_1.i.boolean().optional(),
+            createdAt: core_1.i.date(),
+        }),
+        // Add all the other entities from your current schema here...
+        // (locations, routes, items, etc.)
+    },
+    links: {
+        // Core organization links (base entities available here)
+        organizationMembers: {
+            forward: { on: "organizations", has: "many", label: "members" },
+            reverse: { on: "$users", has: "many", label: "organizations" },
+        },
+        // App-specific links
+        settingsOrganization: {
+            forward: { on: "app_settings", has: "one", label: "organization" },
+            reverse: { on: "organizations", has: "many", label: "settings" },
+        },
+        notificationUser: {
+            forward: { on: "notifications", has: "one", label: "user" },
+            reverse: { on: "$users", has: "many", label: "notifications" },
+        },
+        // Cross-domain references work automatically
+        notificationTransaction: {
+            forward: { on: "notifications", has: "one", label: "relatedTransaction" },
+            reverse: { on: "transactions", has: "many", label: "notifications" },
+        },
+        notificationProject: {
+            forward: { on: "notifications", has: "one", label: "relatedProject" },
+            reverse: { on: "projects", has: "many", label: "notifications" },
+        },
+        // Add all the other links from your current schema here...
+        // (organization links, finance links, etc.)
+    },
+    rooms: {
+    // Add rooms from your current schema
+    },
+});
+// FINAL SCHEMA: Direct compatibility with InstantDB
+exports.instantSchema = core_1.i.schema(appDomain.toInstantSchema());
+exports.default = exports.instantSchema;
+/*
+MIGRATION BENEFITS:
+
+1. 📦 Modularity: Each domain is independent and reusable
+2. 🔗 Type Safety: Cross-domain links are fully validated
+3. 🚀 Maintainability: Changes are localized to relevant domains
+4. ⚡ Performance: Only load domains you need in specific contexts
+5. 🔄 Compatibility: Drop-in replacement for existing i.schema() calls
+6. 🎯 Clarity: Intent is clear - domains explicitly include their dependencies
+
+NEXT STEPS:
+1. Break down your current instant.schema.ts into logical domains
+2. Use .includes() to establish dependencies between domains
+3. Replace manual schema with domain.toInstantSchema()
+4. Test thoroughly - all existing functionality should work identically
+*/
+//# sourceMappingURL=instant-schema-migration-example.js.map

package/dist/__type_tests__/instant-schema-migration-example.js.map

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

package/dist/index.d.ts

@@ -1,14 +1,45 @@
 import { i } from "@instantdb/core";
 import type { EntitiesDef, LinksDef, RoomsDef, InstantSchemaDef } from "@instantdb/core";
-export type DomainDefinition<E extends EntitiesDef, L extends LinksDef<any>, R extends RoomsDef> = {
+export type DomainDefinition<E extends EntitiesDef, L extends LinksDef<E>, R extends RoomsDef> = {
     entities: E;
     links: L;
     rooms: R;
 };
-export type DomainInstance<E extends EntitiesDef, L extends LinksDef<any>, R extends RoomsDef> = DomainDefinition<E, L, R> & {
+export type DomainInstance<E extends EntitiesDef, L extends LinksDef<E>, R extends RoomsDef> = DomainDefinition<E, L, R> & {
     schema: () => ReturnType<typeof i.schema>;
     compose: <E2 extends EntitiesDef, L2 extends LinksDef<E2>, R2 extends RoomsDef>(other: DomainInstance<E2, L2, R2> | DomainDefinition<E2, L2, R2>) => DomainInstance<E & E2, LinksDef<E & E2>, R & R2>;
 };
 export type SchemaOf<D extends DomainDefinition<any, any, any>> = InstantSchemaDef<D["entities"], LinksDef<D["entities"]>, D["rooms"]>;
-export declare function domain<E extends EntitiesDef, L extends LinksDef<any>, R extends RoomsDef>(def: DomainDefinition<E, L, R>): DomainInstance<E, L, R>;
+type MergeEntities<A extends EntitiesDef, B extends EntitiesDef> = {
+    [K in keyof A | keyof B]: K extends keyof A ? A[K] : K extends keyof B ? B[K] : never;
+};
+export type DomainSchemaResult<E extends EntitiesDef = EntitiesDef, L extends LinksDef<any> = LinksDef<any>, R extends RoomsDef = RoomsDef> = {
+    entities: E;
+    links: L;
+    rooms: R;
+    toInstantSchema: () => InstantSchemaWithDomain<any>;
+};
+export type InstantSchemaWithDomain<T> = T & {
+    entities: EntitiesDef;
+    links: Record<string, any>;
+    rooms: RoomsDef;
+    withRoomSchema: any;
+};
+type AnyEntityDef = EntitiesDef[string];
+type BaseEntitiesPhantom = {
+    $users: AnyEntityDef;
+    $files: AnyEntityDef;
+};
+type WithBase<E extends EntitiesDef> = MergeEntities<E, BaseEntitiesPhantom>;
+export type DomainBuilder<AccumE extends EntitiesDef> = {
+    includes: <E2 extends EntitiesDef>(other: DomainInstance<E2, any, any> | DomainSchemaResult<E2, any, any> | InstantSchemaDef<E2, any, any>) => DomainBuilder<MergeEntities<AccumE, E2>>;
+    schema: <LE extends EntitiesDef>(def: {
+        entities: LE;
+        links: LinksDef<WithBase<MergeEntities<AccumE, LE>>>;
+        rooms: RoomsDef;
+    }) => DomainSchemaResult<MergeEntities<AccumE, LE>, LinksDef<MergeEntities<AccumE, LE>>, RoomsDef>;
+};
+export declare function domain<E extends EntitiesDef, L extends LinksDef<E>, R extends RoomsDef>(def: DomainDefinition<E, L, R>): DomainInstance<E, L, R>;
+export declare function domain(name?: string): DomainBuilder<{}>;
+export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,iBAAiB,CAAC;AACpC,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEzF,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,QAAQ,IAAI;IACjG,QAAQ,EAAE,CAAC,CAAC;IACZ,KAAK,EAAE,CAAC,CAAC;IACT,KAAK,EAAE,CAAC,CAAC;CACV,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,QAAQ,IAAI,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG;IAC3H,MAAM,EAAE,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,EAAE,CAAC,EAAE,SAAS,WAAW,EAAE,EAAE,SAAS,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,QAAQ,EAC5E,KAAK,EAAE,cAAc,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,gBAAgB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,KAC7D,cAAc,CAAC,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,gBAAgB,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AAEvI,wBAAgB,MAAM,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,QAAQ,EACvF,GAAG,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC7B,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAkCzB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.domain = domain;
 const core_1 = require("@instantdb/core");
-function domain(def) {
+function makeInstance(def) {
     function schema() {
         return core_1.i.schema({
             entities: def.entities,
@@ -11,13 +11,13 @@ function domain(def) {
         });
     }
     function compose(other) {
-        const otherDef = ("schema" in other)
+        const otherDef = "schema" in other
             ? { entities: other.entities, links: other.links, rooms: other.rooms }
             : other;
         const mergedEntities = { ...def.entities, ...otherDef.entities };
         const mergedLinks = { ...def.links, ...otherDef.links };
         const mergedRooms = { ...def.rooms, ...otherDef.rooms };
-        return domain({
+        return makeInstance({
             entities: mergedEntities,
             links: mergedLinks,
             rooms: mergedRooms,
@@ -31,4 +31,43 @@ function domain(def) {
         compose,
     };
 }
+// Impl
+function domain(arg) {
+    if (typeof arg === "object" && arg !== null) {
+        // classic API path: def provided directly
+        const def = arg;
+        return makeInstance(def);
+    }
+    // builder API - runtime state tracks accumulated dependencies
+    function createBuilder(deps) {
+        return {
+            includes: (other) => {
+                const entities = other.entities;
+                const merged = { ...deps, ...entities };
+                return createBuilder(merged);
+            },
+            schema: (def) => {
+                // Runtime merge for output; compile-time validation handled by types above
+                const allEntities = { ...deps, ...def.entities };
+                return {
+                    entities: allEntities,
+                    // Strip base phantom from public type so it's assignable to i.schema()
+                    links: def.links,
+                    rooms: def.rooms,
+                    toInstantSchema: () => {
+                        const { i } = require("@instantdb/core");
+                        return i.schema({
+                            entities: allEntities,
+                            links: def.links,
+                            rooms: def.rooms,
+                        });
+                    },
+                };
+            },
+        };
+    }
+    // Default include: start with an empty i.schema() so Instant base entities are present
+    const base = core_1.i.schema({ entities: {}, links: {}, rooms: {} });
+    return createBuilder({ ...base.entities });
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAkBA,wBAoCC;AAtDD,0CAAoC;AAkBpC,SAAgB,MAAM,CACpB,GAA8B;IAE9B,SAAS,MAAM;QACb,OAAO,QAAC,CAAC,MAAM,CAAC;YACd,QAAQ,EAAE,GAAG,CAAC,QAAa;YAC3B,KAAK,EAAE,GAAG,CAAC,KAAU;YACrB,KAAK,EAAE,GAAG,CAAC,KAAU;SACtB,CAAC,CAAC;IACL,CAAC;IAED,SAAS,OAAO,CACd,KAAgE;QAEhE,MAAM,QAAQ,GAAG,CAAC,QAAQ,IAAI,KAAK,CAAC;YAClC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;YACtE,CAAC,CAAC,KAAK,CAAC;QAEV,MAAM,cAAc,GAAG,EAAE,GAAG,GAAG,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAY,CAAC;QAC3E,MAAM,WAAW,GAAG,EAAE,GAAI,GAAG,CAAC,KAAgB,EAAE,GAAI,QAAQ,CAAC,KAAgB,EAAsB,CAAC;QACpG,MAAM,WAAW,GAAG,EAAE,GAAG,GAAG,CAAC,KAAK,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAY,CAAC;QAElE,OAAO,MAAM,CAAC;YACZ,QAAQ,EAAE,cAAc;YACxB,KAAK,EAAE,WAAW;YAClB,KAAK,EAAE,WAAW;SACnB,CAAqD,CAAC;IACzD,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,MAAM;QACN,OAAO;KACmB,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ekairos/domain",
-  "version": "1.8.3",
+  "version": "1.8.5-beta.0",
   "description": "Pulzar Domain Utilities",
   "type": "commonjs",
   "main": "dist/index.js",
@@ -28,10 +28,12 @@
     "build": "tsc -p tsconfig.json",
     "dev": "tsc -p tsconfig.json --watch",
     "clean": "node -e \"require('fs').rmSync('dist', {recursive:true, force:true})\"",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "typecheck:tests": "tsc --noEmit -p tsconfig.typecheck.json",
+    "test:conflicts": "node dist/__type_tests__/conflict-validation.test.js"
   },
   "dependencies": {
-    "@instantdb/core": "^0.22.13"
+    "@instantdb/core": "^0.20.21"
   },
   "devDependencies": {
     "@ekairos/tsconfig": "workspace:*",