@nbt-dev/nbt 0.0.1 → 0.0.4

package/stdlib/crm/adapters/gohighlevel/tests/fixtures/webhooks/v2_pipelines_pilot.json

@@ -0,0 +1,137 @@
+{
+  "pipelines": [
+    {
+      "id": "UxTCmFzbqr6IxQAIXqnD",
+      "name": "MLP SM Pipeline",
+      "opportunityCount": 12,
+      "stages": [
+        {
+          "id": "64cd63b4-bdc4-48c6-a58f-33f0ae4066fb",
+          "name": "Hot Leads (First 48 Hours)"
+        },
+        {
+          "id": "fb7c6191-ec24-435f-b61a-ec721c0aa513",
+          "name": "Warm Leads (Day 3-10)"
+        },
+        {
+          "id": "e78b46a1-0da9-496f-a8f1-1d4eca89d3a7",
+          "name": "Cool Leads (Day 10+)"
+        },
+        {
+          "id": "ae0e6d15-7556-4dbe-81bb-9154f29cbdc4",
+          "name": "Lead Replied"
+        },
+        {
+          "id": "17a4170c-3841-4901-9232-7be58f875319",
+          "name": "Currently Working"
+        },
+        {
+          "id": "811da9ed-4b67-47ac-8d58-1ef7f43d0ba9",
+          "name": "Workflow Reentry"
+        },
+        {
+          "id": "aeaecfd9-2c51-49cc-9aa8-d341a84c8d3d",
+          "name": "Discovery Call on Funnel"
+        },
+        {
+          "id": "14787095-0a31-4067-b7fd-f4ab785c3bcc",
+          "name": "Appointment Set"
+        },
+        {
+          "id": "f67e73cf-84e3-4dee-b6a0-91d913ff949c",
+          "name": "Task Set"
+        },
+        {
+          "id": "db326b60-09ad-42d4-81b6-303ee42fd6af",
+          "name": "Never Responded"
+        },
+        {
+          "id": "faa35266-9b4c-48b3-8438-9f2d782ce7b2",
+          "name": "Disqualified"
+        },
+        {
+          "id": "814e0795-abcc-46de-8256-631a93102c61",
+          "name": "Not Interested"
+        }
+      ]
+    },
+    {
+      "id": "286FgIGF2NMRoTJS4o5z",
+      "name": "Rehash Lori & Susan",
+      "opportunityCount": 3107,
+      "stages": [
+        {
+          "id": "5dbe3b2d-1e6b-47a7-a7b7-39e9336eae76",
+          "name": "No Show"
+        },
+        {
+          "id": "29c54677-e7f0-4715-a3fb-5025b7b00f6a",
+          "name": "Needs to Reschedule"
+        },
+        {
+          "id": "010541a1-220e-4715-9143-a04e27f90cfe",
+          "name": "Appointment Refused"
+        },
+        {
+          "id": "3e3dbf3c-cfc9-40a8-b48d-f14c46b7c9d3",
+          "name": "Appointment Reset"
+        }
+      ]
+    },
+    {
+      "id": "Rz9YDTwgtB7oZSEnr7Q0",
+      "name": "MLP Skynet Pipeline",
+      "opportunityCount": 212,
+      "stages": [
+        {
+          "id": "e3b2b805-4377-4591-a2db-af013d4a1989",
+          "name": "Hot Leads (First 48 Hours)"
+        },
+        {
+          "id": "5799baa2-4c47-4715-a509-b4bde322b8b6",
+          "name": "Warm Leads (Day 3-10)"
+        },
+        {
+          "id": "39f0bc73-9d2e-43ba-a196-97913f1134e3",
+          "name": "Cool Leads (Day 10+)"
+        },
+        {
+          "id": "25cbf317-87fe-4b17-b643-5cfc8e03a3c3",
+          "name": "Lead Replied"
+        },
+        {
+          "id": "6dbf45fa-1f35-4c41-9887-4813043f9f9d",
+          "name": "Currently Working"
+        },
+        {
+          "id": "76b07f0d-df0f-4c32-bfd5-b225a7b38503",
+          "name": "Workflow Reentry"
+        },
+        {
+          "id": "880c1db8-67ef-41bb-bbb9-43060daea2c4",
+          "name": "Discovery Call on Funnel"
+        },
+        {
+          "id": "a38d3706-8bed-4bc1-b957-b5fc2ab9cf22",
+          "name": "Appointment Set"
+        },
+        {
+          "id": "a0b5b71a-2228-413c-8523-993b7d35466a",
+          "name": "Task Set"
+        },
+        {
+          "id": "731bbb26-2636-47ea-8d82-8c3d4d7a8fed",
+          "name": "Never Responded"
+        },
+        {
+          "id": "29c9c778-01f5-4c2a-82ee-b813358b893a",
+          "name": "Disqualified"
+        },
+        {
+          "id": "2a104d02-7923-4ad2-a650-ebce9b18ea44",
+          "name": "Not Interested"
+        }
+      ]
+    }
+  ]
+}

package/stdlib/crm/migrations/20260501210107_initial/migration.nbt

@@ -0,0 +1,63 @@
+migration initial {
+  add_entity Contact
+  add_field Contact firstName string default("")
+  add_field Contact lastName string default("")
+  add_field Contact fullName string default("")
+  add_field Contact phone string default("")
+  add_field Contact mobile string default("")
+  add_field Contact email string default("")
+  add_field Contact address string default("")
+  add_field Contact fullAddress string default("")
+  add_field Contact postalCode string default("")
+  add_field Contact city string default("")
+  add_field Contact stateOrProvince string default("")
+  add_field Contact country string default("")
+  add_field Contact timezone string default("")
+  add_field Contact lat float default(0)
+  add_field Contact lon float default(0)
+  add_field Contact company string default("")
+  add_field Contact website string default("")
+  add_field Contact title string default("")
+  add_field Contact industry string default("")
+  add_field Contact source string default("")
+  add_field Contact notes string default("")
+  add_field Contact data document default(0)
+  add_field Contact customData document default(0)
+  add_entity Deal
+  add_field Deal name string default("")
+  add_field Deal contact Contact default(0)
+  add_field Deal value float default(0)
+  add_field Deal currency string default("")
+  add_field Deal type string default("")
+  add_field Deal stage string default("")
+  add_field Deal pipeline Pipeline default(0)
+  add_field Deal pipelineStage PipelineStage default(0)
+  add_field Deal data document default(0)
+  add_field Deal customData document default(0)
+  add_entity Pipeline
+  add_field Pipeline name string default("")
+  add_field Pipeline description string default("")
+  add_field Pipeline stages PipelineStage default(0)
+  add_field Pipeline deals Deal default(0)
+  add_entity PipelineStage
+  add_field PipelineStage name string default("")
+  add_field PipelineStage order u32 default(0)
+  add_field PipelineStage pipeline Pipeline default(0)
+  add_field PipelineStage deals Deal default(0)
+  add_entity PipelineStageTransition
+  add_field PipelineStageTransition fromPipelineId u64 default(0)
+  add_field PipelineStageTransition toPipelineId u64 default(0)
+  add_field PipelineStageTransition fromStageId u64 default(0)
+  add_field PipelineStageTransition toStageId u64 default(0)
+  add_field PipelineStageTransition movedBy User default(0)
+  add_index PipelineStageTransition [fromPipelineId, toPipelineId, fromStageId, toStageId]
+  add_entity User
+  add_field User name string default("")
+  add_field User username string default("")
+  add_field User email string default("")
+  add_field User emailVerified bool default(false)
+  add_field User externalId string default("")
+  add_field User capsVersion u32 default(0)
+  add_index User [email]
+  add_index User [externalId]
+}

package/stdlib/crm/migrations/20260501210107_initial/schema_snapshot.nbt

@@ -0,0 +1,73 @@
+entity Contact {
+  firstName?: string
+  lastName?: string
+  fullName?: string
+  phone?: string
+  mobile?: string
+  email?: string
+  address?: string
+  fullAddress?: string
+  postalCode?: string
+  city?: string
+  stateOrProvince?: string
+  country?: string
+  timezone?: string
+  lat?: float
+  lon?: float
+  company?: string
+  website?: string
+  title?: string
+  industry?: string
+  source?: string
+  notes?: string
+  data: document
+  customData: document
+}
+
+entity Deal {
+  name: string
+  contact: Contact
+  value?: float
+  currency?: string
+  type?: string
+  stage?: string
+  pipeline?: Pipeline
+  pipelineStage?: PipelineStage
+  data: document
+  customData: document
+}
+
+entity Pipeline {
+  name: string
+  description?: string
+  stages: PipelineStage
+  deals: Deal
+}
+
+entity PipelineStage {
+  name: string
+  order: u32
+  pipeline: Pipeline
+  deals: Deal
+}
+
+entity PipelineStageTransition {
+  fromPipelineId?: u64
+  toPipelineId: u64
+  fromStageId?: u64
+  toStageId: u64
+  movedBy?: User
+  @@index([fromPipelineId, toPipelineId, fromStageId, toStageId])
+}
+
+entity User {
+  name: string
+  username?: string
+  email?: string
+  emailVerified: bool
+  externalId?: string
+  capsVersion: u32
+  @@index([email])
+  @@index([externalId])
+}
+

package/stdlib/crm/migrations/20260513151050_schema_update/migration.nbt

@@ -0,0 +1,13 @@
+migration schema_update {
+  add_entity Outcome
+  add_field Outcome appointmentId string default("")
+  add_field Outcome rating float default(0)
+  add_field Outcome status string default("")
+  add_field Outcome notes string default("")
+  add_field Outcome recordedAt DateTime default(0)
+  add_index Outcome [appointmentId]
+  add_field Deal status string default("")
+  add_field Deal appointmentId string default("")
+  add_field Deal totalContractPrice float default(0)
+  add_field Deal closedDate DateTime default(0)
+}

package/stdlib/crm/migrations/20260513151050_schema_update/schema_snapshot.nbt

@@ -0,0 +1,86 @@
+entity Contact {
+  firstName?: string
+  lastName?: string
+  fullName?: string
+  phone?: string
+  mobile?: string
+  email?: string
+  address?: string
+  fullAddress?: string
+  postalCode?: string
+  city?: string
+  stateOrProvince?: string
+  country?: string
+  timezone?: string
+  lat?: float
+  lon?: float
+  company?: string
+  website?: string
+  title?: string
+  industry?: string
+  source?: string
+  notes?: string
+  data: document
+  customData: document
+}
+
+entity Outcome {
+  appointmentId: string
+  rating?: float
+  status?: string
+  notes?: string
+  recordedAt: DateTime
+  @@index([appointmentId])
+}
+
+entity Deal {
+  name: string
+  contact: Contact
+  value?: float
+  currency?: string
+  type?: string
+  stage?: string
+  pipeline?: Pipeline
+  pipelineStage?: PipelineStage
+  data: document
+  customData: document
+  status?: string
+  appointmentId?: string
+  totalContractPrice?: float
+  closedDate?: DateTime
+}
+
+entity Pipeline {
+  name: string
+  description?: string
+  stages: PipelineStage
+  deals: Deal
+}
+
+entity PipelineStage {
+  name: string
+  order: u32
+  pipeline: Pipeline
+  deals: Deal
+}
+
+entity PipelineStageTransition {
+  fromPipelineId?: u64
+  toPipelineId: u64
+  fromStageId?: u64
+  toStageId: u64
+  movedBy?: User
+  @@index([fromPipelineId, toPipelineId, fromStageId, toStageId])
+}
+
+entity User {
+  name: string
+  username?: string
+  email?: string
+  emailVerified: bool
+  externalId?: string
+  capsVersion: u32
+  @@index([email])
+  @@index([externalId])
+}
+

package/stdlib/crm/schema.nbt

@@ -0,0 +1,148 @@
+import {User} from "auth";
+
+export entity Contact {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  firstName?: string
+  lastName?: string
+  fullName?: string
+
+  phone?: string
+  mobile?: string
+  email?: string
+
+  address?: string
+  fullAddress?: string
+  postalCode?: string
+  city?: string
+  stateOrProvince?: string
+  country?: string
+  timezone?: string
+
+  lat?: float
+  lon?: float
+
+  company?: string
+  website?: string
+  title?: string
+  industry?: string
+  source?: string
+  notes?: string
+
+  # custom client usecase specific data goes here
+  # for mylocalpro currently custom stuff is:
+  # * location deemed insufficient
+  data: document
+  customData: document
+
+  deals: Deal[]
+}
+
+# Generic per-appointment lifecycle outcome — neutral over customer domain.
+# Customers project their domain-specific outcome into the (rating, status)
+# pair: solar deployments record `status="won"|"lost"`, therapy clinics
+# record `rating: 1..5`, field-service deployments record both. The
+# `outcomeClass` mapping that drives similarity-weighted aggregation lives
+# in each customer's own lifecycle logic, not on this entity.
+export entity Outcome {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  appointmentId: string
+  rating?: float
+  status?: string
+  notes?: string
+  recordedAt: DateTime @default(now())
+
+  @@index([appointmentId])
+}
+
+export entity Deal {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  name: string
+  contact: Contact
+  value?: float
+  currency?: string
+  type?: string
+
+  stage?: string
+
+  pipeline?: Pipeline
+  pipelineStage?: PipelineStage
+
+  data: document
+  customData: document
+
+  # Append-only suffix — fields below this comment must stay at the end
+  # of the entity declaration. Codegen serializes in declaration order;
+  # newly-added fields go *after* existing fields so the on-disk byte
+  # layout stays forward-compatible (old records deserialize cleanly with
+  # trailing fields default-initialised). See the EOF-tolerant deserialize
+  # codegen in modules/nbt/codegen_serial.jai.
+
+  # D09.02 — generic lifecycle status, customer-domain. mylocalpro reacts
+  # to `deal.status == "won"` to mark the source Appointment positive.
+  status?: string
+
+  # D09.02 — optional back-reference to the Appointment this Deal
+  # originated from. Plain string id (not a relation) so webhook ingest
+  # can set it without requiring the Appointment row to exist yet.
+  appointmentId?: string
+
+  # Total contract price for the deal (USD). Resolved at GHL adapter
+  # ingest from Contact custom field "Total Contract Price" via
+  # CONTACT_LATEST_OPEN_DEAL Field_Mapping resolver. Closed deals lock —
+  # adapter writes to status ∈ {won, lost} are rejected to preserve
+  # historical pricing without double-storing.
+  totalContractPrice?: float
+
+  # Date the deal closed (won or lost). Resolved at GHL adapter ingest
+  # from Contact custom field "Date Sold" via CONTACT_LATEST_OPEN_DEAL.
+  # Append-only field — codegen serializes in declaration order, so
+  # existing rows deserialize cleanly with this trailing default.
+  closedDate?: DateTime
+}
+
+entity Pipeline {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  name: string
+  description?: string
+  stages: PipelineStage[]
+
+  deals: Deal[]
+}
+
+entity PipelineStage {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  name: string
+  order: u32
+  pipeline: Pipeline @relation(onDelete: Cascade)   # stages are owned by their pipeline
+
+  deals: Deal[]
+}
+
+entity PipelineStageTransition {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  # updatedAt is added automatically but means nothing since these are immutable
+  # createdAt is equivalent to movedAt
+
+  fromPipelineId?: string
+  toPipelineId: string
+
+  fromStageId?: string
+  toStageId: string
+
+  movedBy?: User @relation(onDelete: SetNull)
+
+  @@index([fromPipelineId, toPipelineId, fromStageId, toStageId])
+}
+

package/stdlib/design/migrations/20260501210107_initial/migration.nbt

@@ -0,0 +1,19 @@
+migration initial {
+  add_entity Design
+  add_field Design name string default("")
+  add_field Design slug string default("")
+  add_field Design description string default("")
+  add_field Design headVersionId string default("")
+  add_field Design headVersion u32 default(0)
+  add_unique Design [slug]
+  add_entity DesignVersion
+  add_field DesignVersion designId string default("")
+  add_field DesignVersion version u32 default(0)
+  add_field DesignVersion body document default(0)
+  add_field DesignVersion source string default("")
+  add_field DesignVersion note string default("")
+  add_field DesignVersion createdBy string default("")
+  add_field DesignVersion parseErrors string default("")
+  add_index DesignVersion [designId]
+  add_unique DesignVersion [designId, version]
+}

package/stdlib/design/migrations/20260501210107_initial/schema_snapshot.nbt

@@ -0,0 +1,21 @@
+entity Design {
+  name: string
+  slug: string
+  description: string
+  headVersionId: string
+  headVersion: u32
+  @@unique([slug])
+}
+
+entity DesignVersion {
+  designId: string
+  version: u32
+  body: document
+  source: string
+  note: string
+  createdBy: string
+  parseErrors: string
+  @@index([designId])
+  @@unique([designId, version])
+}
+

package/stdlib/design/migrations/20260610130000_design_system/migration.nbt

@@ -0,0 +1,50 @@
+migration design_system {
+  add_field Design designerId string default("")
+  add_entity Designer
+  add_field Designer name string default("")
+  add_field Designer handle string default("")
+  add_field Designer url string default("")
+  add_field Designer bio string default("")
+  add_unique Designer [handle]
+  add_entity Token
+  add_field Token designId string default("")
+  add_field Token name string default("")
+  add_field Token kind string default("")
+  add_field Token value string default("")
+  add_field Token darkValue string default("")
+  add_index Token [designId]
+  add_unique Token [designId, name]
+  add_entity Component
+  add_field Component designId string default("")
+  add_field Component name string default("")
+  add_field Component version u32 default(0)
+  add_field Component designerId string default("")
+  add_field Component propsSpec string default("")
+  add_field Component notes string default("")
+  add_index Component [designId]
+  add_unique Component [designId, name]
+  add_entity Block
+  add_field Block designId string default("")
+  add_field Block name string default("")
+  add_field Block version u32 default(0)
+  add_field Block designerId string default("")
+  add_field Block components string default("")
+  add_field Block slotsSpec string default("")
+  add_field Block defaults string default("")
+  add_index Block [designId]
+  add_unique Block [designId, name]
+  add_entity Rule
+  add_field Rule designId string default("")
+  add_field Rule subject string default("")
+  add_field Rule kind string default("")
+  add_field Rule rule string default("")
+  add_field Rule note string default("")
+  add_index Rule [designId]
+  add_entity Page
+  add_field Page designId string default("")
+  add_field Page slug string default("")
+  add_field Page title string default("")
+  add_field Page blocks string default("")
+  add_index Page [designId]
+  add_unique Page [designId, slug]
+}

package/stdlib/design/migrations/20260610130000_design_system/schema_snapshot.nbt

@@ -0,0 +1,80 @@
+entity Design {
+  name: string
+  slug: string
+  description: string
+  designerId: string
+  headVersionId: string
+  headVersion: u32
+  @@unique([slug])
+}
+
+entity DesignVersion {
+  designId: string
+  version: u32
+  body: document
+  source: string
+  note: string
+  createdBy: string
+  parseErrors: string
+  @@index([designId])
+  @@unique([designId, version])
+}
+
+entity Designer {
+  name: string
+  handle: string
+  url: string
+  bio: string
+  @@unique([handle])
+}
+
+entity Token {
+  designId: string
+  name: string
+  kind: string
+  value: string
+  darkValue: string
+  @@index([designId])
+  @@unique([designId, name])
+}
+
+entity Component {
+  designId: string
+  name: string
+  version: u32
+  designerId: string
+  propsSpec: string
+  notes: string
+  @@index([designId])
+  @@unique([designId, name])
+}
+
+entity Block {
+  designId: string
+  name: string
+  version: u32
+  designerId: string
+  components: string
+  slotsSpec: string
+  defaults: string
+  @@index([designId])
+  @@unique([designId, name])
+}
+
+entity Rule {
+  designId: string
+  subject: string
+  kind: string
+  rule: string
+  note: string
+  @@index([designId])
+}
+
+entity Page {
+  designId: string
+  slug: string
+  title: string
+  blocks: string
+  @@index([designId])
+  @@unique([designId, slug])
+}