slotlock 0.6.3 → 0.8.0

package/agent-store-backend.d.ts

@@ -1,9 +1,11 @@
 import type { Sql } from 'postgres';
 import type { SlotlockAgentChangeSource } from './change-watch.js';
+import { type SlotlockChangeOrigin } from './event-feed.js';
 import { type SlotlockAgentCalendarBackend, type SlotlockAgentInvocationContext } from './agent-server.js';
 import type { SlotlockApplicationBackend } from './application-api.js';
 import { type SlotlockStore } from './store.js';
-import type { SlotlockCalendarEvent, SlotlockResource, WeeklyAvailabilityRule } from './types.js';
+import type { SlotlockApproval, SlotlockCalendarEvent, SlotlockResource, WeeklyAvailabilityRule } from './types.js';
+import { type SlotlockPartnerStore } from './partners.js';
 export interface SlotlockStoreAgentBackendOptions {
     /**
      * The default bookable hours, for resources without hours of their own
@@ -13,6 +15,12 @@ export interface SlotlockStoreAgentBackendOptions {
     /** Provider sources that must prove complete coverage before availability is called certain. */
     requiredCoverageSources?(context: SlotlockAgentInvocationContext, resource: SlotlockResource): Promise<readonly string[]>;
     coverageMaxAgeMs?: number;
+    /**
+     * The longest an approval policy may hold a write for a person (RFC 0004 A4), in minutes: each
+     * policy sets its own wait, bounded by the booking's start less its lead time and by this. 1 to
+     * 43,200 (30 days, the default).
+     */
+    maxApprovalMinutes?: number;
 }
 /**
  * A stored calendar event in the shape the event tools return. Exported for an application that
@@ -47,7 +55,32 @@ export interface SlotlockStoreApplicationBackendOptions {
      * undone, and an operator may owe a tenant's data a retention or review first.
      */
     tenantErasure?: boolean;
+    /**
+     * The partner API (RFC 0003 P3): the partner store (partners.ts) its operations run through, for
+     * the partner a partner key names. Unset: they answer 404 partner_api_not_served.
+     */
+    partners?: SlotlockPartnerStore;
+    /**
+     * The agent backend (`createSlotlockStoreAgentBackend`) a granted approval's booking is made
+     * through (RFC 0004 A4), as the agent that asked. Unset: a grant answers 409
+     * approvals_unavailable; declining still works.
+     */
+    agentBackend?: SlotlockAgentCalendarBackend;
 }
+/**
+ * Run a granted approval's write as the agent that asked for it, in one transaction with the grant:
+ * its holds give way, the write is made, and the approval is marked granted.
+ */
+export declare function runSlotlockApprovalGrant(agentBackend: SlotlockAgentCalendarBackend, approval: SlotlockApproval & {
+    requester: Record<string, unknown>;
+}, grant: {
+    tenantRef: string;
+    decidedBy: string;
+    signal: AbortSignal;
+    origin?: SlotlockChangeOrigin;
+    /** Make the booking and the grant, then roll both back (RFC 0004 A3). */
+    dryRun?: boolean;
+}): Promise<Record<string, unknown>>;
 /**
  * Serve the application API (application-api.ts) from the store in the principal's tenant. Every
  * resource named must be the tenant's, or it is not found; holds are under the tenant's RLS, so