@happyvertical/smrt-bookings 0.60.7 → 0.60.9

package/dist/types.d.ts

@@ -3,7 +3,7 @@ export interface BookingContext {
     tenantId: string;
     actorId: string;
 }
-export type BookingOperation = 'configure-offering' | 'declare-availability' | 'request' | 'propose' | 'assent' | 'confirm' | 'decline' | 'cancel' | 'read' | 'history';
+export type BookingOperation = 'configure-offering' | 'declare-availability' | 'request' | 'propose' | 'assent' | 'confirm' | 'decline' | 'cancel' | 'attach-project' | 'read' | 'history';
 export interface BookingAccess {
     operator: boolean;
     /** Customer contact the host currently maps to this actor, if any. */
@@ -25,11 +25,53 @@ export interface BookingReferences {
 export interface BookingAuthority {
     access(context: Readonly<BookingContext>, operation: BookingOperation): Promise<BookingAccess | null>;
     verifyReferences(context: Readonly<BookingContext>, references: Readonly<BookingReferences>): Promise<boolean>;
-}
+    /**
+     * Optional. Used instead of verifyReferences for the contact when a booking has
+     * no project (a lead-bound request). Must confirm the contact exists in this
+     * tenant and that the actor may act for it. When absent, the contact is passed
+     * to verifyReferences as before.
+     */
+    verifyContact?(context: Readonly<BookingContext>, contactId: string): Promise<boolean>;
+}
+/**
+ * `developer-hour` is dedicated, exclusive attention for any unit (the name is
+ * kept for schema compatibility); `supervision-day` is shared supervision
+ * capacity and is always one day.
+ */
 export type BookingKind = 'developer-hour' | 'supervision-day';
+/** Sales granularity of an offering. */
+export type BookingUnit = 'hour' | 'day' | 'week' | 'month';
 export interface BookingOffering {
     id: string;
     kind: BookingKind;
+    unit: BookingUnit;
+    /** Integer minor units, or null when the offering is unpriced. */
+    priceCents: number | null;
+    /** ISO 4217 uppercase code, null iff priceCents is null. */
+    currency: string | null;
+    /** Short display name, at most 120 characters. */
+    title: string;
+    /** Plain-text description, at most 2000 characters. */
+    description: string;
+    /** Discoverable by a reader with no contact mapping. Only affects discovery. */
+    public: boolean;
+    enabled: boolean;
+}
+export interface ConfigureOfferingInput {
+    offeringId: string;
+    kind: BookingKind;
+    /** Defaults from kind: developer-hour is hour, supervision-day is day. Frozen after creation. */
+    unit?: BookingUnit;
+    /** Integer minor units; default null (unpriced). */
+    priceCents?: number | null;
+    /** ISO 4217 uppercase code; set together with priceCents. */
+    currency?: string | null;
+    /** Default ''. */
+    title?: string;
+    /** Default ''. */
+    description?: string;
+    /** Default false. */
+    public?: boolean;
     enabled: boolean;
 }
 export interface BookingPageOptions {
@@ -40,6 +82,32 @@ export interface BookingPageOptions {
 }
 export interface ListBookingsOptions extends BookingPageOptions {
     projectId?: string;
+    /** Operators may narrow to one contact; other callers may only name their own. */
+    contactId?: string;
+}
+export interface ListOpenSlotsOptions {
+    offeringId: string;
+    /** ISO 8601 instants. to - from must be positive and at most 400 days. */
+    from: string;
+    to: string;
+    /** Default 1. Supervision offerings accept only 1. */
+    quantity?: number;
+    /** Narrow to one provider. */
+    providerId?: string;
+    /** Opaque nextCursor from the previous page. */
+    after?: string;
+    /** Defaults to 50. Accepts 1 through 100. */
+    limit?: number;
+}
+export interface OpenSlot {
+    providerId: string;
+    offeringId: string;
+    unit: BookingUnit;
+    quantity: number;
+    /** Candidate segments to pass as `windows` to propose(). */
+    windows: ResolvedBookingWindow[];
+    /** 1 for dedicated slots; the minimum remaining shared units for supervision. */
+    remainingCapacity: number;
 }
 export interface BookingPage<T> {
     items: T[];
@@ -81,14 +149,28 @@ export interface ProposalTerms {
 export interface BookingProposal {
     id: string;
     providerId: string;
+    /** Overall span: first window start to last window end. */
     window: ResolvedBookingWindow;
+    /** Reserved segments, sorted, non-overlapping and in one zone. */
+    windows: ResolvedBookingWindow[];
+    unit: BookingUnit;
+    quantity: number;
+    /** Frozen from the offering at proposal time; null when unpriced. */
+    unitPriceCents: number | null;
+    currency: string | null;
+    /** unitPriceCents * quantity; null when unpriced. */
+    totalCents: number | null;
     terms: ProposalTerms;
     approvedPlan: ApprovedPlanRef | null;
 }
 export interface ProposeBookingInput {
     bookingId: string;
     providerId: string;
-    window: BookingWindow;
+    /** Exactly one of `window` (single segment) or `windows`. */
+    window?: BookingWindow;
+    windows?: readonly BookingWindow[];
+    /** Defaults to the request's quantity. */
+    quantity?: number;
     terms: ProposalTerms;
     approvedPlan?: ApprovedPlanRef;
 }
@@ -96,6 +178,8 @@ export interface RequestBookingInput {
     offeringId: string;
     contactId: string;
     projectId?: string;
+    /** Positive integer, default 1, at most 1000; supervision must be 1. */
+    quantity?: number;
 }
 export type BookingStatus = 'requested' | 'proposed' | 'confirmed' | 'declined' | 'cancelled';
 export interface BookingView {
@@ -104,6 +188,8 @@ export interface BookingView {
     contactId: string;
     projectId: string | null;
     kind: BookingKind;
+    unit: BookingUnit;
+    quantity: number;
     status: BookingStatus;
     proposal: BookingProposal | null;
     assentedProposalId: string | null;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/windows.d.ts

@@ -1,4 +1,4 @@
-import type { AvailabilityWindow, BookingWindow, DeclaredAvailabilityWindow, ResolvedBookingWindow } from './types.js';
+import type { AvailabilityWindow, BookingUnit, BookingWindow, DeclaredAvailabilityWindow, ResolvedBookingWindow } from './types.js';
 /** Resolve half-open wall time; a DST fold must name the intended offset. */
 export declare function resolveBookingWindow(window: BookingWindow): ResolvedBookingWindow;
 export declare function elapsedHour(window: ResolvedBookingWindow): boolean;
@@ -9,6 +9,33 @@ export interface Reservation {
     exclusive: boolean;
 }
 export declare function supervisionDeclared(candidate: ResolvedBookingWindow, windows: readonly DeclaredAvailabilityWindow[]): boolean;
-/** Check every segment; endpoints belonging to ending windows are excluded. */
+/**
+ * Remaining units for the candidate: 0 when it does not fit, 1 for an exclusive
+ * candidate that fits, and for a shared candidate the minimum of
+ * (capacity - shared) across every half-open segment. Endpoints belonging to
+ * ending windows are excluded.
+ */
+export declare function remainingCapacity(candidate: Reservation, declared: readonly DeclaredAvailabilityWindow[], occupied: readonly Reservation[]): number;
 export declare function fitsCapacity(candidate: Reservation, declared: readonly DeclaredAvailabilityWindow[], occupied: readonly Reservation[]): boolean;
+/** Most segments one proposal may reserve; discovery never lists a larger bundle. */
+export declare const MAX_SEGMENTS = 400;
+/** Resolve one or more same-zone segments into sorted, non-overlapping windows and their span. */
+export declare function resolveCoverage(windows: readonly BookingWindow[]): {
+    windows: ResolvedBookingWindow[];
+    span: ResolvedBookingWindow;
+};
+/** Add n local days to YYYY-MM-DD with date-only arithmetic. */
+export declare function addLocalDays(date: string, days: number): string;
+/** Add n calendar months, constraining the day to the target month's length. */
+export declare function addLocalMonths(date: string, months: number): string;
+/** Exclusive local end date of a quantity of the unit starting on a local date. */
+export declare function localEnd(unit: BookingUnit, quantity: number, start: string): string;
+/** True iff the segments measure exactly `quantity` of `unit`. */
+export declare function measures(unit: BookingUnit, quantity: number, windows: readonly ResolvedBookingWindow[]): boolean;
+/** Do these segments fall in the half-open local span of a quantity of unit from a date? */
+export declare function withinLocalSpan(window: ResolvedBookingWindow, unit: Exclude<BookingUnit, 'hour'>, quantity: number, from: string): boolean;
+/** Render a UTC instant as a minute-precision local timestamp with its zone offset. */
+export declare function formatWall(instantIso: string, zone: string): string;
+/** Build a resolved window from two UTC instants, rendered in the zone. */
+export declare function windowFromInstants(zone: string, startMs: number, endMs: number): ResolvedBookingWindow;
 //# sourceMappingURL=windows.d.ts.map

package/dist/windows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"windows.d.ts","sourceRoot":"","sources":["../src/windows.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,aAAa,EACb,0BAA0B,EAC1B,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAqDpB,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,GACpB,qBAAqB,CAiBvB;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAIlE;AAYD,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,kBAAkB,EAAE,GACrC,0BAA0B,EAAE,CAuC9B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,qBAAqB,EAChC,OAAO,EAAE,SAAS,0BAA0B,EAAE,GAC7C,OAAO,CAQT;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAC1B,SAAS,EAAE,WAAW,EACtB,QAAQ,EAAE,SAAS,0BAA0B,EAAE,EAC/C,QAAQ,EAAE,SAAS,WAAW,EAAE,GAC/B,OAAO,CAwDT"}
+{"version":3,"file":"windows.d.ts","sourceRoot":"","sources":["../src/windows.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,0BAA0B,EAC1B,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAqDpB,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,GACpB,qBAAqB,CAiBvB;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAIlE;AAYD,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,kBAAkB,EAAE,GACrC,0BAA0B,EAAE,CAuC9B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,qBAAqB,EAChC,OAAO,EAAE,SAAS,0BAA0B,EAAE,GAC7C,OAAO,CAQT;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,WAAW,EACtB,QAAQ,EAAE,SAAS,0BAA0B,EAAE,EAC/C,QAAQ,EAAE,SAAS,WAAW,EAAE,GAC/B,MAAM,CA6DR;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,WAAW,EACtB,QAAQ,EAAE,SAAS,0BAA0B,EAAE,EAC/C,QAAQ,EAAE,SAAS,WAAW,EAAE,GAC/B,OAAO,CAET;AAED,qFAAqF;AACrF,eAAO,MAAM,YAAY,MAAM,CAAC;AAEhC,kGAAkG;AAClG,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG;IAClE,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,IAAI,EAAE,qBAAqB,CAAC;CAC7B,CAkCA;AAMD,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CASnE;AAED,mFAAmF;AACnF,wBAAgB,QAAQ,CACtB,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,MAAM,CAIR;AASD,kEAAkE;AAClE,wBAAgB,QAAQ,CACtB,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS,qBAAqB,EAAE,GACxC,OAAO,CAoCT;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAC7B,MAAM,EAAE,qBAAqB,EAC7B,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,EAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAET;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAsBnE;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,qBAAqB,CAMvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-bookings",
-  "version": "0.60.7",
+  "version": "0.60.9",
   "description": "Operator-managed service reservations for SMRT",
   "type": "module",
   "author": "HappyVertical",
@@ -22,7 +22,7 @@
     "@happyvertical/sql": "^0.111.3"
   },
   "devDependencies": {
-    "@happyvertical/smrt-vitest": "0.60.7",
+    "@happyvertical/smrt-vitest": "0.60.9",
     "@types/node": "24.13.6",
     "typescript": "6.0.3",
     "vite": "8.1.6",