@kohost/api-client 7.13.0 → 7.14.0

package/dist/models/index.js

@@ -7,6 +7,7 @@ import { Bill } from "./bill.js";
 import { BillingCategory } from "./billingCategory.js";
 import { Camera } from "./camera.js";
 import { Category } from "./category.js";
+import { Cost } from "./cost.js";
 import { Courtesy } from "./courtesy.js";
 import { Credential } from "./credential.js";
 import { Department } from "./department.js";
@@ -58,6 +59,7 @@ var models_exports = /* @__PURE__ */ __exportAll({
 	BillingCategory: () => BillingCategory,
 	Camera: () => Camera,
 	Category: () => Category,
+	Cost: () => Cost,
 	Courtesy: () => Courtesy,
 	Credential: () => Credential,
 	Department: () => Department,
@@ -103,6 +105,6 @@ var models_exports = /* @__PURE__ */ __exportAll({
 	WindowCovering: () => WindowCovering
 });
 //#endregion
-export { Alarm, Announcement, Automation, Bill, BillingCategory, Camera, Category, Courtesy, Credential, Department, Dimmer, DiscoveredDevice, EmailMessage, EnergyReport, EnergyReportShard, Entity, Gateway, Group, Identification, Integration, Issue, Lock, Log, MediaFile, MediaSource, MotionSensor, Notification, Organization, Payment, Policy, Product, Property, Reservation, Resource, SOSEvent, SOSType, Server, Session, ShortLink, SmsMessage, Space, Switch, System, SystemUser, Thermostat, Ticket, TimeSheet, User, Vendor, WindowCovering, models_exports };
+export { Alarm, Announcement, Automation, Bill, BillingCategory, Camera, Category, Cost, Courtesy, Credential, Department, Dimmer, DiscoveredDevice, EmailMessage, EnergyReport, EnergyReportShard, Entity, Gateway, Group, Identification, Integration, Issue, Lock, Log, MediaFile, MediaSource, MotionSensor, Notification, Organization, Payment, Policy, Product, Property, Reservation, Resource, SOSEvent, SOSType, Server, Session, ShortLink, SmsMessage, Space, Switch, System, SystemUser, Thermostat, Ticket, TimeSheet, User, Vendor, WindowCovering, models_exports };
 
 //# sourceMappingURL=index.js.map

package/dist/models/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../.generated/models/index.ts"],"sourcesContent":["/* This file is automatically generated. Do not modify it manually. */\n\nexport { Entity } from \"./entity.js\";\n\nexport { Alarm, type AlarmData } from \"./alarm.js\";\nexport { Announcement, type AnnouncementData } from \"./announcement.js\";\nexport { Automation, type AutomationData } from \"./automation.js\";\nexport { Bill, type BillData } from \"./bill.js\";\nexport { BillingCategory, type BillingCategoryData } from \"./billingCategory.js\";\nexport { Camera, type CameraData } from \"./camera.js\";\nexport { Category, type CategoryData } from \"./category.js\";\nexport { Courtesy, type CourtesyData } from \"./courtesy.js\";\nexport { Credential, type CredentialData } from \"./credential.js\";\nexport { Department, type DepartmentData } from \"./department.js\";\nexport { Dimmer, type DimmerData } from \"./dimmer.js\";\nexport { DiscoveredDevice, type DiscoveredDeviceData } from \"./discoveredDevice.js\";\nexport { EmailMessage, type EmailMessageData } from \"./emailMessage.js\";\nexport { EnergyReport, type EnergyReportData } from \"./energyReport.js\";\nexport { EnergyReportShard, type EnergyReportShardData } from \"./energyReportShard.js\";\nexport { Gateway, type GatewayData } from \"./gateway.js\";\nexport { Group, type GroupData } from \"./group.js\";\nexport { Identification, type IdentificationData } from \"./identification.js\";\nexport { Integration, type IntegrationData } from \"./integration.js\";\nexport { Issue, type IssueData } from \"./issue.js\";\nexport { Lock, type LockData } from \"./lock.js\";\nexport { Log, type LogData } from \"./log.js\";\nexport { MediaFile, type MediaFileData } from \"./mediaFile.js\";\nexport { MediaSource, type MediaSourceData } from \"./mediaSource.js\";\nexport { MotionSensor, type MotionSensorData } from \"./motionSensor.js\";\nexport { Notification, type NotificationData } from \"./notification.js\";\nexport { Organization, type OrganizationData } from \"./organization.js\";\nexport { Payment, type PaymentData } from \"./payment.js\";\nexport { Policy, type PolicyData } from \"./policy.js\";\nexport { Product, type ProductData } from \"./product.js\";\nexport { Property, type PropertyData } from \"./property.js\";\nexport { Reservation, type ReservationData } from \"./reservation.js\";\nexport { Resource, type ResourceData } from \"./resource.js\";\nexport { Server, type ServerData } from \"./server.js\";\nexport { Session, type SessionData } from \"./session.js\";\nexport { ShortLink, type ShortLinkData } from \"./shortLink.js\";\nexport { SmsMessage, type SmsMessageData } from \"./smsMessage.js\";\nexport { SOSEvent, type SOSEventData } from \"./sosEvent.js\";\nexport { SOSType, type SOSTypeData } from \"./sosType.js\";\nexport { Space, type SpaceData } from \"./space.js\";\nexport { Switch, type SwitchData } from \"./switch.js\";\nexport { System, type SystemData } from \"./system.js\";\nexport { SystemUser, type SystemUserData } from \"./systemUser.js\";\nexport { Thermostat, type ThermostatData } from \"./thermostat.js\";\nexport { Ticket, type TicketData } from \"./ticket.js\";\nexport { TimeSheet, type TimeSheetData } from \"./timeSheet.js\";\nexport { User, type UserData } from \"./user.js\";\nexport { Vendor, type VendorData } from \"./vendor.js\";\nexport { WindowCovering, type WindowCoveringData } from \"./windowCovering.js\";\n"],"mappings":""}
+{"version":3,"file":"index.js","names":[],"sources":["../../.generated/models/index.ts"],"sourcesContent":["/* This file is automatically generated. Do not modify it manually. */\n\nexport { Entity } from \"./entity.js\";\n\nexport { Alarm, type AlarmData } from \"./alarm.js\";\nexport { Announcement, type AnnouncementData } from \"./announcement.js\";\nexport { Automation, type AutomationData } from \"./automation.js\";\nexport { Bill, type BillData } from \"./bill.js\";\nexport { BillingCategory, type BillingCategoryData } from \"./billingCategory.js\";\nexport { Camera, type CameraData } from \"./camera.js\";\nexport { Category, type CategoryData } from \"./category.js\";\nexport { Cost, type CostData } from \"./cost.js\";\nexport { Courtesy, type CourtesyData } from \"./courtesy.js\";\nexport { Credential, type CredentialData } from \"./credential.js\";\nexport { Department, type DepartmentData } from \"./department.js\";\nexport { Dimmer, type DimmerData } from \"./dimmer.js\";\nexport { DiscoveredDevice, type DiscoveredDeviceData } from \"./discoveredDevice.js\";\nexport { EmailMessage, type EmailMessageData } from \"./emailMessage.js\";\nexport { EnergyReport, type EnergyReportData } from \"./energyReport.js\";\nexport { EnergyReportShard, type EnergyReportShardData } from \"./energyReportShard.js\";\nexport { Gateway, type GatewayData } from \"./gateway.js\";\nexport { Group, type GroupData } from \"./group.js\";\nexport { Identification, type IdentificationData } from \"./identification.js\";\nexport { Integration, type IntegrationData } from \"./integration.js\";\nexport { Issue, type IssueData } from \"./issue.js\";\nexport { Lock, type LockData } from \"./lock.js\";\nexport { Log, type LogData } from \"./log.js\";\nexport { MediaFile, type MediaFileData } from \"./mediaFile.js\";\nexport { MediaSource, type MediaSourceData } from \"./mediaSource.js\";\nexport { MotionSensor, type MotionSensorData } from \"./motionSensor.js\";\nexport { Notification, type NotificationData } from \"./notification.js\";\nexport { Organization, type OrganizationData } from \"./organization.js\";\nexport { Payment, type PaymentData } from \"./payment.js\";\nexport { Policy, type PolicyData } from \"./policy.js\";\nexport { Product, type ProductData } from \"./product.js\";\nexport { Property, type PropertyData } from \"./property.js\";\nexport { Reservation, type ReservationData } from \"./reservation.js\";\nexport { Resource, type ResourceData } from \"./resource.js\";\nexport { Server, type ServerData } from \"./server.js\";\nexport { Session, type SessionData } from \"./session.js\";\nexport { ShortLink, type ShortLinkData } from \"./shortLink.js\";\nexport { SmsMessage, type SmsMessageData } from \"./smsMessage.js\";\nexport { SOSEvent, type SOSEventData } from \"./sosEvent.js\";\nexport { SOSType, type SOSTypeData } from \"./sosType.js\";\nexport { Space, type SpaceData } from \"./space.js\";\nexport { Switch, type SwitchData } from \"./switch.js\";\nexport { System, type SystemData } from \"./system.js\";\nexport { SystemUser, type SystemUserData } from \"./systemUser.js\";\nexport { Thermostat, type ThermostatData } from \"./thermostat.js\";\nexport { Ticket, type TicketData } from \"./ticket.js\";\nexport { TimeSheet, type TimeSheetData } from \"./timeSheet.js\";\nexport { User, type UserData } from \"./user.js\";\nexport { Vendor, type VendorData } from \"./vendor.js\";\nexport { WindowCovering, type WindowCoveringData } from \"./windowCovering.js\";\n"],"mappings":""}

package/dist/schemas/bill.d.ts

@@ -93,7 +93,7 @@ export declare const billSchema: {
                 readonly oneOf: readonly [{
                     readonly type: "object";
                     readonly additionalProperties: false;
-                    readonly required: readonly ["id", "type", "ticketId", "costId"];
+                    readonly required: readonly ["id", "type"];
                     readonly properties: {
                         readonly id: {
                             readonly type: "string";
@@ -102,15 +102,23 @@ export declare const billSchema: {
                         readonly type: {
                             readonly type: "string";
                             readonly enum: readonly ["cost"];
-                            readonly description: "Discriminator: a line drawn from a ticket cost entry.";
+                            readonly description: "Discriminator: a line drawn from a recorded cost entry.";
                         };
-                        readonly ticketId: {
+                        readonly source: {
                             readonly type: "string";
-                            readonly description: "The ID of the ticket the claimed cost entry lives on.";
+                            readonly enum: readonly ["ticket", "adhoc"];
+                            readonly default: "ticket";
+                            readonly description: string;
+                        };
+                        readonly ticketId: {
+                            readonly type: readonly ["string", "null"];
+                            readonly default: null;
+                            readonly description: string;
                         };
                         readonly costId: {
-                            readonly type: "string";
-                            readonly description: "The ID of the claimed cost entry within the ticket.";
+                            readonly type: readonly ["string", "null"];
+                            readonly default: null;
+                            readonly description: string;
                         };
                         readonly categoryId: {
                             readonly type: readonly ["string", "null"];

package/dist/schemas/bill.js

@@ -94,12 +94,7 @@ const billSchema = {
 			items: { oneOf: [{
 				type: "object",
 				additionalProperties: false,
-				required: [
-					"id",
-					"type",
-					"ticketId",
-					"costId"
-				],
+				required: ["id", "type"],
 				properties: {
 					id: {
 						type: "string",
@@ -108,15 +103,23 @@ const billSchema = {
 					type: {
 						type: "string",
 						enum: ["cost"],
-						description: "Discriminator: a line drawn from a ticket cost entry."
+						description: "Discriminator: a line drawn from a recorded cost entry."
 					},
-					ticketId: {
+					source: {
 						type: "string",
-						description: "The ID of the ticket the claimed cost entry lives on."
+						enum: ["ticket", "adhoc"],
+						default: "ticket",
+						description: "Where the claimed cost entry lives, and therefore how `costId` resolves: on a ticket, or in the costs collection."
+					},
+					ticketId: {
+						type: ["string", "null"],
+						default: null,
+						description: "The ID of the ticket the claimed cost entry lives on. Null on an `adhoc` line, which no ticket carries."
 					},
 					costId: {
-						type: "string",
-						description: "The ID of the claimed cost entry within the ticket."
+						type: ["string", "null"],
+						default: null,
+						description: "The ID of the claimed cost entry: an entry within the ticket on a `ticket` line, a costs-collection document on an `adhoc` one."
 					},
 					categoryId: {
 						type: ["string", "null"],

package/dist/schemas/bill.js.map

@@ -1 +1 @@
-{"version":3,"file":"bill.js","names":[],"sources":["../../.generated/schemas/bill.ts"],"sourcesContent":["import defs, { ISODateString } from \"./definitions\";\nimport type { FromSchema } from \"json-schema-to-ts\";\nimport { mediaFileSchema } from \"./mediaFile\";\n\n// One bill line is a discriminated union on `type`, so `lines.items` is their\n// `oneOf`. The two branches are disjoint via the `type` const plus\n// `additionalProperties: false`, so a line validates against exactly one.\n//\n// A cost line references a ticket cost entry by `(ticketId, costId)`. While the\n// bill is a draft it carries only the reference, the picked `categoryId`, and\n// any draft-time adjustment; the customer-facing `amount`, `description`, and\n// `categoryName` are live-read from the cost entry and snapshotted onto the\n// line at mark-sent. The billed amount is the marked-up actual (or the\n// `adjustedAmount` override, floored at zero) — vendor truth on the cost entry\n// is never touched.\nconst costLineSchema = {\n  type: \"object\",\n  additionalProperties: false,\n  required: [\"id\", \"type\", \"ticketId\", \"costId\"],\n  properties: {\n    id: {\n      type: \"string\",\n      description: \"Server-minted ID of the bill line.\",\n    },\n    type: {\n      type: \"string\",\n      enum: [\"cost\"],\n      description: \"Discriminator: a line drawn from a ticket cost entry.\",\n    },\n    ticketId: {\n      type: \"string\",\n      description: \"The ID of the ticket the claimed cost entry lives on.\",\n    },\n    costId: {\n      type: \"string\",\n      description: \"The ID of the claimed cost entry within the ticket.\",\n    },\n    categoryId: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"The picked billing category, inherited from the claimed cost entry \" +\n        \"when the claim does not name one. Optional while drafting, required \" +\n        \"at mark-sent. Manual pick — never derived from the ticket's issue.\",\n    },\n    categoryName: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"The category name snapshotted at mark-sent. Null while drafting, \" +\n        \"when it live-reads from the category library.\",\n    },\n    adjustedAmount: {\n      type: [\"integer\", \"null\"],\n      minimum: 0,\n      default: null,\n      description:\n        \"Optional draft-time override of the billed amount in integer cents, \" +\n        \"floored at zero, replacing the marked-up actual at display and \" +\n        \"snapshot. Requires `adjustmentReason`. A credit (below zero) is a \" +\n        \"manual line instead.\",\n    },\n    adjustmentReason: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"Short required reason accompanying `adjustedAmount`, kept for the \" +\n        \"internal record.\",\n    },\n    amount: {\n      type: [\"integer\", \"null\"],\n      default: null,\n      description:\n        \"The billed amount in integer cents, snapshotted at mark-sent. Null \" +\n        \"while drafting, when it live-reads (marked-up actual or the \" +\n        \"adjustment) from the cost entry.\",\n    },\n    description: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"The line description, snapshotted at mark-sent. Null while drafting, \" +\n        \"when it live-reads from the cost entry.\",\n    },\n    taxable: {\n      type: \"boolean\",\n      default: false,\n      description:\n        \"Whether the line's amount joins the bill's taxable subtotal. \" +\n        \"Customer-facing: locks at mark-sent.\",\n    },\n  },\n} as const;\n\n// A manual line is a literal customer-facing row with no markup math: a\n// `description` and `amount` (which may be negative, serving as a credit) and\n// an optional `propertyId`. The independent internal fields — informational\n// `cost` (never derives the amount), `vendorId`, the vendor-invoice file, and\n// `vendorInvoiceNumber` — are redacted org-side via `canSeeCostSplit` and stay\n// editable in any bill state.\nconst manualLineSchema = {\n  type: \"object\",\n  additionalProperties: false,\n  required: [\"id\", \"type\", \"description\", \"amount\"],\n  properties: {\n    id: {\n      type: \"string\",\n      description: \"Server-minted ID of the bill line.\",\n    },\n    type: {\n      type: \"string\",\n      enum: [\"manual\"],\n      description: \"Discriminator: a literal, non-ticket line.\",\n    },\n    description: {\n      type: \"string\",\n      minLength: 1,\n      description: \"The literal customer-facing description.\",\n    },\n    amount: {\n      type: \"integer\",\n      description:\n        \"The billed amount in integer cents. May be negative, serving as a \" +\n        \"credit (reference the reason in the description).\",\n    },\n    propertyId: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"The property the manual line is attributed to, when it concerns one.\",\n    },\n    categoryId: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"The picked billing category. Optional while drafting, required at \" +\n        \"mark-sent.\",\n    },\n    categoryName: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description: \"The category name snapshotted at mark-sent.\",\n    },\n    cost: {\n      type: [\"integer\", \"null\"],\n      default: null,\n      description:\n        \"Informational internal vendor cost in integer cents. Never derives \" +\n        \"the amount. Redacted org-side.\",\n    },\n    vendorId: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"Optional reference to the org-scoped Vendor. Internal, redacted \" +\n        \"org-side.\",\n    },\n    vendorInvoice: {\n      anyOf: [{ $ref: \"mediaFile.json\" }, { type: \"null\" }],\n      default: null,\n      description:\n        \"The vendor's invoice file backing the line, mirroring the cost-entry \" +\n        \"field. Internal, redacted org-side.\",\n    },\n    vendorInvoiceNumber: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"The vendor's own invoice number. Internal, redacted org-side.\",\n    },\n    taxable: {\n      type: \"boolean\",\n      default: false,\n      description:\n        \"Whether the line's amount joins the bill's taxable subtotal. \" +\n        \"Customer-facing: locks at mark-sent.\",\n    },\n  },\n} as const;\n\nexport const billSchema = {\n  $schema: \"http://json-schema.org/draft-07/schema\",\n  $id: \"bill.json\",\n  title: \"Bill\",\n  description:\n    \"A OneBill bill, stored platform-wide and stamped with its organization: \" +\n    \"KFC staff assemble billed lines from the \" +\n    \"uninvoiced cost pool (plus manual lines) into a draft, then mark it sent \" +\n    \"to freeze and reveal it to the customer. Lifecycle draft → sent → paid, \" +\n    \"plus void. Customers see a bill in-app only once sent.\",\n  type: \"object\",\n  required: [\"id\", \"organizationId\", \"status\", \"currency\", \"lines\"],\n  additionalProperties: false,\n  properties: {\n    id: {\n      $ref: \"definitions.json#/definitions/id\",\n    },\n    type: {\n      type: \"string\",\n      enum: [\"bill\"],\n      default: \"bill\",\n    },\n    organizationId: {\n      type: \"string\",\n      description:\n        \"The organization the bill invoices. Bills live in one admin-database \" +\n        \"collection across every organization, so each carries its owner \" +\n        \"explicitly — stamped from the request context at creation, never \" +\n        \"client-supplied.\",\n    },\n    status: {\n      type: \"string\",\n      enum: [\"draft\", \"sent\", \"paid\", \"void\"],\n      default: \"draft\",\n      description:\n        \"Lifecycle state. `sent` freezes customer-facing fields and reveals \" +\n        \"the bill to the org; `paid` records manual payment; `void` releases \" +\n        \"cost-entry claims and hides the bill from the org view. Drafts \" +\n        \"hard-delete rather than voiding.\",\n    },\n    invoiceNumber: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"Kohost's own invoice number, `KB-<n>` from a single global sequence. \" +\n        \"System-assigned at mark-sent and never entered by hand: null while \" +\n        \"the bill is a draft, immutable once set. A wrong bill is corrected \" +\n        \"by void-and-reissue, so numbers gap and are never reused.\",\n    },\n    period: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        'Display-only month label (e.g. \"July 2026\"). A UI hint; the bill\\'s ' +\n        \"membership is defined by its lines, not a calendar bucket.\",\n    },\n    currency: {\n      type: \"string\",\n      enum: [\"USD\"],\n      default: \"USD\",\n      description: \"ISO 4217 currency code. USD only in v1.\",\n    },\n    fileId: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"The generated bill PDF's media-file ID, minted atomically at \" +\n        \"mark-sent.\",\n    },\n    fileUrl: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"The generated bill PDF's file-store URL, snapshotted at mark-sent \" +\n        \"alongside fileId. Held so the sent-bill surface and the sent \" +\n        \"notification email can mint a signed, unauthenticated download link \" +\n        \"without a file lookup. Unsigned on its own (a bare link 401s).\",\n    },\n    memo: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"Internal KFC-only note. Never customer-facing; editable in any state.\",\n    },\n    billingAddress: {\n      anyOf: [\n        { $ref: \"definitions.json#/definitions/address\" },\n        { type: \"null\" },\n      ],\n      default: null,\n      description:\n        \"The org billing address snapshotted at mark-sent. Null while \" +\n        \"drafting, when it live-reads from the Organization. Mark-sent \" +\n        \"requires a complete address (line1, city, state, postalCode).\",\n    },\n    taxRate: {\n      type: [\"number\", \"null\"],\n      default: null,\n      minimum: 0,\n      description:\n        \"Tax rate as a plain float percent applied to the taxable line \" +\n        \"subtotal. While drafting, null means the platform default rate; the \" +\n        \"effective rate is snapshotted at mark-sent.\",\n    },\n    taxExempt: {\n      type: \"boolean\",\n      default: false,\n      description:\n        \"The organization's tax exemption snapshotted at mark-sent. While \" +\n        \"drafting it live-reads from the Organization.\",\n    },\n    shippingAmount: {\n      type: [\"integer\", \"null\"],\n      default: null,\n      minimum: 0,\n      description:\n        \"Shipping & handling in integer cents, added to the grand total on \" +\n        \"top of the line subtotal and tax. Null means none.\",\n    },\n    lines: {\n      type: \"array\",\n      default: [],\n      description:\n        \"The bill's lines: cost lines claimed from the uninvoiced pool and \" +\n        \"literal manual lines.\",\n      items: {\n        oneOf: [costLineSchema, manualLineSchema],\n      },\n    },\n    sentAt: {\n      $ref: \"definitions.json#/definitions/date\",\n      description: \"When the bill was marked sent. Absent until sent.\",\n    },\n    paidAt: {\n      $ref: \"definitions.json#/definitions/date\",\n      description: \"When the bill was marked paid. Absent until paid.\",\n    },\n    voidedAt: {\n      $ref: \"definitions.json#/definitions/date\",\n      description: \"When the bill was voided. Absent unless voided.\",\n    },\n    createdAt: {\n      $ref: \"definitions.json#/definitions/date\",\n    },\n    updatedAt: {\n      $ref: \"definitions.json#/definitions/date\",\n    },\n  },\n} as const;\n\nexport type BillSchema = FromSchema<\n  typeof billSchema,\n  {\n    references: [typeof defs, typeof mediaFileSchema];\n    deserialize: [\n      {\n        pattern: {\n          format: \"date-time\";\n        };\n        output: Date | ISODateString;\n      },\n    ];\n  }\n>;\n\n/** One line on a bill: a cost line or a manual line. */\nexport type BillLine = NonNullable<BillSchema[\"lines\"]>[number];\n"],"mappings":"AAoLA,MAAa,aAAa;CACxB,SAAS;CACT,KAAK;CACL,OAAO;CACP,aACE;CAKF,MAAM;CACN,UAAU;EAAC;EAAM;EAAkB;EAAU;EAAY;CAAO;CAChE,sBAAsB;CACtB,YAAY;EACV,IAAI,EACF,MAAM,mCACR;EACA,MAAM;GACJ,MAAM;GACN,MAAM,CAAC,MAAM;GACb,SAAS;EACX;EACA,gBAAgB;GACd,MAAM;GACN,aACE;EAIJ;EACA,QAAQ;GACN,MAAM;GACN,MAAM;IAAC;IAAS;IAAQ;IAAQ;GAAM;GACtC,SAAS;GACT,aACE;EAIJ;EACA,eAAe;GACb,MAAM,CAAC,UAAU,MAAM;GACvB,SAAS;GACT,aACE;EAIJ;EACA,QAAQ;GACN,MAAM,CAAC,UAAU,MAAM;GACvB,SAAS;GACT,aACE;EAEJ;EACA,UAAU;GACR,MAAM;GACN,MAAM,CAAC,KAAK;GACZ,SAAS;GACT,aAAa;EACf;EACA,QAAQ;GACN,MAAM,CAAC,UAAU,MAAM;GACvB,SAAS;GACT,aACE;EAEJ;EACA,SAAS;GACP,MAAM,CAAC,UAAU,MAAM;GACvB,SAAS;GACT,aACE;EAIJ;EACA,MAAM;GACJ,MAAM,CAAC,UAAU,MAAM;GACvB,SAAS;GACT,aACE;EACJ;EACA,gBAAgB;GACd,OAAO,CACL,EAAE,MAAM,wCAAwC,GAChD,EAAE,MAAM,OAAO,CACjB;GACA,SAAS;GACT,aACE;EAGJ;EACA,SAAS;GACP,MAAM,CAAC,UAAU,MAAM;GACvB,SAAS;GACT,SAAS;GACT,aACE;EAGJ;EACA,WAAW;GACT,MAAM;GACN,SAAS;GACT,aACE;EAEJ;EACA,gBAAgB;GACd,MAAM,CAAC,WAAW,MAAM;GACxB,SAAS;GACT,SAAS;GACT,aACE;EAEJ;EACA,OAAO;GACL,MAAM;GACN,SAAS,CAAC;GACV,aACE;GAEF,OAAO,EACL,OAAO,CAAC;IAlSd,MAAM;IACN,sBAAsB;IACtB,UAAU;KAAC;KAAM;KAAQ;KAAY;IAAQ;IAC7C,YAAY;KACV,IAAI;MACF,MAAM;MACN,aAAa;KACf;KACA,MAAM;MACJ,MAAM;MACN,MAAM,CAAC,MAAM;MACb,aAAa;KACf;KACA,UAAU;MACR,MAAM;MACN,aAAa;KACf;KACA,QAAQ;MACN,MAAM;MACN,aAAa;KACf;KACA,YAAY;MACV,MAAM,CAAC,UAAU,MAAM;MACvB,SAAS;MACT,aACE;KAGJ;KACA,cAAc;MACZ,MAAM,CAAC,UAAU,MAAM;MACvB,SAAS;MACT,aACE;KAEJ;KACA,gBAAgB;MACd,MAAM,CAAC,WAAW,MAAM;MACxB,SAAS;MACT,SAAS;MACT,aACE;KAIJ;KACA,kBAAkB;MAChB,MAAM,CAAC,UAAU,MAAM;MACvB,SAAS;MACT,aACE;KAEJ;KACA,QAAQ;MACN,MAAM,CAAC,WAAW,MAAM;MACxB,SAAS;MACT,aACE;KAGJ;KACA,aAAa;MACX,MAAM,CAAC,UAAU,MAAM;MACvB,SAAS;MACT,aACE;KAEJ;KACA,SAAS;MACP,MAAM;MACN,SAAS;MACT,aACE;KAEJ;IACF;GAuNc,GAAgB;IA7M9B,MAAM;IACN,sBAAsB;IACtB,UAAU;KAAC;KAAM;KAAQ;KAAe;IAAQ;IAChD,YAAY;KACV,IAAI;MACF,MAAM;MACN,aAAa;KACf;KACA,MAAM;MACJ,MAAM;MACN,MAAM,CAAC,QAAQ;MACf,aAAa;KACf;KACA,aAAa;MACX,MAAM;MACN,WAAW;MACX,aAAa;KACf;KACA,QAAQ;MACN,MAAM;MACN,aACE;KAEJ;KACA,YAAY;MACV,MAAM,CAAC,UAAU,MAAM;MACvB,SAAS;MACT,aACE;KACJ;KACA,YAAY;MACV,MAAM,CAAC,UAAU,MAAM;MACvB,SAAS;MACT,aACE;KAEJ;KACA,cAAc;MACZ,MAAM,CAAC,UAAU,MAAM;MACvB,SAAS;MACT,aAAa;KACf;KACA,MAAM;MACJ,MAAM,CAAC,WAAW,MAAM;MACxB,SAAS;MACT,aACE;KAEJ;KACA,UAAU;MACR,MAAM,CAAC,UAAU,MAAM;MACvB,SAAS;MACT,aACE;KAEJ;KACA,eAAe;MACb,OAAO,CAAC,EAAE,MAAM,iBAAiB,GAAG,EAAE,MAAM,OAAO,CAAC;MACpD,SAAS;MACT,aACE;KAEJ;KACA,qBAAqB;MACnB,MAAM,CAAC,UAAU,MAAM;MACvB,SAAS;MACT,aACE;KACJ;KACA,SAAS;MACP,MAAM;MACN,SAAS;MACT,aACE;KAEJ;IACF;GAiI8B,CAAgB,EAC1C;EACF;EACA,QAAQ;GACN,MAAM;GACN,aAAa;EACf;EACA,QAAQ;GACN,MAAM;GACN,aAAa;EACf;EACA,UAAU;GACR,MAAM;GACN,aAAa;EACf;EACA,WAAW,EACT,MAAM,qCACR;EACA,WAAW,EACT,MAAM,qCACR;CACF;AACF"}
+{"version":3,"file":"bill.js","names":[],"sources":["../../.generated/schemas/bill.ts"],"sourcesContent":["import defs, { ISODateString } from \"./definitions\";\nimport type { FromSchema } from \"json-schema-to-ts\";\nimport { mediaFileSchema } from \"./mediaFile\";\n\n// One bill line is a discriminated union on `type`, so `lines.items` is their\n// `oneOf`. The two branches are disjoint via the `type` const plus\n// `additionalProperties: false`, so a line validates against exactly one.\n//\n// A cost line always names its entry by `costId`; `source` says which\n// collection to look it up in. A `ticket` line resolves through\n// `(ticketId, costId)`, an `adhoc` line reads `costId` straight off the costs\n// collection with `ticketId` null. The claim path is what pairs the two, since\n// JSON Schema cannot state the pairing without splitting the branch and\n// breaking the `type` discriminator every reader keys off.\n//\n// While the bill is a draft the line carries only the reference, the picked\n// `categoryId`, and any draft-time adjustment; the customer-facing `amount`,\n// `description`, and `categoryName` are live-read from the claimed entry and\n// snapshotted onto the line at mark-sent. The billed amount is the marked-up\n// actual (or the `adjustedAmount` override, floored at zero) — vendor truth on\n// the entry is never touched.\nconst costLineSchema = {\n  type: \"object\",\n  additionalProperties: false,\n  required: [\"id\", \"type\"],\n  properties: {\n    id: {\n      type: \"string\",\n      description: \"Server-minted ID of the bill line.\",\n    },\n    type: {\n      type: \"string\",\n      enum: [\"cost\"],\n      description: \"Discriminator: a line drawn from a recorded cost entry.\",\n    },\n    source: {\n      type: \"string\",\n      enum: [\"ticket\", \"adhoc\"],\n      default: \"ticket\",\n      description:\n        \"Where the claimed cost entry lives, and therefore how `costId` \" +\n        \"resolves: on a ticket, or in the costs collection.\",\n    },\n    ticketId: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"The ID of the ticket the claimed cost entry lives on. Null on an \" +\n        \"`adhoc` line, which no ticket carries.\",\n    },\n    costId: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"The ID of the claimed cost entry: an entry within the ticket on a \" +\n        \"`ticket` line, a costs-collection document on an `adhoc` one.\",\n    },\n    categoryId: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"The picked billing category, inherited from the claimed cost entry \" +\n        \"when the claim does not name one. Optional while drafting, required \" +\n        \"at mark-sent. Manual pick — never derived from the ticket's issue.\",\n    },\n    categoryName: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"The category name snapshotted at mark-sent. Null while drafting, \" +\n        \"when it live-reads from the category library.\",\n    },\n    adjustedAmount: {\n      type: [\"integer\", \"null\"],\n      minimum: 0,\n      default: null,\n      description:\n        \"Optional draft-time override of the billed amount in integer cents, \" +\n        \"floored at zero, replacing the marked-up actual at display and \" +\n        \"snapshot. Requires `adjustmentReason`. A credit (below zero) is a \" +\n        \"manual line instead.\",\n    },\n    adjustmentReason: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"Short required reason accompanying `adjustedAmount`, kept for the \" +\n        \"internal record.\",\n    },\n    amount: {\n      type: [\"integer\", \"null\"],\n      default: null,\n      description:\n        \"The billed amount in integer cents, snapshotted at mark-sent. Null \" +\n        \"while drafting, when it live-reads (marked-up actual or the \" +\n        \"adjustment) from the cost entry.\",\n    },\n    description: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"The line description, snapshotted at mark-sent. Null while drafting, \" +\n        \"when it live-reads from the cost entry.\",\n    },\n    taxable: {\n      type: \"boolean\",\n      default: false,\n      description:\n        \"Whether the line's amount joins the bill's taxable subtotal. \" +\n        \"Customer-facing: locks at mark-sent.\",\n    },\n  },\n} as const;\n\n// A manual line is a literal customer-facing row with no markup math: a\n// `description` and `amount` (which may be negative, serving as a credit) and\n// an optional `propertyId`. The independent internal fields — informational\n// `cost` (never derives the amount), `vendorId`, the vendor-invoice file, and\n// `vendorInvoiceNumber` — are redacted org-side via `canSeeCostSplit` and stay\n// editable in any bill state.\nconst manualLineSchema = {\n  type: \"object\",\n  additionalProperties: false,\n  required: [\"id\", \"type\", \"description\", \"amount\"],\n  properties: {\n    id: {\n      type: \"string\",\n      description: \"Server-minted ID of the bill line.\",\n    },\n    type: {\n      type: \"string\",\n      enum: [\"manual\"],\n      description: \"Discriminator: a literal, non-ticket line.\",\n    },\n    description: {\n      type: \"string\",\n      minLength: 1,\n      description: \"The literal customer-facing description.\",\n    },\n    amount: {\n      type: \"integer\",\n      description:\n        \"The billed amount in integer cents. May be negative, serving as a \" +\n        \"credit (reference the reason in the description).\",\n    },\n    propertyId: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"The property the manual line is attributed to, when it concerns one.\",\n    },\n    categoryId: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"The picked billing category. Optional while drafting, required at \" +\n        \"mark-sent.\",\n    },\n    categoryName: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description: \"The category name snapshotted at mark-sent.\",\n    },\n    cost: {\n      type: [\"integer\", \"null\"],\n      default: null,\n      description:\n        \"Informational internal vendor cost in integer cents. Never derives \" +\n        \"the amount. Redacted org-side.\",\n    },\n    vendorId: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"Optional reference to the org-scoped Vendor. Internal, redacted \" +\n        \"org-side.\",\n    },\n    vendorInvoice: {\n      anyOf: [{ $ref: \"mediaFile.json\" }, { type: \"null\" }],\n      default: null,\n      description:\n        \"The vendor's invoice file backing the line, mirroring the cost-entry \" +\n        \"field. Internal, redacted org-side.\",\n    },\n    vendorInvoiceNumber: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"The vendor's own invoice number. Internal, redacted org-side.\",\n    },\n    taxable: {\n      type: \"boolean\",\n      default: false,\n      description:\n        \"Whether the line's amount joins the bill's taxable subtotal. \" +\n        \"Customer-facing: locks at mark-sent.\",\n    },\n  },\n} as const;\n\nexport const billSchema = {\n  $schema: \"http://json-schema.org/draft-07/schema\",\n  $id: \"bill.json\",\n  title: \"Bill\",\n  description:\n    \"A OneBill bill, stored platform-wide and stamped with its organization: \" +\n    \"KFC staff assemble billed lines from the \" +\n    \"uninvoiced cost pool (plus manual lines) into a draft, then mark it sent \" +\n    \"to freeze and reveal it to the customer. Lifecycle draft → sent → paid, \" +\n    \"plus void. Customers see a bill in-app only once sent.\",\n  type: \"object\",\n  required: [\"id\", \"organizationId\", \"status\", \"currency\", \"lines\"],\n  additionalProperties: false,\n  properties: {\n    id: {\n      $ref: \"definitions.json#/definitions/id\",\n    },\n    type: {\n      type: \"string\",\n      enum: [\"bill\"],\n      default: \"bill\",\n    },\n    organizationId: {\n      type: \"string\",\n      description:\n        \"The organization the bill invoices. Bills live in one admin-database \" +\n        \"collection across every organization, so each carries its owner \" +\n        \"explicitly — stamped from the request context at creation, never \" +\n        \"client-supplied.\",\n    },\n    status: {\n      type: \"string\",\n      enum: [\"draft\", \"sent\", \"paid\", \"void\"],\n      default: \"draft\",\n      description:\n        \"Lifecycle state. `sent` freezes customer-facing fields and reveals \" +\n        \"the bill to the org; `paid` records manual payment; `void` releases \" +\n        \"cost-entry claims and hides the bill from the org view. Drafts \" +\n        \"hard-delete rather than voiding.\",\n    },\n    invoiceNumber: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"Kohost's own invoice number, `KB-<n>` from a single global sequence. \" +\n        \"System-assigned at mark-sent and never entered by hand: null while \" +\n        \"the bill is a draft, immutable once set. A wrong bill is corrected \" +\n        \"by void-and-reissue, so numbers gap and are never reused.\",\n    },\n    period: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        'Display-only month label (e.g. \"July 2026\"). A UI hint; the bill\\'s ' +\n        \"membership is defined by its lines, not a calendar bucket.\",\n    },\n    currency: {\n      type: \"string\",\n      enum: [\"USD\"],\n      default: \"USD\",\n      description: \"ISO 4217 currency code. USD only in v1.\",\n    },\n    fileId: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"The generated bill PDF's media-file ID, minted atomically at \" +\n        \"mark-sent.\",\n    },\n    fileUrl: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"The generated bill PDF's file-store URL, snapshotted at mark-sent \" +\n        \"alongside fileId. Held so the sent-bill surface and the sent \" +\n        \"notification email can mint a signed, unauthenticated download link \" +\n        \"without a file lookup. Unsigned on its own (a bare link 401s).\",\n    },\n    memo: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"Internal KFC-only note. Never customer-facing; editable in any state.\",\n    },\n    billingAddress: {\n      anyOf: [\n        { $ref: \"definitions.json#/definitions/address\" },\n        { type: \"null\" },\n      ],\n      default: null,\n      description:\n        \"The org billing address snapshotted at mark-sent. Null while \" +\n        \"drafting, when it live-reads from the Organization. Mark-sent \" +\n        \"requires a complete address (line1, city, state, postalCode).\",\n    },\n    taxRate: {\n      type: [\"number\", \"null\"],\n      default: null,\n      minimum: 0,\n      description:\n        \"Tax rate as a plain float percent applied to the taxable line \" +\n        \"subtotal. While drafting, null means the platform default rate; the \" +\n        \"effective rate is snapshotted at mark-sent.\",\n    },\n    taxExempt: {\n      type: \"boolean\",\n      default: false,\n      description:\n        \"The organization's tax exemption snapshotted at mark-sent. While \" +\n        \"drafting it live-reads from the Organization.\",\n    },\n    shippingAmount: {\n      type: [\"integer\", \"null\"],\n      default: null,\n      minimum: 0,\n      description:\n        \"Shipping & handling in integer cents, added to the grand total on \" +\n        \"top of the line subtotal and tax. Null means none.\",\n    },\n    lines: {\n      type: \"array\",\n      default: [],\n      description:\n        \"The bill's lines: cost lines claimed from the uninvoiced pool and \" +\n        \"literal manual lines.\",\n      items: {\n        oneOf: [costLineSchema, manualLineSchema],\n      },\n    },\n    sentAt: {\n      $ref: \"definitions.json#/definitions/date\",\n      description: \"When the bill was marked sent. Absent until sent.\",\n    },\n    paidAt: {\n      $ref: \"definitions.json#/definitions/date\",\n      description: \"When the bill was marked paid. Absent until paid.\",\n    },\n    voidedAt: {\n      $ref: \"definitions.json#/definitions/date\",\n      description: \"When the bill was voided. Absent unless voided.\",\n    },\n    createdAt: {\n      $ref: \"definitions.json#/definitions/date\",\n    },\n    updatedAt: {\n      $ref: \"definitions.json#/definitions/date\",\n    },\n  },\n} as const;\n\nexport type BillSchema = FromSchema<\n  typeof billSchema,\n  {\n    references: [typeof defs, typeof mediaFileSchema];\n    deserialize: [\n      {\n        pattern: {\n          format: \"date-time\";\n        };\n        output: Date | ISODateString;\n      },\n    ];\n  }\n>;\n\n/** One line on a bill: a cost line or a manual line. */\nexport type BillLine = NonNullable<BillSchema[\"lines\"]>[number];\n"],"mappings":"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"}

package/dist/schemas/cost.d.ts

@@ -0,0 +1,227 @@
+import defs, { ISODateString } from "./definitions.js";
+import type { FromSchema } from "json-schema-to-ts";
+import { mediaFileSchema } from "./mediaFile.js";
+export declare const costSchema: {
+    readonly $schema: "http://json-schema.org/draft-07/schema";
+    readonly $id: "cost.json";
+    readonly title: "Cost";
+    readonly description: string;
+    readonly type: "object";
+    readonly required: readonly ["id", "description", "currency", "price", "estimate", "markup", "organizationId"];
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly id: {
+            readonly type: "string";
+            readonly description: "The ID of the cost entry.";
+        };
+        readonly description: {
+            readonly type: "string";
+            readonly description: "What the cost covers.";
+        };
+        readonly currency: {
+            readonly type: "string";
+            readonly default: "USD";
+            readonly description: "ISO 4217 currency code of the entry's amounts.";
+        };
+        readonly price: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["amount", "recordedBy", "recordedAt"];
+            readonly description: string;
+            readonly properties: {
+                readonly amount: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "The amount in integer cents.";
+                };
+                readonly recordedBy: {
+                    readonly type: "string";
+                    readonly description: "The ID of the user who recorded the amount.";
+                };
+                readonly recordedAt: {
+                    readonly $ref: "definitions.json#/definitions/date";
+                    readonly description: "When the amount was recorded.";
+                };
+            };
+        };
+        readonly estimate: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["amount", "recordedBy", "recordedAt"];
+            readonly description: string;
+            readonly properties: {
+                readonly amount: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "The amount in integer cents.";
+                };
+                readonly recordedBy: {
+                    readonly type: "string";
+                    readonly description: "The ID of the user who recorded the amount.";
+                };
+                readonly recordedAt: {
+                    readonly $ref: "definitions.json#/definitions/date";
+                    readonly description: "When the amount was recorded.";
+                };
+            };
+        };
+        readonly actual: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["amount", "recordedBy", "recordedAt"];
+            readonly description: string;
+            readonly properties: {
+                readonly amount: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "The amount in integer cents.";
+                };
+                readonly recordedBy: {
+                    readonly type: "string";
+                    readonly description: "The ID of the user who recorded the amount.";
+                };
+                readonly recordedAt: {
+                    readonly $ref: "definitions.json#/definitions/date";
+                    readonly description: "When the amount was recorded.";
+                };
+            };
+        };
+        readonly markup: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["percent"];
+            readonly properties: {
+                readonly percent: {
+                    readonly type: "number";
+                    readonly description: string;
+                };
+                readonly custom: {
+                    readonly type: "boolean";
+                    readonly default: false;
+                    readonly description: string;
+                };
+            };
+        };
+        readonly vendorId: {
+            readonly type: readonly ["string", "null"];
+            readonly default: null;
+            readonly description: string;
+        };
+        readonly categoryId: {
+            readonly type: readonly ["string", "null"];
+            readonly default: null;
+            readonly description: string;
+        };
+        readonly vendorInvoices: {
+            readonly type: "array";
+            readonly items: {
+                readonly $ref: "mediaFile.json";
+            };
+            readonly default: readonly [];
+            readonly description: string;
+        };
+        readonly vendorInvoiceNumber: {
+            readonly type: readonly ["string", "null"];
+            readonly default: null;
+            readonly description: string;
+        };
+        readonly billId: {
+            readonly type: readonly ["string", "null"];
+            readonly default: null;
+            readonly description: string;
+        };
+        readonly writtenOff: {
+            readonly type: "boolean";
+            readonly default: false;
+            readonly description: string;
+        };
+        readonly billingReview: {
+            readonly type: "array";
+            readonly default: readonly [];
+            readonly description: string;
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["id", "action", "performedAt"];
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                        readonly description: "The ID of the billing review entry.";
+                    };
+                    readonly action: {
+                        readonly type: "string";
+                        readonly enum: readonly ["writtenOff", "reinstated", "divergenceAcknowledged"];
+                    };
+                    readonly performedBy: {
+                        readonly type: readonly ["string", "null"];
+                        readonly default: null;
+                        readonly description: string;
+                    };
+                    readonly performedAt: {
+                        readonly $ref: "definitions.json#/definitions/date";
+                        readonly description: "When the entry was appended.";
+                    };
+                    readonly note: {
+                        readonly type: readonly ["string", "null"];
+                        readonly default: null;
+                        readonly description: "Free-text rationale for the action.";
+                    };
+                    readonly billedAmount: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: string;
+                    };
+                    readonly priceAmount: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: string;
+                    };
+                };
+            };
+        };
+        readonly type: {
+            readonly type: "string";
+            readonly enum: readonly ["cost"];
+            readonly default: "cost";
+        };
+        readonly source: {
+            readonly type: "string";
+            readonly enum: readonly ["adhoc"];
+            readonly default: "adhoc";
+            readonly description: string;
+        };
+        readonly organizationId: {
+            readonly type: "string";
+            readonly description: string;
+        };
+        readonly propertyId: {
+            readonly type: readonly ["string", "null"];
+            readonly default: null;
+            readonly description: "The property the cost is attributed to, when it concerns one.";
+        };
+        readonly createdBy: {
+            readonly type: readonly ["string", "null"];
+            readonly default: null;
+            readonly description: string;
+        };
+        readonly createdAt: {
+            readonly $ref: "definitions.json#/definitions/date";
+        };
+        readonly updatedAt: {
+            readonly $ref: "definitions.json#/definitions/date";
+        };
+    };
+};
+export type CostSchema = FromSchema<typeof costSchema, {
+    references: [typeof defs, typeof mediaFileSchema];
+    deserialize: [
+        {
+            pattern: {
+                format: "date-time";
+            };
+            output: Date | ISODateString;
+        }
+    ];
+}>;
+/** One entry of a cost's append-only billing review history. */
+export type CostBillingReviewEntry = NonNullable<CostSchema["billingReview"]>[number];

package/dist/schemas/cost.js

@@ -0,0 +1,45 @@
+import { costEntryProperties, costEntryRequired } from "./costEntry.js";
+//#region .generated/schemas/cost.ts
+const costSchema = {
+	$schema: "http://json-schema.org/draft-07/schema",
+	$id: "cost.json",
+	title: "Cost",
+	description: "A OneBill cost entry that no ticket carries: a recurring vendor charge, an expense found while reconciling an invoice, a pass-through cost. It shares the money shape and reconciliation lifecycle of a ticket cost entry and moves through the uninvoiced pool the same way, but because no ticket carries it the DNE approval gate never applies. Stored platform-wide beside bills and stamped with its organization.",
+	type: "object",
+	required: [...costEntryRequired, "organizationId"],
+	additionalProperties: false,
+	properties: {
+		...costEntryProperties,
+		type: {
+			type: "string",
+			enum: ["cost"],
+			default: "cost"
+		},
+		source: {
+			type: "string",
+			enum: ["adhoc"],
+			default: "adhoc",
+			description: "How the entry came to be recorded. Only `adhoc` today, a biller typing in a charge; the enum is what lets a later importer or integration land in the same collection without a second one. A ticket cost entry carries no source: living on the ticket is what says where it came from."
+		},
+		organizationId: {
+			type: "string",
+			description: "The organization the cost is billed to. These entries live in one admin-database collection across every organization, so each carries its owner explicitly — stamped from the request context at creation, never client-supplied."
+		},
+		propertyId: {
+			type: ["string", "null"],
+			default: null,
+			description: "The property the cost is attributed to, when it concerns one."
+		},
+		createdBy: {
+			type: ["string", "null"],
+			default: null,
+			description: "The ID of the billing staff member who recorded the entry. Null when the write was not user-attributable."
+		},
+		createdAt: { $ref: "definitions.json#/definitions/date" },
+		updatedAt: { $ref: "definitions.json#/definitions/date" }
+	}
+};
+//#endregion
+export { costSchema };
+
+//# sourceMappingURL=cost.js.map

package/dist/schemas/cost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.js","names":[],"sources":["../../.generated/schemas/cost.ts"],"sourcesContent":["import defs, { ISODateString } from \"./definitions\";\nimport type { FromSchema } from \"json-schema-to-ts\";\nimport { costEntryProperties, costEntryRequired } from \"./costEntry\";\nimport { mediaFileSchema } from \"./mediaFile\";\n\nexport const costSchema = {\n  $schema: \"http://json-schema.org/draft-07/schema\",\n  $id: \"cost.json\",\n  title: \"Cost\",\n  description:\n    \"A OneBill cost entry that no ticket carries: a recurring vendor charge, \" +\n    \"an expense found while reconciling an invoice, a pass-through cost. It \" +\n    \"shares the money shape and reconciliation lifecycle of a ticket cost \" +\n    \"entry and moves through the uninvoiced pool the same way, but because no \" +\n    \"ticket carries it the DNE approval gate never applies. Stored \" +\n    \"platform-wide beside bills and stamped with its organization.\",\n  type: \"object\",\n  required: [...costEntryRequired, \"organizationId\"],\n  additionalProperties: false,\n  properties: {\n    ...costEntryProperties,\n    type: {\n      type: \"string\",\n      enum: [\"cost\"],\n      default: \"cost\",\n    },\n    source: {\n      type: \"string\",\n      enum: [\"adhoc\"],\n      default: \"adhoc\",\n      description:\n        \"How the entry came to be recorded. Only `adhoc` today, a biller \" +\n        \"typing in a charge; the enum is what lets a later importer or \" +\n        \"integration land in the same collection without a second one. A \" +\n        \"ticket cost entry carries no source: living on the ticket is what \" +\n        \"says where it came from.\",\n    },\n    organizationId: {\n      type: \"string\",\n      description:\n        \"The organization the cost is billed to. These entries live in one \" +\n        \"admin-database collection across every organization, so each \" +\n        \"carries its owner explicitly — stamped from the request context at \" +\n        \"creation, never client-supplied.\",\n    },\n    propertyId: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"The property the cost is attributed to, when it concerns one.\",\n    },\n    createdBy: {\n      type: [\"string\", \"null\"],\n      default: null,\n      description:\n        \"The ID of the billing staff member who recorded the entry. Null \" +\n        \"when the write was not user-attributable.\",\n    },\n    createdAt: {\n      $ref: \"definitions.json#/definitions/date\",\n    },\n    updatedAt: {\n      $ref: \"definitions.json#/definitions/date\",\n    },\n  },\n} as const;\n\nexport type CostSchema = FromSchema<\n  typeof costSchema,\n  {\n    references: [typeof defs, typeof mediaFileSchema];\n    deserialize: [\n      {\n        pattern: {\n          format: \"date-time\";\n        };\n        output: Date | ISODateString;\n      },\n    ];\n  }\n>;\n\n/** One entry of a cost's append-only billing review history. */\nexport type CostBillingReviewEntry = NonNullable<\n  CostSchema[\"billingReview\"]\n>[number];\n"],"mappings":";;AAKA,MAAa,aAAa;CACxB,SAAS;CACT,KAAK;CACL,OAAO;CACP,aACE;CAMF,MAAM;CACN,UAAU,CAAC,GAAG,mBAAmB,gBAAgB;CACjD,sBAAsB;CACtB,YAAY;EACV,GAAG;EACH,MAAM;GACJ,MAAM;GACN,MAAM,CAAC,MAAM;GACb,SAAS;EACX;EACA,QAAQ;GACN,MAAM;GACN,MAAM,CAAC,OAAO;GACd,SAAS;GACT,aACE;EAKJ;EACA,gBAAgB;GACd,MAAM;GACN,aACE;EAIJ;EACA,YAAY;GACV,MAAM,CAAC,UAAU,MAAM;GACvB,SAAS;GACT,aACE;EACJ;EACA,WAAW;GACT,MAAM,CAAC,UAAU,MAAM;GACvB,SAAS;GACT,aACE;EAEJ;EACA,WAAW,EACT,MAAM,qCACR;EACA,WAAW,EACT,MAAM,qCACR;CACF;AACF"}