@lssm/example.service-business-os 0.0.0-canary-20251217083314 → 0.0.0-canary-20251220002821

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/client/client.contracts.d.ts

@@ -1,64 +1,65 @@
-import * as _lssm_lib_schema449 from "@lssm/lib.schema";
-import * as _lssm_lib_contracts18 from "@lssm/lib.contracts";
+import * as _lssm_lib_schema140 from "@lssm/lib.schema";
+import * as _lssm_lib_contracts12 from "@lssm/lib.contracts";
 
 //#region src/client/client.contracts.d.ts
 /**
  * Create a new client.
  */
-declare const CreateClientContract: _lssm_lib_contracts18.ContractSpec<_lssm_lib_schema449.SchemaModel<{
+declare const CreateClientContract: _lssm_lib_contracts12.ContractSpec<_lssm_lib_schema140.SchemaModel<{
   name: {
-    type: _lssm_lib_schema449.FieldType<string, string>;
+    type: _lssm_lib_schema140.FieldType<string, string>;
     isOptional: false;
   };
   contactEmail: {
-    type: _lssm_lib_schema449.FieldType<string, string>;
+    type: _lssm_lib_schema140.FieldType<string, string>;
     isOptional: true;
   };
   phone: {
-    type: _lssm_lib_schema449.FieldType<string, string>;
+    type: _lssm_lib_schema140.FieldType<string, string>;
     isOptional: true;
   };
   orgId: {
-    type: _lssm_lib_schema449.FieldType<string, string>;
+    type: _lssm_lib_schema140.FieldType<string, string>;
     isOptional: false;
   };
   ownerId: {
-    type: _lssm_lib_schema449.FieldType<string, string>;
+    type: _lssm_lib_schema140.FieldType<string, string>;
     isOptional: false;
   };
   metadata: {
-    type: _lssm_lib_schema449.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema140.FieldType<unknown, unknown>;
     isOptional: true;
   };
-}>, _lssm_lib_schema449.SchemaModel<{
+}>, _lssm_lib_schema140.SchemaModel<{
   id: {
-    type: _lssm_lib_schema449.FieldType<string, string>;
+    type: _lssm_lib_schema140.FieldType<string, string>;
     isOptional: false;
   };
   name: {
-    type: _lssm_lib_schema449.FieldType<string, string>;
+    type: _lssm_lib_schema140.FieldType<string, string>;
     isOptional: false;
   };
   contactEmail: {
-    type: _lssm_lib_schema449.FieldType<string, string>;
+    type: _lssm_lib_schema140.FieldType<string, string>;
     isOptional: true;
   };
   phone: {
-    type: _lssm_lib_schema449.FieldType<string, string>;
+    type: _lssm_lib_schema140.FieldType<string, string>;
     isOptional: true;
   };
   orgId: {
-    type: _lssm_lib_schema449.FieldType<string, string>;
+    type: _lssm_lib_schema140.FieldType<string, string>;
     isOptional: false;
   };
   ownerId: {
-    type: _lssm_lib_schema449.FieldType<string, string>;
+    type: _lssm_lib_schema140.FieldType<string, string>;
     isOptional: false;
   };
   createdAt: {
-    type: _lssm_lib_schema449.FieldType<Date, string>;
+    type: _lssm_lib_schema140.FieldType<Date, string>;
     isOptional: false;
   };
 }>, undefined>;
 //#endregion
-export { CreateClientContract };
+export { CreateClientContract };
+//# sourceMappingURL=client.contracts.d.ts.map

package/dist/client/client.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.contracts.d.ts","names":[],"sources":["../../src/client/client.contracts.ts"],"sourcesContent":[],"mappings":";;;;;;;cAQa,4CAAoB,iCAAA;EAApB,IAAA,EAAA;IAgBX,IAAA,EAAA,mBAAA,CAAA,SAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;EAhB+B,KAAA,EAAA;;;;;;;;;uCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;;;;UAAA,mBAAA,CAAA"}

package/dist/client/client.contracts.js

@@ -30,4 +30,5 @@ const CreateClientContract = defineCommand({
 });
 
 //#endregion
-export { CreateClientContract };
+export { CreateClientContract };
+//# sourceMappingURL=client.contracts.js.map

package/dist/client/client.contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.contracts.js","names":[],"sources":["../../src/client/client.contracts.ts"],"sourcesContent":["import { defineCommand } from '@lssm/lib.contracts';\nimport { ClientModel, CreateClientInputModel } from './client.schema';\n\nconst OWNERS = ['@examples.service-business-os'] as const;\n\n/**\n * Create a new client.\n */\nexport const CreateClientContract = defineCommand({\n  meta: {\n    name: 'service.client.create',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['service-business-os', 'client', 'create'],\n    description: 'Create a new client.',\n    goal: 'Onboard clients.',\n    context: 'CRM.',\n  },\n  io: {\n    input: CreateClientInputModel,\n    output: ClientModel,\n  },\n  policy: { auth: 'user' },\n});\n"],"mappings":";;;;;AAGA,MAAM,SAAS,CAAC,gCAAgC;;;;AAKhD,MAAa,uBAAuB,cAAc;CAChD,MAAM;EACJ,MAAM;EACN,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM;GAAC;GAAuB;GAAU;GAAS;EACjD,aAAa;EACb,MAAM;EACN,SAAS;EACV;CACD,IAAI;EACF,OAAO;EACP,QAAQ;EACT;CACD,QAAQ,EAAE,MAAM,QAAQ;CACzB,CAAC"}

package/dist/client/client.schema.d.ts

@@ -1,67 +1,68 @@
-import * as _lssm_lib_schema241 from "@lssm/lib.schema";
+import * as _lssm_lib_schema215 from "@lssm/lib.schema";
 
 //#region src/client/client.schema.d.ts
 /**
  * Client profile.
  */
-declare const ClientModel: _lssm_lib_schema241.SchemaModel<{
+declare const ClientModel: _lssm_lib_schema215.SchemaModel<{
   id: {
-    type: _lssm_lib_schema241.FieldType<string, string>;
+    type: _lssm_lib_schema215.FieldType<string, string>;
     isOptional: false;
   };
   name: {
-    type: _lssm_lib_schema241.FieldType<string, string>;
+    type: _lssm_lib_schema215.FieldType<string, string>;
     isOptional: false;
   };
   contactEmail: {
-    type: _lssm_lib_schema241.FieldType<string, string>;
+    type: _lssm_lib_schema215.FieldType<string, string>;
     isOptional: true;
   };
   phone: {
-    type: _lssm_lib_schema241.FieldType<string, string>;
+    type: _lssm_lib_schema215.FieldType<string, string>;
     isOptional: true;
   };
   orgId: {
-    type: _lssm_lib_schema241.FieldType<string, string>;
+    type: _lssm_lib_schema215.FieldType<string, string>;
     isOptional: false;
   };
   ownerId: {
-    type: _lssm_lib_schema241.FieldType<string, string>;
+    type: _lssm_lib_schema215.FieldType<string, string>;
     isOptional: false;
   };
   createdAt: {
-    type: _lssm_lib_schema241.FieldType<Date, string>;
+    type: _lssm_lib_schema215.FieldType<Date, string>;
     isOptional: false;
   };
 }>;
 /**
  * Input for creating a client.
  */
-declare const CreateClientInputModel: _lssm_lib_schema241.SchemaModel<{
+declare const CreateClientInputModel: _lssm_lib_schema215.SchemaModel<{
   name: {
-    type: _lssm_lib_schema241.FieldType<string, string>;
+    type: _lssm_lib_schema215.FieldType<string, string>;
     isOptional: false;
   };
   contactEmail: {
-    type: _lssm_lib_schema241.FieldType<string, string>;
+    type: _lssm_lib_schema215.FieldType<string, string>;
     isOptional: true;
   };
   phone: {
-    type: _lssm_lib_schema241.FieldType<string, string>;
+    type: _lssm_lib_schema215.FieldType<string, string>;
     isOptional: true;
   };
   orgId: {
-    type: _lssm_lib_schema241.FieldType<string, string>;
+    type: _lssm_lib_schema215.FieldType<string, string>;
     isOptional: false;
   };
   ownerId: {
-    type: _lssm_lib_schema241.FieldType<string, string>;
+    type: _lssm_lib_schema215.FieldType<string, string>;
     isOptional: false;
   };
   metadata: {
-    type: _lssm_lib_schema241.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema215.FieldType<unknown, unknown>;
     isOptional: true;
   };
 }>;
 //#endregion
-export { ClientModel, CreateClientInputModel };
+export { ClientModel, CreateClientInputModel };
+//# sourceMappingURL=client.schema.d.ts.map

package/dist/client/client.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.schema.d.ts","names":[],"sources":["../../src/client/client.schema.ts"],"sourcesContent":[],"mappings":";;;;;;AAKa,cAAA,WAYX,sBAZsB,WAYtB,CAAA;EAAA,EAAA,EAAA;UAAA,mBAAA,CAAA;;;;;;;;IAZsB,IAAA,+BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAiBX,UAAA,EAAA,IAAA;EAWX,CAAA;;;;;;uCAXiC,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;;;;;;;;;;cAAtB,4CAAsB;;UAWjC,mBAAA,CAAA"}

package/dist/client/client.schema.js

@@ -1,41 +1,39 @@
-import { ScalarTypeEnum } from "../libs/schema/dist/ScalarTypeEnum.js";
-import { defineSchemaModel } from "../libs/schema/dist/SchemaModel.js";
-import "../libs/schema/dist/index.js";
+import { E5, K5 } from "../libs/schema/dist/index.js";
 
 //#region src/client/client.schema.ts
 /**
 * Client profile.
 */
-const ClientModel = defineSchemaModel({
+const ClientModel = K5({
 	name: "Client",
 	description: "Client profile",
 	fields: {
 		id: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		name: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		contactEmail: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		},
 		phone: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		},
 		orgId: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		ownerId: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		createdAt: {
-			type: ScalarTypeEnum.DateTime(),
+			type: E5.DateTime(),
 			isOptional: false
 		}
 	}
@@ -43,36 +41,37 @@ const ClientModel = defineSchemaModel({
 /**
 * Input for creating a client.
 */
-const CreateClientInputModel = defineSchemaModel({
+const CreateClientInputModel = K5({
 	name: "CreateClientInput",
 	description: "Input for creating a client",
 	fields: {
 		name: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		contactEmail: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		},
 		phone: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		},
 		orgId: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		ownerId: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		metadata: {
-			type: ScalarTypeEnum.JSON(),
+			type: E5.JSON(),
 			isOptional: true
 		}
 	}
 });
 
 //#endregion
-export { ClientModel, CreateClientInputModel };
+export { ClientModel, CreateClientInputModel };
+//# sourceMappingURL=client.schema.js.map

package/dist/client/client.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.schema.js","names":["defineSchemaModel","ScalarTypeEnum"],"sources":["../../src/client/client.schema.ts"],"sourcesContent":["import { defineSchemaModel, ScalarTypeEnum } from '@lssm/lib.schema';\n\n/**\n * Client profile.\n */\nexport const ClientModel = defineSchemaModel({\n  name: 'Client',\n  description: 'Client profile',\n  fields: {\n    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    contactEmail: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    phone: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    orgId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    ownerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\n/**\n * Input for creating a client.\n */\nexport const CreateClientInputModel = defineSchemaModel({\n  name: 'CreateClientInput',\n  description: 'Input for creating a client',\n  fields: {\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    contactEmail: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    phone: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    orgId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    ownerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    metadata: { type: ScalarTypeEnum.JSON(), isOptional: true },\n  },\n});\n"],"mappings":";;;;;;AAKA,MAAa,cAAcA,GAAkB;CAC3C,MAAM;CACN,aAAa;CACb,QAAQ;EACN,IAAI;GAAE,MAAMC,GAAe,iBAAiB;GAAE,YAAY;GAAO;EACjE,MAAM;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAO;EACnE,cAAc;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAM;EAC1E,OAAO;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAM;EACnE,OAAO;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAO;EACpE,SAAS;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAO;EACtE,WAAW;GAAE,MAAMA,GAAe,UAAU;GAAE,YAAY;GAAO;EAClE;CACF,CAAC;;;;AAKF,MAAa,yBAAyBD,GAAkB;CACtD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,MAAM;GAAE,MAAMC,GAAe,iBAAiB;GAAE,YAAY;GAAO;EACnE,cAAc;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAM;EAC1E,OAAO;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAM;EACnE,OAAO;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAO;EACpE,SAAS;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAO;EACtE,UAAU;GAAE,MAAMA,GAAe,MAAM;GAAE,YAAY;GAAM;EAC5D;CACF,CAAC"}

package/dist/docs/service-business-os.docblock.js

@@ -106,4 +106,5 @@ registerDocBlocks([
 	}
 ]);
 
-//#endregion
+//#endregion
+//# sourceMappingURL=service-business-os.docblock.js.map

package/dist/docs/service-business-os.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-business-os.docblock.js","names":[],"sources":["../../src/docs/service-business-os.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@lssm/lib.contracts/docs';\nimport { registerDocBlocks } from '@lssm/lib.contracts/docs';\n\nconst serviceBusinessDocBlocks: DocBlock[] = [\n  {\n    id: 'docs.examples.service-business-os',\n    title: 'Service Business OS',\n    summary:\n      'Field/service business flow from client intake to quote, job scheduling, invoicing, and payments with notifications and audit trail.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/examples/service-business-os',\n    tags: ['services', 'quotes', 'jobs', 'invoices', 'payments'],\n    body: `## Flows\n\n1) **Client intake** → create client, capture contact + owner.\n2) **Quote** → draft, send, accept/reject (events + notifications).\n3) **Job** → schedule, assign technician, complete with notes and attachments.\n4) **Invoice** → issue after completion, track status.\n5) **Payment** → record payment and emit analytics/audit.\n\n## Modules reused\n- Identity/RBAC for org + roles\n- Files for attachments (proposals, receipts)\n- Notifications for quote sent/accepted, job reminders, overdue invoices\n- Jobs for reminder/schedule tasks\n- Audit trail for all lifecycle changes\n\n## Presentations\n- Dashboard, client list, quote list/detail, job board, invoice list, payment list (React + Markdown targets).\n`,\n  },\n  {\n    id: 'docs.examples.service-business-os.goal',\n    title: 'Service Business OS — Goal',\n    summary: 'Why this field-service OS exists and outcomes it targets.',\n    kind: 'goal',\n    visibility: 'public',\n    route: '/docs/examples/service-business-os/goal',\n    tags: ['services', 'goal'],\n    body: `## Why it matters\n- Provides a regenerable, end-to-end service lifecycle (client → quote → job → invoice → payment).\n- Keeps pricing, scheduling, invoicing, and payments consistent across surfaces.\n\n## Business/Product goal\n- Deliver auditable quotes/jobs/invoices with notifications and reminders.\n- Support attachments and PII-safe flows; stage new payment rules via feature flags.\n\n## Success criteria\n- Spec changes regenerate UI/API/events cleanly across lifecycle steps.\n- Audit/Notifications/Jobs remain wired for every mutation.`,\n  },\n  {\n    id: 'docs.examples.service-business-os.usage',\n    title: 'Service Business OS — Usage',\n    summary: 'How to operate, extend, and regenerate the service OS safely.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/examples/service-business-os/usage',\n    tags: ['services', 'usage'],\n    body: `## Setup\n1) Seed (if provided) or create client → quote → job → invoice → payment via UI.\n2) Configure Files for attachments and Notifications for quote/job/invoice events.\n\n## Extend & regenerate\n1) Adjust schemas: quote line items, job statuses, invoice terms, payment methods.\n2) Regenerate to sync UI/API/events; mark PII paths in policy.\n3) Use Feature Flags to trial new payment rules or reminder cadences.\n\n## Guardrails\n- Emit events for quote accepted/rejected, job scheduled/completed, invoice overdue, payment recorded.\n- Keep pricing/tax rules explicit in spec; avoid implicit handler math.\n- Use Audit Trail for lifecycle mutations; schedule reminders via Jobs.`,\n  },\n  {\n    id: 'docs.examples.service-business-os.constraints',\n    title: 'Service Business OS — Constraints & Safety',\n    summary:\n      'Internal guardrails for quotes/jobs/invoices/payments and regeneration safety.',\n    kind: 'reference',\n    visibility: 'internal',\n    route: '/docs/examples/service-business-os/constraints',\n    tags: ['services', 'constraints', 'internal'],\n    body: `## Constraints\n- Commission/tax/payment rules must be explicit in spec; no hidden handler math.\n- Events to emit: quote.sent/accepted/rejected, job.scheduled/completed, invoice.issued/overdue, payment.recorded.\n- Regeneration must not alter payment semantics without reviewed spec changes.\n\n## PII & Attachments\n- Mark PII paths (client contact, address); redact in markdown/JSON.\n- Files (quotes, receipts) should use presigned URLs with scoped access.\n\n## Verification\n- Add fixtures for quote/job/invoice state transitions.\n- Ensure Notifications/Audit/Jobs wiring persists after regeneration.\n- Use Feature Flags to trial new payment rules/reminder cadences; default safe/off.`,\n  },\n];\n\nregisterDocBlocks(serviceBusinessDocBlocks);\n"],"mappings":";;;;AAmGA,kBAhG6C;CAC3C;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAY;GAAU;GAAQ;GAAY;GAAW;EAC5D,MAAM;;;;;;;;;;;;;;;;;;EAkBP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,YAAY,OAAO;EAC1B,MAAM;;;;;;;;;;;EAWP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,YAAY,QAAQ;EAC3B,MAAM;;;;;;;;;;;;;EAaP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAY;GAAe;GAAW;EAC7C,MAAM;;;;;;;;;;;;;EAaP;CACF,CAE0C"}