@contractspec/example.crm-pipeline 1.57.0 → 1.59.0

package/dist/node/events/deal.event.js

@@ -0,0 +1,101 @@
+// src/events/deal.event.ts
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineEvent } from "@contractspec/lib.contracts";
+var DealCreatedPayload = defineSchemaModel({
+  name: "DealCreatedPayload",
+  description: "Payload when a deal is created",
+  fields: {
+    dealId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    value: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    pipelineId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    stageId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    ownerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var DealMovedPayload = defineSchemaModel({
+  name: "DealMovedEventPayload",
+  description: "Payload when a deal is moved to another stage",
+  fields: {
+    dealId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    fromStageId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    toStageId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    movedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    movedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var DealWonPayload = defineSchemaModel({
+  name: "DealWonEventPayload",
+  description: "Payload when a deal is won",
+  fields: {
+    dealId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    value: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    currency: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    contactId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    companyId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    ownerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    wonAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var DealLostPayload = defineSchemaModel({
+  name: "DealLostEventPayload",
+  description: "Payload when a deal is lost",
+  fields: {
+    dealId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    value: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    ownerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    lostAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var DealCreatedEvent = defineEvent({
+  meta: {
+    key: "deal.created",
+    version: "1.0.0",
+    description: "A new deal has been created.",
+    stability: "stable",
+    owners: ["@crm-team"],
+    tags: ["deal", "created"]
+  },
+  payload: DealCreatedPayload
+});
+var DealMovedEvent = defineEvent({
+  meta: {
+    key: "deal.moved",
+    version: "1.0.0",
+    description: "A deal has been moved to a different stage.",
+    stability: "stable",
+    owners: ["@crm-team"],
+    tags: ["deal", "moved"]
+  },
+  payload: DealMovedPayload
+});
+var DealWonEvent = defineEvent({
+  meta: {
+    key: "deal.won",
+    version: "1.0.0",
+    description: "A deal has been won.",
+    stability: "stable",
+    owners: ["@crm-team"],
+    tags: ["deal", "won"]
+  },
+  payload: DealWonPayload
+});
+var DealLostEvent = defineEvent({
+  meta: {
+    key: "deal.lost",
+    version: "1.0.0",
+    description: "A deal has been lost.",
+    stability: "stable",
+    owners: ["@crm-team"],
+    tags: ["deal", "lost"]
+  },
+  payload: DealLostPayload
+});
+export {
+  DealWonEvent,
+  DealMovedEvent,
+  DealLostEvent,
+  DealCreatedEvent
+};

package/dist/node/events/index.js

@@ -0,0 +1,158 @@
+// src/events/contact.event.ts
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineEvent } from "@contractspec/lib.contracts";
+var ContactCreatedPayload = defineSchemaModel({
+  name: "ContactCreatedPayload",
+  description: "Payload when a contact is created",
+  fields: {
+    contactId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    email: { type: ScalarTypeEnum.EmailAddress(), isOptional: true },
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    ownerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var ContactCreatedEvent = defineEvent({
+  meta: {
+    key: "contact.created",
+    version: "1.0.0",
+    description: "A new contact has been created.",
+    stability: "stable",
+    owners: ["@crm-team"],
+    tags: ["contact", "created"]
+  },
+  payload: ContactCreatedPayload
+});
+
+// src/events/deal.event.ts
+import { ScalarTypeEnum as ScalarTypeEnum2, defineSchemaModel as defineSchemaModel2 } from "@contractspec/lib.schema";
+import { defineEvent as defineEvent2 } from "@contractspec/lib.contracts";
+var DealCreatedPayload = defineSchemaModel2({
+  name: "DealCreatedPayload",
+  description: "Payload when a deal is created",
+  fields: {
+    dealId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    value: { type: ScalarTypeEnum2.Float_unsecure(), isOptional: false },
+    pipelineId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    stageId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    ownerId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    createdAt: { type: ScalarTypeEnum2.DateTime(), isOptional: false }
+  }
+});
+var DealMovedPayload = defineSchemaModel2({
+  name: "DealMovedEventPayload",
+  description: "Payload when a deal is moved to another stage",
+  fields: {
+    dealId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    fromStageId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    toStageId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    movedBy: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    movedAt: { type: ScalarTypeEnum2.DateTime(), isOptional: false }
+  }
+});
+var DealWonPayload = defineSchemaModel2({
+  name: "DealWonEventPayload",
+  description: "Payload when a deal is won",
+  fields: {
+    dealId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    value: { type: ScalarTypeEnum2.Float_unsecure(), isOptional: false },
+    currency: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    contactId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
+    companyId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
+    ownerId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    wonAt: { type: ScalarTypeEnum2.DateTime(), isOptional: false }
+  }
+});
+var DealLostPayload = defineSchemaModel2({
+  name: "DealLostEventPayload",
+  description: "Payload when a deal is lost",
+  fields: {
+    dealId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    value: { type: ScalarTypeEnum2.Float_unsecure(), isOptional: false },
+    reason: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    ownerId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    lostAt: { type: ScalarTypeEnum2.DateTime(), isOptional: false }
+  }
+});
+var DealCreatedEvent = defineEvent2({
+  meta: {
+    key: "deal.created",
+    version: "1.0.0",
+    description: "A new deal has been created.",
+    stability: "stable",
+    owners: ["@crm-team"],
+    tags: ["deal", "created"]
+  },
+  payload: DealCreatedPayload
+});
+var DealMovedEvent = defineEvent2({
+  meta: {
+    key: "deal.moved",
+    version: "1.0.0",
+    description: "A deal has been moved to a different stage.",
+    stability: "stable",
+    owners: ["@crm-team"],
+    tags: ["deal", "moved"]
+  },
+  payload: DealMovedPayload
+});
+var DealWonEvent = defineEvent2({
+  meta: {
+    key: "deal.won",
+    version: "1.0.0",
+    description: "A deal has been won.",
+    stability: "stable",
+    owners: ["@crm-team"],
+    tags: ["deal", "won"]
+  },
+  payload: DealWonPayload
+});
+var DealLostEvent = defineEvent2({
+  meta: {
+    key: "deal.lost",
+    version: "1.0.0",
+    description: "A deal has been lost.",
+    stability: "stable",
+    owners: ["@crm-team"],
+    tags: ["deal", "lost"]
+  },
+  payload: DealLostPayload
+});
+
+// src/events/task.event.ts
+import { ScalarTypeEnum as ScalarTypeEnum3, defineSchemaModel as defineSchemaModel3 } from "@contractspec/lib.schema";
+import { defineEvent as defineEvent3 } from "@contractspec/lib.contracts";
+var TaskCompletedPayload = defineSchemaModel3({
+  name: "TaskCompletedPayload",
+  description: "Payload when a task is completed",
+  fields: {
+    taskId: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false },
+    type: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false },
+    assignedTo: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false },
+    completedBy: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false },
+    completedAt: { type: ScalarTypeEnum3.DateTime(), isOptional: false }
+  }
+});
+var TaskCompletedEvent = defineEvent3({
+  meta: {
+    key: "task.completed",
+    version: "1.0.0",
+    description: "A task has been completed.",
+    stability: "stable",
+    owners: ["@crm-team"],
+    tags: ["task", "lifecycle"]
+  },
+  payload: TaskCompletedPayload
+});
+export {
+  TaskCompletedEvent,
+  DealWonEvent,
+  DealMovedEvent,
+  DealLostEvent,
+  DealCreatedEvent,
+  ContactCreatedEvent
+};

package/dist/node/events/task.event.js

@@ -0,0 +1,28 @@
+// src/events/task.event.ts
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineEvent } from "@contractspec/lib.contracts";
+var TaskCompletedPayload = defineSchemaModel({
+  name: "TaskCompletedPayload",
+  description: "Payload when a task is completed",
+  fields: {
+    taskId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    type: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    assignedTo: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    completedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var TaskCompletedEvent = defineEvent({
+  meta: {
+    key: "task.completed",
+    version: "1.0.0",
+    description: "A task has been completed.",
+    stability: "stable",
+    owners: ["@crm-team"],
+    tags: ["task", "lifecycle"]
+  },
+  payload: TaskCompletedPayload
+});
+export {
+  TaskCompletedEvent
+};

package/dist/node/example.js

@@ -0,0 +1,39 @@
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var example = defineExample({
+  meta: {
+    key: "crm-pipeline",
+    version: "1.0.0",
+    title: "CRM Pipeline",
+    description: "Sales CRM with contacts, companies, deals, pipelines, and tasks.",
+    kind: "template",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.core"],
+    tags: ["crm", "sales", "pipeline", "deals"]
+  },
+  docs: {
+    rootDocId: "docs.examples.crm-pipeline"
+  },
+  entrypoints: {
+    packageName: "@contractspec/example.crm-pipeline",
+    feature: "./feature",
+    contracts: "./contracts",
+    presentations: "./presentations",
+    handlers: "./handlers",
+    docs: "./docs"
+  },
+  surfaces: {
+    templates: true,
+    sandbox: {
+      enabled: true,
+      modes: ["playground", "specs", "builder", "markdown", "evolution"]
+    },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true }
+  }
+});
+var example_default = example;
+export {
+  example_default as default
+};

package/dist/node/handlers/crm.handlers.js

@@ -0,0 +1,160 @@
+// src/handlers/crm.handlers.ts
+import { web } from "@contractspec/lib.runtime-sandbox";
+var { generateId } = web;
+function rowToDeal(row) {
+  return {
+    id: row.id,
+    projectId: row.projectId,
+    name: row.name,
+    value: row.value,
+    currency: row.currency,
+    pipelineId: row.pipelineId,
+    stageId: row.stageId,
+    status: row.status,
+    contactId: row.contactId ?? undefined,
+    companyId: row.companyId ?? undefined,
+    ownerId: row.ownerId,
+    expectedCloseDate: row.expectedCloseDate ? new Date(row.expectedCloseDate) : undefined,
+    wonSource: row.wonSource ?? undefined,
+    lostReason: row.lostReason ?? undefined,
+    notes: row.notes ?? undefined,
+    createdAt: new Date(row.createdAt),
+    updatedAt: new Date(row.updatedAt)
+  };
+}
+function createCrmHandlers(db) {
+  async function listDeals(input) {
+    const {
+      projectId,
+      pipelineId,
+      stageId,
+      status,
+      ownerId,
+      search,
+      limit = 20,
+      offset = 0
+    } = input;
+    let whereClause = "WHERE projectId = ?";
+    const params = [projectId];
+    if (pipelineId) {
+      whereClause += " AND pipelineId = ?";
+      params.push(pipelineId);
+    }
+    if (stageId) {
+      whereClause += " AND stageId = ?";
+      params.push(stageId);
+    }
+    if (status && status !== "all") {
+      whereClause += " AND status = ?";
+      params.push(status);
+    }
+    if (ownerId) {
+      whereClause += " AND ownerId = ?";
+      params.push(ownerId);
+    }
+    if (search) {
+      whereClause += " AND name LIKE ?";
+      params.push(`%${search}%`);
+    }
+    const countResult = (await db.query(`SELECT COUNT(*) as count FROM crm_deal ${whereClause}`, params)).rows;
+    const total = countResult[0]?.count ?? 0;
+    const valueResult = (await db.query(`SELECT COALESCE(SUM(value), 0) as total FROM crm_deal ${whereClause}`, params)).rows;
+    const totalValue = valueResult[0]?.total ?? 0;
+    const dealRows = (await db.query(`SELECT * FROM crm_deal ${whereClause} ORDER BY value DESC LIMIT ? OFFSET ?`, [...params, limit, offset])).rows;
+    return {
+      deals: dealRows.map(rowToDeal),
+      total,
+      totalValue
+    };
+  }
+  async function createDeal(input, context) {
+    const id = generateId("deal");
+    const now = new Date().toISOString();
+    await db.execute(`INSERT INTO crm_deal (id, projectId, pipelineId, stageId, name, value, currency, status, contactId, companyId, ownerId, expectedCloseDate, createdAt, updatedAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+      id,
+      context.projectId,
+      input.pipelineId,
+      input.stageId,
+      input.name,
+      input.value,
+      input.currency ?? "USD",
+      "OPEN",
+      input.contactId ?? null,
+      input.companyId ?? null,
+      context.ownerId,
+      input.expectedCloseDate?.toISOString() ?? null,
+      now,
+      now
+    ]);
+    const rows = (await db.query(`SELECT * FROM crm_deal WHERE id = ?`, [id])).rows;
+    if (!rows[0]) {
+      throw new Error("Failed to create deal");
+    }
+    return rowToDeal(rows[0]);
+  }
+  async function moveDeal(input) {
+    const now = new Date().toISOString();
+    const existing = (await db.query(`SELECT * FROM crm_deal WHERE id = ?`, [input.dealId])).rows;
+    if (!existing[0]) {
+      throw new Error("NOT_FOUND");
+    }
+    const stage = (await db.query(`SELECT * FROM crm_stage WHERE id = ?`, [input.stageId])).rows;
+    if (!stage[0]) {
+      throw new Error("INVALID_STAGE");
+    }
+    await db.execute(`UPDATE crm_deal SET stageId = ?, updatedAt = ? WHERE id = ?`, [input.stageId, now, input.dealId]);
+    const rows = (await db.query(`SELECT * FROM crm_deal WHERE id = ?`, [input.dealId])).rows;
+    return rowToDeal(rows[0]);
+  }
+  async function winDeal(input) {
+    const now = new Date().toISOString();
+    const existing = (await db.query(`SELECT * FROM crm_deal WHERE id = ?`, [input.dealId])).rows;
+    if (!existing[0]) {
+      throw new Error("NOT_FOUND");
+    }
+    await db.execute(`UPDATE crm_deal SET status = 'WON', wonSource = ?, notes = ?, updatedAt = ? WHERE id = ?`, [input.wonSource ?? null, input.notes ?? null, now, input.dealId]);
+    const rows = (await db.query(`SELECT * FROM crm_deal WHERE id = ?`, [input.dealId])).rows;
+    return rowToDeal(rows[0]);
+  }
+  async function loseDeal(input) {
+    const now = new Date().toISOString();
+    const existing = (await db.query(`SELECT * FROM crm_deal WHERE id = ?`, [input.dealId])).rows;
+    if (!existing[0]) {
+      throw new Error("NOT_FOUND");
+    }
+    await db.execute(`UPDATE crm_deal SET status = 'LOST', lostReason = ?, notes = ?, updatedAt = ? WHERE id = ?`, [input.lostReason, input.notes ?? null, now, input.dealId]);
+    const rows = (await db.query(`SELECT * FROM crm_deal WHERE id = ?`, [input.dealId])).rows;
+    return rowToDeal(rows[0]);
+  }
+  async function getDealsByStage(input) {
+    const deals = (await db.query(`SELECT * FROM crm_deal WHERE projectId = ? AND pipelineId = ? AND status = 'OPEN' ORDER BY value DESC`, [input.projectId, input.pipelineId])).rows;
+    const stages = (await db.query(`SELECT * FROM crm_stage WHERE pipelineId = ? ORDER BY position`, [input.pipelineId])).rows;
+    const grouped = {};
+    for (const stage of stages) {
+      grouped[stage.id] = deals.filter((d) => d.stageId === stage.id).map(rowToDeal);
+    }
+    return grouped;
+  }
+  async function getPipelineStages(input) {
+    const rows = (await db.query(`SELECT * FROM crm_stage WHERE pipelineId = ? ORDER BY position`, [input.pipelineId])).rows;
+    return rows.map((row) => ({
+      id: row.id,
+      pipelineId: row.pipelineId,
+      name: row.name,
+      position: row.position
+    }));
+  }
+  return {
+    listDeals,
+    createDeal,
+    moveDeal,
+    winDeal,
+    loseDeal,
+    getDealsByStage,
+    getPipelineStages
+  };
+}
+export {
+  createCrmHandlers
+};