@contractspec/example.crm-pipeline 1.44.0

package/dist/deal/deal.schema.js

@@ -0,0 +1,286 @@
+import { DealStatusEnum, DealStatusFilterEnum } from "./deal.enum.js";
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+
+//#region src/deal/deal.schema.ts
+/**
+* A deal in the CRM pipeline.
+*/
+const DealModel = defineSchemaModel({
+	name: "Deal",
+	description: "A deal in the CRM pipeline",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		value: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		currency: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		pipelineId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		stageId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		status: {
+			type: DealStatusEnum,
+			isOptional: false
+		},
+		contactId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		companyId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		ownerId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		expectedCloseDate: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		updatedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+/**
+* Input for creating a deal.
+*/
+const CreateDealInputModel = defineSchemaModel({
+	name: "CreateDealInput",
+	description: "Input for creating a deal",
+	fields: {
+		name: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		value: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		currency: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		pipelineId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		stageId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		contactId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		companyId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		expectedCloseDate: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		}
+	}
+});
+/**
+* Input for moving a deal to another stage.
+*/
+const MoveDealInputModel = defineSchemaModel({
+	name: "MoveDealInput",
+	description: "Input for moving a deal to another stage",
+	fields: {
+		dealId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		stageId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		position: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		}
+	}
+});
+/**
+* Payload for deal moved event.
+*/
+const DealMovedPayloadModel = defineSchemaModel({
+	name: "DealMovedPayload",
+	fields: {
+		dealId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		fromStage: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		toStage: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+/**
+* Input for marking a deal as won.
+*/
+const WinDealInputModel = defineSchemaModel({
+	name: "WinDealInput",
+	description: "Input for marking a deal as won",
+	fields: {
+		dealId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		wonSource: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		notes: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		}
+	}
+});
+/**
+* Payload for deal won event.
+*/
+const DealWonPayloadModel = defineSchemaModel({
+	name: "DealWonPayload",
+	fields: {
+		dealId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		value: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		}
+	}
+});
+/**
+* Input for marking a deal as lost.
+*/
+const LoseDealInputModel = defineSchemaModel({
+	name: "LoseDealInput",
+	description: "Input for marking a deal as lost",
+	fields: {
+		dealId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		lostReason: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		notes: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		}
+	}
+});
+/**
+* Payload for deal lost event.
+*/
+const DealLostPayloadModel = defineSchemaModel({
+	name: "DealLostPayload",
+	fields: {
+		dealId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		reason: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+/**
+* Input for listing deals.
+*/
+const ListDealsInputModel = defineSchemaModel({
+	name: "ListDealsInput",
+	description: "Input for listing deals",
+	fields: {
+		pipelineId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		stageId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		status: {
+			type: DealStatusFilterEnum,
+			isOptional: true
+		},
+		ownerId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		search: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		limit: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true,
+			defaultValue: 20
+		},
+		offset: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true,
+			defaultValue: 0
+		}
+	}
+});
+/**
+* Output for listing deals.
+*/
+const ListDealsOutputModel = defineSchemaModel({
+	name: "ListDealsOutput",
+	description: "Output for listing deals",
+	fields: {
+		deals: {
+			type: DealModel,
+			isArray: true,
+			isOptional: false
+		},
+		total: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		totalValue: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		}
+	}
+});
+
+//#endregion
+export { CreateDealInputModel, DealLostPayloadModel, DealModel, DealMovedPayloadModel, DealWonPayloadModel, ListDealsInputModel, ListDealsOutputModel, LoseDealInputModel, MoveDealInputModel, WinDealInputModel };
+//# sourceMappingURL=deal.schema.js.map

package/dist/deal/deal.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deal.schema.js","names":[],"sources":["../../src/deal/deal.schema.ts"],"sourcesContent":["import { defineSchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';\nimport { DealStatusEnum, DealStatusFilterEnum } from './deal.enum';\n\n/**\n * A deal in the CRM pipeline.\n */\nexport const DealModel = defineSchemaModel({\n  name: 'Deal',\n  description: 'A deal in the CRM pipeline',\n  fields: {\n    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    value: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },\n    currency: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    pipelineId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    stageId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    status: { type: DealStatusEnum, isOptional: false },\n    contactId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    companyId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    ownerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    expectedCloseDate: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n    updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\n/**\n * Input for creating a deal.\n */\nexport const CreateDealInputModel = defineSchemaModel({\n  name: 'CreateDealInput',\n  description: 'Input for creating a deal',\n  fields: {\n    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\n    value: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },\n    currency: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    pipelineId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    stageId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    contactId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    companyId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    expectedCloseDate: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n  },\n});\n\n/**\n * Input for moving a deal to another stage.\n */\nexport const MoveDealInputModel = defineSchemaModel({\n  name: 'MoveDealInput',\n  description: 'Input for moving a deal to another stage',\n  fields: {\n    dealId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    stageId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    position: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n  },\n});\n\n/**\n * Payload for deal moved event.\n */\nexport const DealMovedPayloadModel = defineSchemaModel({\n  name: 'DealMovedPayload',\n  fields: {\n    dealId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    fromStage: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    toStage: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\n/**\n * Input for marking a deal as won.\n */\nexport const WinDealInputModel = defineSchemaModel({\n  name: 'WinDealInput',\n  description: 'Input for marking a deal as won',\n  fields: {\n    dealId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    wonSource: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    notes: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\n/**\n * Payload for deal won event.\n */\nexport const DealWonPayloadModel = defineSchemaModel({\n  name: 'DealWonPayload',\n  fields: {\n    dealId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    value: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },\n  },\n});\n\n/**\n * Input for marking a deal as lost.\n */\nexport const LoseDealInputModel = defineSchemaModel({\n  name: 'LoseDealInput',\n  description: 'Input for marking a deal as lost',\n  fields: {\n    dealId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    lostReason: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    notes: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\n/**\n * Payload for deal lost event.\n */\nexport const DealLostPayloadModel = defineSchemaModel({\n  name: 'DealLostPayload',\n  fields: {\n    dealId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\n/**\n * Input for listing deals.\n */\nexport const ListDealsInputModel = defineSchemaModel({\n  name: 'ListDealsInput',\n  description: 'Input for listing deals',\n  fields: {\n    pipelineId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    stageId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    status: { type: DealStatusFilterEnum, isOptional: true },\n    ownerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    search: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    limit: {\n      type: ScalarTypeEnum.Int_unsecure(),\n      isOptional: true,\n      defaultValue: 20,\n    },\n    offset: {\n      type: ScalarTypeEnum.Int_unsecure(),\n      isOptional: true,\n      defaultValue: 0,\n    },\n  },\n});\n\n/**\n * Output for listing deals.\n */\nexport const ListDealsOutputModel = defineSchemaModel({\n  name: 'ListDealsOutput',\n  description: 'Output for listing deals',\n  fields: {\n    deals: { type: DealModel, isArray: true, isOptional: false },\n    total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    totalValue: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },\n  },\n});\n"],"mappings":"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"}

package/dist/deal/index.d.ts

@@ -0,0 +1,4 @@
+import { DealStatusEnum, DealStatusFilterEnum } from "./deal.enum.js";
+import { CreateDealContract, ListDealsContract, LoseDealContract, MoveDealContract, WinDealContract } from "./deal.operation.js";
+import { CreateDealInputModel, DealLostPayloadModel, DealModel, DealMovedPayloadModel, DealWonPayloadModel, ListDealsInputModel, ListDealsOutputModel, LoseDealInputModel, MoveDealInputModel, WinDealInputModel } from "./deal.schema.js";
+export { CreateDealContract, CreateDealInputModel, DealLostPayloadModel, DealModel, DealMovedPayloadModel, DealStatusEnum, DealStatusFilterEnum, DealWonPayloadModel, ListDealsContract, ListDealsInputModel, ListDealsOutputModel, LoseDealContract, LoseDealInputModel, MoveDealContract, MoveDealInputModel, WinDealContract, WinDealInputModel };

package/dist/deal/index.js

@@ -0,0 +1,5 @@
+import { DealStatusEnum, DealStatusFilterEnum } from "./deal.enum.js";
+import { CreateDealInputModel, DealLostPayloadModel, DealModel, DealMovedPayloadModel, DealWonPayloadModel, ListDealsInputModel, ListDealsOutputModel, LoseDealInputModel, MoveDealInputModel, WinDealInputModel } from "./deal.schema.js";
+import { CreateDealContract, ListDealsContract, LoseDealContract, MoveDealContract, WinDealContract } from "./deal.operation.js";
+
+export { CreateDealContract, CreateDealInputModel, DealLostPayloadModel, DealModel, DealMovedPayloadModel, DealStatusEnum, DealStatusFilterEnum, DealWonPayloadModel, ListDealsContract, ListDealsInputModel, ListDealsOutputModel, LoseDealContract, LoseDealInputModel, MoveDealContract, MoveDealInputModel, WinDealContract, WinDealInputModel };

package/dist/docs/crm-pipeline.docblock.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/crm-pipeline.docblock.js

@@ -0,0 +1,100 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/crm-pipeline.docblock.ts
+registerDocBlocks([
+	{
+		id: "docs.examples.crm-pipeline.goal",
+		title: "CRM Pipeline — Goal",
+		summary: "Deals, stages, contacts, companies, and tasks with auditable stage movement.",
+		kind: "goal",
+		visibility: "public",
+		route: "/docs/examples/crm-pipeline/goal",
+		tags: ["crm", "goal"],
+		body: `## Why it matters
+- Regenerable CRM flow for deals/stages without code drift.
+- Ensures stage movement, tasks, and contacts stay aligned across surfaces.
+
+## Business/Product goal
+- Give sales teams a governed pipeline with auditable moves and notifications.
+- Allow experimentation (feature flags) on stage definitions and task flows.
+
+## Success criteria
+- Stage/state changes emit events and remain declarative in spec.
+- PII (contacts) is scoped/redacted in presentations.`
+	},
+	{
+		id: "docs.examples.crm-pipeline.usage",
+		title: "CRM Pipeline — Usage",
+		summary: "How to seed, extend, and regenerate the CRM pipeline.",
+		kind: "usage",
+		visibility: "public",
+		route: "/docs/examples/crm-pipeline/usage",
+		tags: ["crm", "usage"],
+		body: `## Setup
+1) Seed (if available) or create pipeline stages, deals, contacts, companies, tasks.
+2) Configure Notifications for stage changes/tasks; set policy.pii for contact data.
+
+## Extend & regenerate
+1) Adjust stage schema/order, deal fields, task fields in the spec.
+2) Regenerate to sync UI/API/events; ensure kanban/action buttons update.
+3) Use Feature Flags to trial new stages or SLA rules.
+
+## Guardrails
+- Emit events for stage moves and task completions; log to Audit Trail.
+- Keep required fields enforced in contracts; avoid freeform state.
+- Redact contact PII in markdown/JSON outputs.`
+	},
+	{
+		id: "docs.examples.crm-pipeline.reference",
+		title: "CRM Pipeline — Reference",
+		summary: "Entities, contracts, events, and presentations for the CRM template.",
+		kind: "reference",
+		visibility: "public",
+		route: "/docs/examples/crm-pipeline",
+		tags: ["crm", "reference"],
+		body: `## Entities
+- Contact, Company, Deal, Pipeline, Stage, Task.
+
+## Contracts
+- deal/create, stage/move, contact/company CRUD, task create/complete.
+
+## Events
+- deal.created, stage.moved, task.completed, contact.updated.
+
+## Presentations
+- Pipelines/kanban, deal detail, contact/company profiles, task lists.
+
+## Notes
+- Stage definitions should be declarative; enforce via spec and regeneration.
+- Use Notifications for deal/task updates; Audit Trail for state changes.`
+	},
+	{
+		id: "docs.examples.crm-pipeline.constraints",
+		title: "CRM Pipeline — Constraints & Safety",
+		summary: "Internal guardrails for stages, PII, and regeneration semantics in the CRM template.",
+		kind: "reference",
+		visibility: "internal",
+		route: "/docs/examples/crm-pipeline/constraints",
+		tags: [
+			"crm",
+			"constraints",
+			"internal"
+		],
+		body: `## Constraints
+- Stage definitions/order must remain declarative; no imperative overrides in code.
+- Events to emit: deal.created, stage.moved, task.completed, contact.updated (minimum).
+- Regeneration should not alter stage semantics without explicit spec change.
+
+## PII
+- Mark contact/company PII (emails, phones) for redaction in presentations.
+- Ensure MCP/web outputs avoid raw PII when not needed.
+
+## Verification
+- Add fixtures for stage move rules and SLA/task changes.
+- Ensure Audit/Notifications remain wired for stage and task events.
+- Use Feature Flags for experimental stages/SLAs; default safe/off.`
+	}
+]);
+
+//#endregion
+//# sourceMappingURL=crm-pipeline.docblock.js.map

package/dist/docs/crm-pipeline.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crm-pipeline.docblock.js","names":[],"sources":["../../src/docs/crm-pipeline.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst crmPipelineDocBlocks: DocBlock[] = [\n  {\n    id: 'docs.examples.crm-pipeline.goal',\n    title: 'CRM Pipeline — Goal',\n    summary:\n      'Deals, stages, contacts, companies, and tasks with auditable stage movement.',\n    kind: 'goal',\n    visibility: 'public',\n    route: '/docs/examples/crm-pipeline/goal',\n    tags: ['crm', 'goal'],\n    body: `## Why it matters\n- Regenerable CRM flow for deals/stages without code drift.\n- Ensures stage movement, tasks, and contacts stay aligned across surfaces.\n\n## Business/Product goal\n- Give sales teams a governed pipeline with auditable moves and notifications.\n- Allow experimentation (feature flags) on stage definitions and task flows.\n\n## Success criteria\n- Stage/state changes emit events and remain declarative in spec.\n- PII (contacts) is scoped/redacted in presentations.`,\n  },\n  {\n    id: 'docs.examples.crm-pipeline.usage',\n    title: 'CRM Pipeline — Usage',\n    summary: 'How to seed, extend, and regenerate the CRM pipeline.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/examples/crm-pipeline/usage',\n    tags: ['crm', 'usage'],\n    body: `## Setup\n1) Seed (if available) or create pipeline stages, deals, contacts, companies, tasks.\n2) Configure Notifications for stage changes/tasks; set policy.pii for contact data.\n\n## Extend & regenerate\n1) Adjust stage schema/order, deal fields, task fields in the spec.\n2) Regenerate to sync UI/API/events; ensure kanban/action buttons update.\n3) Use Feature Flags to trial new stages or SLA rules.\n\n## Guardrails\n- Emit events for stage moves and task completions; log to Audit Trail.\n- Keep required fields enforced in contracts; avoid freeform state.\n- Redact contact PII in markdown/JSON outputs.`,\n  },\n  {\n    id: 'docs.examples.crm-pipeline.reference',\n    title: 'CRM Pipeline — Reference',\n    summary:\n      'Entities, contracts, events, and presentations for the CRM template.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/examples/crm-pipeline',\n    tags: ['crm', 'reference'],\n    body: `## Entities\n- Contact, Company, Deal, Pipeline, Stage, Task.\n\n## Contracts\n- deal/create, stage/move, contact/company CRUD, task create/complete.\n\n## Events\n- deal.created, stage.moved, task.completed, contact.updated.\n\n## Presentations\n- Pipelines/kanban, deal detail, contact/company profiles, task lists.\n\n## Notes\n- Stage definitions should be declarative; enforce via spec and regeneration.\n- Use Notifications for deal/task updates; Audit Trail for state changes.`,\n  },\n  {\n    id: 'docs.examples.crm-pipeline.constraints',\n    title: 'CRM Pipeline — Constraints & Safety',\n    summary:\n      'Internal guardrails for stages, PII, and regeneration semantics in the CRM template.',\n    kind: 'reference',\n    visibility: 'internal',\n    route: '/docs/examples/crm-pipeline/constraints',\n    tags: ['crm', 'constraints', 'internal'],\n    body: `## Constraints\n- Stage definitions/order must remain declarative; no imperative overrides in code.\n- Events to emit: deal.created, stage.moved, task.completed, contact.updated (minimum).\n- Regeneration should not alter stage semantics without explicit spec change.\n\n## PII\n- Mark contact/company PII (emails, phones) for redaction in presentations.\n- Ensure MCP/web outputs avoid raw PII when not needed.\n\n## Verification\n- Add fixtures for stage move rules and SLA/task changes.\n- Ensure Audit/Notifications remain wired for stage and task events.\n- Use Feature Flags for experimental stages/SLAs; default safe/off.`,\n  },\n];\n\nregisterDocBlocks(crmPipelineDocBlocks);\n"],"mappings":";;;AAiGA,kBA9FyC;CACvC;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,OAAO,OAAO;EACrB,MAAM;;;;;;;;;;;EAWP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,OAAO,QAAQ;EACtB,MAAM;;;;;;;;;;;;;EAaP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,OAAO,YAAY;EAC1B,MAAM;;;;;;;;;;;;;;;EAeP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAO;GAAe;GAAW;EACxC,MAAM;;;;;;;;;;;;;EAaP;CACF,CAEsC"}

package/dist/docs/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/index.js

@@ -0,0 +1 @@
+import "./crm-pipeline.docblock.js";

package/dist/entities/company.entity.d.ts

@@ -0,0 +1,40 @@
+import * as _contractspec_lib_schema198 from "@contractspec/lib.schema";
+
+//#region src/entities/company.entity.d.ts
+/**
+ * Company size enum.
+ */
+declare const CompanySizeEnum: _contractspec_lib_schema198.EntityEnumDef;
+/**
+ * Company entity - organization/account.
+ */
+declare const CompanyEntity: _contractspec_lib_schema198.EntitySpec<{
+  id: _contractspec_lib_schema198.EntityScalarField;
+  name: _contractspec_lib_schema198.EntityScalarField;
+  domain: _contractspec_lib_schema198.EntityScalarField;
+  website: _contractspec_lib_schema198.EntityScalarField;
+  industry: _contractspec_lib_schema198.EntityScalarField;
+  size: _contractspec_lib_schema198.EntityEnumField;
+  employeeCount: _contractspec_lib_schema198.EntityScalarField;
+  annualRevenue: _contractspec_lib_schema198.EntityScalarField;
+  organizationId: _contractspec_lib_schema198.EntityScalarField;
+  ownerId: _contractspec_lib_schema198.EntityScalarField;
+  phone: _contractspec_lib_schema198.EntityScalarField;
+  email: _contractspec_lib_schema198.EntityScalarField;
+  address: _contractspec_lib_schema198.EntityScalarField;
+  city: _contractspec_lib_schema198.EntityScalarField;
+  state: _contractspec_lib_schema198.EntityScalarField;
+  country: _contractspec_lib_schema198.EntityScalarField;
+  postalCode: _contractspec_lib_schema198.EntityScalarField;
+  linkedInUrl: _contractspec_lib_schema198.EntityScalarField;
+  description: _contractspec_lib_schema198.EntityScalarField;
+  tags: _contractspec_lib_schema198.EntityScalarField;
+  customFields: _contractspec_lib_schema198.EntityScalarField;
+  createdAt: _contractspec_lib_schema198.EntityScalarField;
+  updatedAt: _contractspec_lib_schema198.EntityScalarField;
+  contacts: _contractspec_lib_schema198.EntityRelationField;
+  deals: _contractspec_lib_schema198.EntityRelationField;
+}>;
+//#endregion
+export { CompanyEntity, CompanySizeEnum };
+//# sourceMappingURL=company.entity.d.ts.map

package/dist/entities/company.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"company.entity.d.ts","names":[],"sources":["../../src/entities/company.entity.ts"],"sourcesContent":[],"mappings":";;;;;;AAUa,cAAA,eAKX,EAAA,2BAAA,CAL0B,aAK1B;AAKF;;;cAAa,2CAAa;MAwDxB,2BAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;0DAxDwB;EAAA,QAAA,iDAAA"}

package/dist/entities/company.entity.js

@@ -0,0 +1,63 @@
+import { defineEntity, defineEntityEnum, field, index } from "@contractspec/lib.schema";
+
+//#region src/entities/company.entity.ts
+/**
+* Company size enum.
+*/
+const CompanySizeEnum = defineEntityEnum({
+	name: "CompanySize",
+	values: [
+		"STARTUP",
+		"SMALL",
+		"MEDIUM",
+		"LARGE",
+		"ENTERPRISE"
+	],
+	schema: "crm",
+	description: "Size category of a company."
+});
+/**
+* Company entity - organization/account.
+*/
+const CompanyEntity = defineEntity({
+	name: "Company",
+	description: "A company/organization in the CRM.",
+	schema: "crm",
+	map: "company",
+	fields: {
+		id: field.id({ description: "Unique company ID" }),
+		name: field.string({ description: "Company name" }),
+		domain: field.string({
+			isOptional: true,
+			description: "Website domain"
+		}),
+		website: field.url({ isOptional: true }),
+		industry: field.string({ isOptional: true }),
+		size: field.enum("CompanySize", { isOptional: true }),
+		employeeCount: field.int({ isOptional: true }),
+		annualRevenue: field.decimal({ isOptional: true }),
+		organizationId: field.foreignKey(),
+		ownerId: field.foreignKey({ description: "Account owner" }),
+		phone: field.string({ isOptional: true }),
+		email: field.email({ isOptional: true }),
+		address: field.string({ isOptional: true }),
+		city: field.string({ isOptional: true }),
+		state: field.string({ isOptional: true }),
+		country: field.string({ isOptional: true }),
+		postalCode: field.string({ isOptional: true }),
+		linkedInUrl: field.url({ isOptional: true }),
+		description: field.string({ isOptional: true }),
+		tags: field.string({ isArray: true }),
+		customFields: field.json({ isOptional: true }),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		contacts: field.hasMany("Contact"),
+		deals: field.hasMany("Deal")
+	},
+	indexes: [index.on(["organizationId", "ownerId"]), index.on(["domain"])],
+	enums: [CompanySizeEnum]
+});
+
+//#endregion
+export { CompanyEntity, CompanySizeEnum };
+//# sourceMappingURL=company.entity.js.map

package/dist/entities/company.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"company.entity.js","names":[],"sources":["../../src/entities/company.entity.ts"],"sourcesContent":["import {\n  defineEntity,\n  defineEntityEnum,\n  field,\n  index,\n} from '@contractspec/lib.schema';\n\n/**\n * Company size enum.\n */\nexport const CompanySizeEnum = defineEntityEnum({\n  name: 'CompanySize',\n  values: ['STARTUP', 'SMALL', 'MEDIUM', 'LARGE', 'ENTERPRISE'] as const,\n  schema: 'crm',\n  description: 'Size category of a company.',\n});\n\n/**\n * Company entity - organization/account.\n */\nexport const CompanyEntity = defineEntity({\n  name: 'Company',\n  description: 'A company/organization in the CRM.',\n  schema: 'crm',\n  map: 'company',\n  fields: {\n    id: field.id({ description: 'Unique company ID' }),\n\n    // Basic info\n    name: field.string({ description: 'Company name' }),\n    domain: field.string({ isOptional: true, description: 'Website domain' }),\n    website: field.url({ isOptional: true }),\n\n    // Industry\n    industry: field.string({ isOptional: true }),\n\n    // Size\n    size: field.enum('CompanySize', { isOptional: true }),\n    employeeCount: field.int({ isOptional: true }),\n    annualRevenue: field.decimal({ isOptional: true }),\n\n    // Ownership\n    organizationId: field.foreignKey(),\n    ownerId: field.foreignKey({ description: 'Account owner' }),\n\n    // Contact info\n    phone: field.string({ isOptional: true }),\n    email: field.email({ isOptional: true }),\n\n    // Address\n    address: field.string({ isOptional: true }),\n    city: field.string({ isOptional: true }),\n    state: field.string({ isOptional: true }),\n    country: field.string({ isOptional: true }),\n    postalCode: field.string({ isOptional: true }),\n\n    // Social\n    linkedInUrl: field.url({ isOptional: true }),\n\n    // Notes\n    description: field.string({ isOptional: true }),\n    tags: field.string({ isArray: true }),\n\n    // Custom fields\n    customFields: field.json({ isOptional: true }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n\n    // Relations\n    contacts: field.hasMany('Contact'),\n    deals: field.hasMany('Deal'),\n  },\n  indexes: [index.on(['organizationId', 'ownerId']), index.on(['domain'])],\n  enums: [CompanySizeEnum],\n});\n"],"mappings":";;;;;;AAUA,MAAa,kBAAkB,iBAAiB;CAC9C,MAAM;CACN,QAAQ;EAAC;EAAW;EAAS;EAAU;EAAS;EAAa;CAC7D,QAAQ;CACR,aAAa;CACd,CAAC;;;;AAKF,MAAa,gBAAgB,aAAa;CACxC,MAAM;CACN,aAAa;CACb,QAAQ;CACR,KAAK;CACL,QAAQ;EACN,IAAI,MAAM,GAAG,EAAE,aAAa,qBAAqB,CAAC;EAGlD,MAAM,MAAM,OAAO,EAAE,aAAa,gBAAgB,CAAC;EACnD,QAAQ,MAAM,OAAO;GAAE,YAAY;GAAM,aAAa;GAAkB,CAAC;EACzE,SAAS,MAAM,IAAI,EAAE,YAAY,MAAM,CAAC;EAGxC,UAAU,MAAM,OAAO,EAAE,YAAY,MAAM,CAAC;EAG5C,MAAM,MAAM,KAAK,eAAe,EAAE,YAAY,MAAM,CAAC;EACrD,eAAe,MAAM,IAAI,EAAE,YAAY,MAAM,CAAC;EAC9C,eAAe,MAAM,QAAQ,EAAE,YAAY,MAAM,CAAC;EAGlD,gBAAgB,MAAM,YAAY;EAClC,SAAS,MAAM,WAAW,EAAE,aAAa,iBAAiB,CAAC;EAG3D,OAAO,MAAM,OAAO,EAAE,YAAY,MAAM,CAAC;EACzC,OAAO,MAAM,MAAM,EAAE,YAAY,MAAM,CAAC;EAGxC,SAAS,MAAM,OAAO,EAAE,YAAY,MAAM,CAAC;EAC3C,MAAM,MAAM,OAAO,EAAE,YAAY,MAAM,CAAC;EACxC,OAAO,MAAM,OAAO,EAAE,YAAY,MAAM,CAAC;EACzC,SAAS,MAAM,OAAO,EAAE,YAAY,MAAM,CAAC;EAC3C,YAAY,MAAM,OAAO,EAAE,YAAY,MAAM,CAAC;EAG9C,aAAa,MAAM,IAAI,EAAE,YAAY,MAAM,CAAC;EAG5C,aAAa,MAAM,OAAO,EAAE,YAAY,MAAM,CAAC;EAC/C,MAAM,MAAM,OAAO,EAAE,SAAS,MAAM,CAAC;EAGrC,cAAc,MAAM,KAAK,EAAE,YAAY,MAAM,CAAC;EAG9C,WAAW,MAAM,WAAW;EAC5B,WAAW,MAAM,WAAW;EAG5B,UAAU,MAAM,QAAQ,UAAU;EAClC,OAAO,MAAM,QAAQ,OAAO;EAC7B;CACD,SAAS,CAAC,MAAM,GAAG,CAAC,kBAAkB,UAAU,CAAC,EAAE,MAAM,GAAG,CAAC,SAAS,CAAC,CAAC;CACxE,OAAO,CAAC,gBAAgB;CACzB,CAAC"}

package/dist/entities/contact.entity.d.ts

@@ -0,0 +1,44 @@
+import * as _contractspec_lib_schema225 from "@contractspec/lib.schema";
+
+//#region src/entities/contact.entity.d.ts
+/**
+ * Contact status enum.
+ */
+declare const ContactStatusEnum: _contractspec_lib_schema225.EntityEnumDef;
+/**
+ * Contact entity - individual person.
+ */
+declare const ContactEntity: _contractspec_lib_schema225.EntitySpec<{
+  id: _contractspec_lib_schema225.EntityScalarField;
+  firstName: _contractspec_lib_schema225.EntityScalarField;
+  lastName: _contractspec_lib_schema225.EntityScalarField;
+  email: _contractspec_lib_schema225.EntityScalarField;
+  phone: _contractspec_lib_schema225.EntityScalarField;
+  companyId: _contractspec_lib_schema225.EntityScalarField;
+  jobTitle: _contractspec_lib_schema225.EntityScalarField;
+  status: _contractspec_lib_schema225.EntityEnumField;
+  organizationId: _contractspec_lib_schema225.EntityScalarField;
+  ownerId: _contractspec_lib_schema225.EntityScalarField;
+  source: _contractspec_lib_schema225.EntityScalarField;
+  linkedInUrl: _contractspec_lib_schema225.EntityScalarField;
+  twitterHandle: _contractspec_lib_schema225.EntityScalarField;
+  address: _contractspec_lib_schema225.EntityScalarField;
+  city: _contractspec_lib_schema225.EntityScalarField;
+  state: _contractspec_lib_schema225.EntityScalarField;
+  country: _contractspec_lib_schema225.EntityScalarField;
+  postalCode: _contractspec_lib_schema225.EntityScalarField;
+  notes: _contractspec_lib_schema225.EntityScalarField;
+  tags: _contractspec_lib_schema225.EntityScalarField;
+  customFields: _contractspec_lib_schema225.EntityScalarField;
+  lastContactedAt: _contractspec_lib_schema225.EntityScalarField;
+  nextFollowUpAt: _contractspec_lib_schema225.EntityScalarField;
+  createdAt: _contractspec_lib_schema225.EntityScalarField;
+  updatedAt: _contractspec_lib_schema225.EntityScalarField;
+  company: _contractspec_lib_schema225.EntityRelationField;
+  deals: _contractspec_lib_schema225.EntityRelationField;
+  tasks: _contractspec_lib_schema225.EntityRelationField;
+  activities: _contractspec_lib_schema225.EntityRelationField;
+}>;
+//#endregion
+export { ContactEntity, ContactStatusEnum };
+//# sourceMappingURL=contact.entity.d.ts.map

package/dist/entities/contact.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact.entity.d.ts","names":[],"sources":["../../src/entities/contact.entity.ts"],"sourcesContent":[],"mappings":";;;;;;AAUa,cAAA,iBAKX,EAAA,2BAAA,CAL4B,aAK5B;AAKF;;;cAAa,2CAAa;MAwExB,2BAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;wDAxEwB;EAAA,KAAA,iDAAA"}