@nbt-dev/nbt 0.0.1 → 0.0.4

package/stdlib/auth/migrations/20260521191014_update_user/schema_snapshot.nbt

@@ -0,0 +1,59 @@
+entity User {
+  name: string
+  username?: string
+  email?: string
+  emailVerified: bool
+  externalId?: string
+  capsVersion: u32
+  @@index([email])
+  @@index([externalId])
+  @@unique([email])
+}
+
+entity UserRole {
+  userId: string
+  cart: string
+  role: string
+  @@index([userId])
+}
+
+entity Session {
+  userId: string
+  token: string
+  expiresAt: DateTime
+  ipAddress?: string
+  userAgent?: string
+  @@index([token])
+  @@index([userId])
+}
+
+entity Account {
+  userId: string
+  providerId: string
+  password: string
+  accessToken: string
+  refreshToken: string
+  idToken: string
+  accessTokenExpiresAt: DateTime
+  refreshTokenExpiresAt: DateTime
+  scope: string
+  @@index([userId])
+}
+
+entity Verification {
+  identifier: string
+  value: string
+  expiresAt: DateTime
+  @@index([identifier])
+}
+
+entity ApiKey {
+  name: string
+  projectId: string
+  start: string
+  prefix: string
+  key: string
+  permissions: string
+  roles: string
+}
+

package/stdlib/auth/schema.nbt

@@ -0,0 +1,142 @@
+import crypto from "crypto"
+
+# Auth policy for the hand-written routes in native/runtime.jai (formerly the
+# @public actions + the `authenticate` middleware block). These keep the
+# daemon's public-route + middleware manifest correct: public routes bypass the
+# /api/* auth gate; @middleware tells the proxy this cart exports the global
+# authenticate gate (registered at /_middleware/authenticate). The @authn
+# (service) sync/role routes carry NO directive — they require auth, gated
+# inline in the handler.
+@public_route "/api/auth/user/signup"
+@public_route "/api/auth/user/signin"
+@public_route "/api/auth/session/signout"
+@public_route "/api/auth/session/current"
+@public_route "/api/auth/user/forgot_password"
+@public_route "/api/auth/user/reset_password"
+@public_route "/api/auth/user/verify_email"
+@middleware "authenticate"
+
+export entity User {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  name: string
+  username?: string
+  email?: string
+  emailVerified: bool
+  externalId?: string
+  capsVersion: u32 # what is this?
+
+  @@index([email])
+  @@index([externalId])
+  @@unique([email])
+}
+
+# Per-cartridge role assignments. Role names refer to entries in the owning
+# cartridge's `roles { }` block — this cartridge does not validate them.
+entity UserRole {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  userId:    string
+  cart: string
+  role:      string
+
+  @@index([userId])
+}
+
+entity Session {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  userId: string
+  token: string
+  expiresAt: DateTime
+  ipAddress?: string
+  userAgent?: string
+
+  @@index([token])
+  @@index([userId])
+}
+
+entity Account {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  userId: string
+  providerId: string
+  password: string
+  accessToken: string
+  refreshToken: string
+  idToken: string
+  accessTokenExpiresAt: DateTime
+  refreshTokenExpiresAt: DateTime
+  scope: string
+
+  @@index([userId])
+}
+
+entity Verification {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  identifier: string
+  value: string
+  expiresAt: DateTime
+
+  @@index([identifier])
+}
+
+entity ApiKey {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  name: string
+  projectId: string
+  start: string
+  prefix: string
+  key: string
+  permissions: string
+  roles: string
+}
+
+# Console-operator SSH public keys. The console daemon authenticates SSH
+# connections by looking up rows here via modules/auth_lookup/ (in-process,
+# direct storage read — auth cart liveness is not required).
+entity SshKey {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  userId: string
+  label: string
+  blob: string
+
+  @@index([userId])
+  @@unique([blob])
+}
+
+jai {
+find_synced_user :: (requestedId: string, email: string) -> (User, bool) {
+  if requestedId.count > 0 {
+    by_id, by_id_ok := get_user(requestedId);
+    if by_id_ok return by_id, true;
+
+    by_external := find_users_by_externalId(requestedId);
+    if by_external.count > 0 {
+      u, ok := get_user(by_external[0].id);
+      if ok return u, true;
+    }
+  }
+
+  if email.count > 0 {
+    by_email := find_users_by_email(email);
+    if by_email.count > 0 {
+      u, ok := get_user(by_email[0].id);
+      if ok return u, true;
+    }
+  }
+
+  empty: User;
+  return empty, false;
+}
+}

package/stdlib/calendar/adapters/gohighlevel/tests/fixtures/v2_calendar_pilot.json

@@ -0,0 +1,12 @@
+{
+  "createdAt": "2026-01-20T18:23:25.182Z",
+  "description": "<p style=\"margin:0px;color:#10182899\">Quick call with our local specialist to see if solar makes sense for you</p>",
+  "id": "zKW5Rx1wttNPLBXIYRh5",
+  "isActive": true,
+  "name": "Solar Discovery Call (ME FB BR)",
+  "slotDuration": 15,
+  "slotInterval": 15,
+  "source": "ghl",
+  "timezone": "America/Toronto",
+  "updatedAt": "2026-04-30T14:15:34.287Z"
+}

package/stdlib/calendar/adapters/gohighlevel/tests/fixtures/webhooks/appointment_changed.json

@@ -0,0 +1,70 @@
+{
+  "workflow": {"id": "f1d4c9b2-3a76-4ed8-bb12-9c4f0e5d7a01", "name": "Appointment Changed Sync"},
+  "type": "AppointmentUpdate",
+  "customData": {"org": "mlp", "project": "default", "type": "Appointment"},
+  "location": {
+    "id": "loc_test",
+    "name": "MyLocalPro Test",
+    "address": "22 Old Village Rd Sturbridge MA 01566",
+    "city": "Sturbridge",
+    "country": "US",
+    "fullAddress": "22 Old Village Rd Sturbridge MA 01566, Sturbridge MA 01566",
+    "postalCode": "01566",
+    "state": "MA"
+  },
+  "contact_id": "ctc_alice_001",
+  "first_name": "Alice",
+  "last_name": "Anderson-Smith",
+  "full_name": "Alice Anderson-Smith",
+  "email": "alice.smith@example.com",
+  "phone": "+15551234567",
+  "address1": "456 Updated Ave",
+  "full_address": "456 Updated Ave, Toronto ON M5V 2A2",
+  "city": "Toronto",
+  "state": "ON",
+  "country": "CA",
+  "postal_code": "M5V 2A2",
+  "timezone": "America/Toronto",
+  "tags": "solar,residential,rescheduled",
+  "contact_source": "Solar Survey MLP Skynet",
+  "contact_type": "lead",
+  "attributionSource": {},
+  "contact": {
+    "attributionSource": {
+      "campaign": "spring-solar",
+      "sessionSource": "Website"
+    },
+    "lastAttributionSource": {}
+  },
+  "calendar": {
+    "appointmentId": "apt_001",
+    "id": "cal_solar_consult",
+    "calendarName": "Solar Consultation",
+    "title": "Initial Solar Consult — Alice Anderson",
+    "address": "456 Updated Ave, Toronto, ON",
+    "notes": "Rescheduled per customer request; closer reassigned.",
+    "startTime": "2026-05-15T10:00:00",
+    "endTime": "2026-05-15T11:00:00",
+    "appoinmentStatus": "showed",
+    "appointmentStatus": "confirmed",
+    "selectedTimezone": "America/Toronto",
+    "assignedUserId": "usr_002"
+  },
+  "Setter": "Diana Davis",
+  "Setter Name": "Diana Davis",
+  "Closer": "Charlie Chen",
+  "Appointment Outcome": "showed",
+  "Appointment Time": "2026-05-15T10:00:00",
+  "Appointment Type": "Discovery Call",
+  "Average Electric Bill": "245",
+  "Shade?": "minimal",
+  "Utility": "Toronto Hydro",
+  "Total Contract Price": "",
+  "Date Sold": "",
+  "triggerData": {},
+  "user": {
+    "email": "charlie@example.com",
+    "firstName": "Charlie",
+    "lastName": "Chen"
+  }
+}

package/stdlib/calendar/adapters/gohighlevel/tests/fixtures/webhooks/appointment_created.json

@@ -0,0 +1,72 @@
+{
+  "workflow": {"id": "f1d4c9b2-3a76-4ed8-bb12-9c4f0e5d7a01", "name": "Appointment Created Sync"},
+  "type": "AppointmentCreate",
+  "customData": {"org": "mlp", "project": "default", "type": "Appointment"},
+  "location": {
+    "id": "loc_test",
+    "name": "MyLocalPro Test",
+    "address": "22 Old Village Rd Sturbridge MA 01566",
+    "city": "Sturbridge",
+    "country": "US",
+    "fullAddress": "22 Old Village Rd Sturbridge MA 01566, Sturbridge MA 01566",
+    "postalCode": "01566",
+    "state": "MA"
+  },
+  "contact_id": "ctc_alice_001",
+  "first_name": "Alice",
+  "last_name": "Anderson",
+  "full_name": "Alice Anderson",
+  "email": "alice@example.com",
+  "phone": "+15551234567",
+  "address1": "123 Main St",
+  "full_address": "123 Main St, Toronto ON M5V 1A1",
+  "city": "Toronto",
+  "state": "ON",
+  "country": "CA",
+  "postal_code": "M5V 1A1",
+  "timezone": "America/Toronto",
+  "tags": "solar,residential",
+  "contact_source": "Solar Survey MLP Skynet",
+  "contact_type": "lead",
+  "attributionSource": {},
+  "contact": {
+    "attributionSource": {
+      "campaign": "spring-solar",
+      "medium": "cpc",
+      "sessionSource": "Website"
+    },
+    "lastAttributionSource": {}
+  },
+  "calendar": {
+    "appointmentId": "apt_001",
+    "id": "cal_solar_consult",
+    "calendarName": "Solar Consultation",
+    "title": "Initial Solar Consult — Alice Anderson",
+    "address": "123 Main St, Toronto, ON",
+    "notes": "Customer interested in 8kW system; financing questions.",
+    "startTime": "2026-05-12T14:00:00-04:00",
+    "endTime": "2026-05-12T15:00:00-04:00",
+    "appoinmentStatus": "confirmed",
+    "selectedTimezone": "America/Toronto",
+    "assignedUserId": "usr_001"
+  },
+  "Setter": "Diana Davis",
+  "Setter Name": "Diana Davis",
+  "Closer": "Bob Brown",
+  "Appointment Outcome": "",
+  "Appointment Time": "2026-05-12T14:00:00-04:00",
+  "Appointment Type": "Discovery Call",
+  "Average Electric Bill": "245",
+  "Shade?": "minimal",
+  "Utility": "Toronto Hydro",
+  "Total Contract Price": "",
+  "Date Sold": "",
+  "created_by": "Diana Davis",
+  "created_by_user_id": "usr_003",
+  "triggerData": {},
+  "user": {
+    "email": "diana@example.com",
+    "firstName": "Diana",
+    "lastName": "Davis"
+  }
+}

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

@@ -0,0 +1,60 @@
+migration initial {
+  add_entity Calendar
+  add_field Calendar name string default("")
+  add_field Calendar description string default("")
+  add_field Calendar timezone string default("")
+  add_field Calendar slotDuration u32 default(0)
+  add_field Calendar slotInterval u32 default(0)
+  add_field Calendar isActive bool default(false)
+  add_field Calendar source string default("")
+  add_entity Appointment
+  add_field Appointment calendar Calendar default(0)
+  add_field Appointment contact Contact default(0)
+  add_field Appointment title string default("")
+  add_field Appointment address string default("")
+  add_field Appointment notes string default("")
+  add_field Appointment startTime DateTime default(0)
+  add_field Appointment endTime DateTime default(0)
+  add_field Appointment timezone string default("")
+  add_field Appointment status string default("")
+  add_field Appointment source string default("")
+  add_field Appointment assignedUser User default(0)
+  add_field Appointment isRescheduled bool default(false)
+  add_field Appointment originalStartTime DateTime default(0)
+  add_field Appointment originalEndTime DateTime default(0)
+  add_index Appointment [contactId]
+  add_index Appointment [calendarId]
+  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 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/calendar/migrations/20260501210107_initial/schema_snapshot.nbt

@@ -0,0 +1,66 @@
+entity Calendar {
+  name: string
+  description?: string
+  timezone?: string
+  slotDuration?: u32
+  slotInterval?: u32
+  isActive: bool
+  source?: string
+}
+
+entity Appointment {
+  calendar: Calendar
+  contact: Contact
+  title?: string
+  address?: string
+  notes?: string
+  startTime: DateTime
+  endTime: DateTime
+  timezone?: string
+  status: string
+  source?: string
+  assignedUser?: User
+  isRescheduled: bool
+  originalStartTime?: DateTime
+  originalEndTime?: DateTime
+  @@index([contactId])
+  @@index([calendarId])
+}
+
+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 User {
+  name: string
+  username?: string
+  email?: string
+  emailVerified: bool
+  externalId?: string
+  capsVersion: u32
+  @@index([email])
+  @@index([externalId])
+}
+

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

@@ -0,0 +1,17 @@
+migration schema_update {
+  add_field Appointment state string default("")
+  add_field Appointment outcomeClass string default("")
+  add_field Appointment embedText string default("")
+  add_index Appointment [state]
+  add_index Appointment [outcomeClass]
+  add_entity AppointmentParticipant
+  add_field AppointmentParticipant appointment Appointment default(0)
+  add_field AppointmentParticipant user User default(0)
+  add_field AppointmentParticipant role string default("")
+  add_field AppointmentParticipant assignedAt DateTime default(0)
+  add_field AppointmentParticipant assignedBy User default(0)
+  add_field AppointmentParticipant notes string default("")
+  add_index AppointmentParticipant [appointmentId]
+  add_index AppointmentParticipant [userId, role]
+  add_unique AppointmentParticipant [appointmentId, role, userId]
+}

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

@@ -0,0 +1,83 @@
+entity Calendar {
+  name: string
+  description?: string
+  timezone?: string
+  slotDuration?: u32
+  slotInterval?: u32
+  isActive: bool
+  source?: string
+}
+
+entity Appointment {
+  calendar: Calendar
+  contact: Contact
+  title?: string
+  address?: string
+  notes?: string
+  startTime: DateTime
+  endTime: DateTime
+  timezone?: string
+  status: string
+  source?: string
+  assignedUser?: User
+  isRescheduled: bool
+  originalStartTime?: DateTime
+  originalEndTime?: DateTime
+  state?: string
+  outcomeClass?: string
+  embedText?: string
+  @@index([contactId])
+  @@index([calendarId])
+  @@index([state])
+  @@index([outcomeClass])
+}
+
+entity AppointmentParticipant {
+  appointment: Appointment
+  user: User
+  role: string
+  assignedAt: DateTime
+  assignedBy?: User
+  notes?: string
+  @@unique([appointmentId, role, userId])
+  @@index([appointmentId])
+  @@index([userId, role])
+}
+
+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 User {
+  name: string
+  username?: string
+  email?: string
+  emailVerified: bool
+  externalId?: string
+  capsVersion: u32
+  @@index([email])
+  @@index([externalId])
+}
+

package/stdlib/calendar/schema.nbt

@@ -0,0 +1,86 @@
+import {Contact} from "crm";
+import {User} from "auth";
+
+entity Calendar {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  name: string
+  description?: string
+  timezone?: string
+  slotDuration?: u32
+  slotInterval?: u32
+  isActive: bool
+  source?: string
+  appointments: Appointment[]
+}
+
+export entity Appointment {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  calendar: Calendar
+  contact: Contact @relation(onDelete: Restrict)
+  title?: string
+  address?: string
+  notes?: string
+  startTime: DateTime
+  endTime: DateTime
+  timezone?: string
+  status: string
+  source?: string
+  assignedUser?: User @relation(onDelete: SetNull)
+  isRescheduled: bool
+  originalStartTime?: DateTime
+  originalEndTime?: DateTime
+
+  # Geographic state (e.g. "CA", "TX") parsed from `address` at ingest. Indexed
+  # so customers can filter assignment candidates by state cheaply.
+  state?: string
+
+  # Generic outcome label for similarity-weighted aggregation. Customer fills
+  # via their domain's lifecycle hook ("won" for MyLocalPro, "positive" for
+  # therapy). Indexed for `Appointment.find_by_outcomeClass("won")` lookups.
+  outcomeClass?: string
+
+  # Rendered embedding-template text. Persisted alongside the Appointment so
+  # similarity search can score (target_text, candidate_text) pairs without
+  # re-rendering the customer's @embed template on every query. Populated at
+  # ingest by the customer's @embed binding
+  # (D09.10c). Generic surface — every customer composing similarity search
+  # over Appointments needs it; the *content* of the text is customer policy.
+  embedText?: string
+
+  participants: AppointmentParticipant[]
+
+  # contact + calendar are FK fields — indexed automatically.
+  @@index([state])
+  @@index([outcomeClass])
+}
+
+# Many-to-many linkage between Appointment and User with a client-defined
+# role label. Lets a deployment encode any participant taxonomy without
+# adding new columns to Appointment:
+#
+#   MyLocalPro:    role = "setter" | "closer" | "shadower"
+#   Therapy:       role = "therapist" | "supervisor"
+#   Field service: role = "primary" | "backup" | "trainee"
+#
+# `Appointment.assignedUser` stays as the conventional "primary owner"
+# pointer (single value, indexed) for clients that don't need multi-role.
+# AppointmentParticipant is additive — clients pick the row when they
+# want richer linkage.
+export entity AppointmentParticipant {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  appointment: Appointment @relation(onDelete: Cascade)
+  user: User @relation(onDelete: Cascade)
+  role: string             # client-defined (e.g. "setter", "closer")
+  assignedAt: DateTime @default(now())
+  assignedBy?: User @relation(onDelete: SetNull)   # who recorded this assignment (for audit)
+  notes?: string
+
+  @@unique([appointment, role, user])
+  @@index([user, role])
+}