@aglyn/plugins-bookings 1.0.0-beta.228 → 1.0.0-beta.230

package/src/lib/server/booking-service-ai-capability.js

@@ -0,0 +1,203 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { registerPluginAiCapability } from "@aglyn/aglyn/plugin-manager/plugin-ai-capabilities";
+import { BUNDLE_ID } from "../constants/bundle-common.js";
+import { BOOKING_FIELD_ASKS } from "../model/booking-contact-fields.js";
+import { BOOKING_PRICE_DISPLAYS } from "../model/booking-price.js";
+import { BOOKING_MAX_DURATION_MINUTES, BOOKING_MIN_DURATION_MINUTES } from "../model/bookings.js";
+import { BOOKING_SERVICE_DESCRIPTION_MAX, BOOKING_SERVICE_DRAFT_RESOURCE, BOOKING_SERVICE_NAME_MAX, BOOKING_SERVICE_PRICE_MAX_USD } from "./booking-service-drafts.js";
+/**
+ * WHAT AN AI BUILD CAN MAKE IN BOOKINGS (AGL-3616): a bookable service, as a
+ * draft.
+ *
+ * The capability the AI plugin's build planner offers for "a way to book
+ * me". Its item is written by this plugin's `booking-service` draft writer,
+ * so every rule is the writer's: the plan's `bookings` feature and service
+ * allowance, the member's role, the shape a service takes. The service is
+ * born a draft and takes no bookings until a person activates it on the
+ * Bookings page.
+ *
+ * The arguments are flat, as the contract requires: one set of opening hours
+ * on the weekdays named, which `draftContent` turns into the weekly windows
+ * the service stores. A page that places the Booking block depends on the
+ * service; when the service cannot be made, the page is built without the
+ * block (`degrade: 'omit'`).
+ */ /** The operation's name in a build plan. */ export const BOOKING_SERVICE_AI_OP = 'booking-service';
+/** Weekday names as the planner writes them, in the model's order (0 = Sunday). */ export const BOOKING_SERVICE_AI_DAYS = [
+    'sun',
+    'mon',
+    'tue',
+    'wed',
+    'thu',
+    'fri',
+    'sat'
+];
+/** "09:30" → 570; anything else → `null`. */ function minutesOf(value) {
+    const match = typeof value === 'string' ? value.trim().match(/^(\d{1,2}):(\d{2})$/) : null;
+    if (!match) return null;
+    const hours = Number(match[1]);
+    const minutes = Number(match[2]);
+    if (hours > 24 || minutes > 59 || hours === 24 && minutes > 0) return null;
+    return hours * 60 + minutes;
+}
+/**
+ * The writer's content for an item. Hours that cannot be read are handed on
+ * as a window the writer refuses, so the item fails with the writer's own
+ * sentence rather than being stored with hours nobody asked for.
+ */ export function bookingServiceDraftContentFromArgs(args) {
+    const opens = minutesOf(args['opensAt']);
+    const closes = minutesOf(args['closesAt']);
+    const window = opens === null || closes === null ? {
+        start: -1,
+        end: -1
+    } : {
+        start: opens,
+        end: closes
+    };
+    const days = Array.isArray(args['days']) ? args['days'] : [];
+    const windows = {};
+    for (const day of days){
+        const weekday = BOOKING_SERVICE_AI_DAYS.indexOf(day);
+        if (weekday >= 0) windows[weekday] = [
+            window
+        ];
+    }
+    const copied = [
+        'name',
+        'durationMinutes',
+        'description',
+        'timezone',
+        'priceDisplay',
+        'priceUsd',
+        'askPhone',
+        'askAddress'
+    ];
+    return _extends({}, Object.fromEntries(copied.filter((key)=>args[key] !== undefined).map((key)=>[
+            key,
+            args[key]
+        ])), {
+        windows
+    });
+}
+export const bookingServiceAiCapability = {
+    op: BOOKING_SERVICE_AI_OP,
+    noun: 'booking service',
+    where: 'Bookings → Services',
+    intents: [
+        'a service visitors can book online, with its length, weekly hours and price — set up as a draft to activate',
+        'a way for visitors to book an appointment, consultation or estimate visit'
+    ],
+    argsSchema: {
+        type: 'object',
+        properties: {
+            name: {
+                type: 'string',
+                description: 'What the service is called on the booking widget, e.g. "Free estimate visit".',
+                maxLength: BOOKING_SERVICE_NAME_MAX
+            },
+            durationMinutes: {
+                type: 'integer',
+                description: 'How long one booking takes, in minutes.',
+                minimum: BOOKING_MIN_DURATION_MINUTES,
+                maximum: BOOKING_MAX_DURATION_MINUTES
+            },
+            description: {
+                type: 'string',
+                description: 'One or two sentences on what the visitor is booking.',
+                maxLength: BOOKING_SERVICE_DESCRIPTION_MAX
+            },
+            days: {
+                type: 'array',
+                description: 'The weekdays it can be booked on.',
+                items: {
+                    type: 'string',
+                    enum: BOOKING_SERVICE_AI_DAYS
+                },
+                maxItems: 7
+            },
+            opensAt: {
+                type: 'string',
+                description: 'When bookable hours start on those days, 24-hour "HH:MM", e.g. "09:00".',
+                maxLength: 5
+            },
+            closesAt: {
+                type: 'string',
+                description: 'When bookable hours end on those days, 24-hour "HH:MM", e.g. "17:00".',
+                maxLength: 5
+            },
+            timezone: {
+                type: 'string',
+                description: 'The IANA time zone the hours are in, e.g. "America/Chicago".',
+                maxLength: 64
+            },
+            priceDisplay: {
+                type: 'string',
+                description: 'How the price is stated: "fixed" charges priceUsd when booked; "varies", "estimate" ' + '(a free estimate) and "contact" show a label and book with no charge. Use "fixed" only ' + 'when the request states the price; otherwise "contact" unless it says otherwise.',
+                enum: BOOKING_PRICE_DISPLAYS
+            },
+            priceUsd: {
+                type: 'integer',
+                description: 'The price in whole dollars, only with priceDisplay "fixed" and only when the request states it.',
+                minimum: 0,
+                maximum: BOOKING_SERVICE_PRICE_MAX_USD
+            },
+            askPhone: {
+                type: 'string',
+                description: 'Whether the booking form asks for a phone number.',
+                enum: BOOKING_FIELD_ASKS
+            },
+            askAddress: {
+                type: 'string',
+                description: 'Whether the booking form asks for the address the job is at, for work done on site.',
+                enum: BOOKING_FIELD_ASKS
+            }
+        },
+        required: [
+            'name',
+            'durationMinutes',
+            'days',
+            'opensAt',
+            'closesAt',
+            'timezone'
+        ],
+        additionalProperties: false
+    },
+    maxPerPlan: 5,
+    // Free includes no services (`servicesPerHost: 0`) and no bookings.
+    freeAllowed: false,
+    feature: 'bookings',
+    quota: 'servicesPerHost',
+    draftResource: BOOKING_SERVICE_DRAFT_RESOURCE,
+    // Written without a model: the planner already filled the arguments.
+    estimateCredits: ()=>0,
+    degrade: 'omit',
+    // A page that books this service places the Booking block.
+    pageBlocks: [
+        'booking'
+    ],
+    draftContent: (item)=>bookingServiceDraftContentFromArgs(item.args)
+};
+/**
+ * Registers the capability; the console surface calls it beside the writer,
+ * since only the console runs AI jobs (AGL-3026). Idempotent.
+ */ export function registerBookingServiceAiCapability() {
+    registerPluginAiCapability(bookingServiceAiCapability, {
+        pluginId: BUNDLE_ID
+    });
+}
+
+//# sourceMappingURL=booking-service-ai-capability.js.map

package/src/lib/server/booking-service-ai-capability.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/bookings/src/lib/server/booking-service-ai-capability.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  registerPluginAiCapability,\n  type PluginAiCapability,\n  type PluginAiCapabilityArgs,\n} from '@aglyn/aglyn/plugin-manager/plugin-ai-capabilities'\nimport { BUNDLE_ID } from '../constants/bundle-common'\nimport { BOOKING_FIELD_ASKS } from '../model/booking-contact-fields'\nimport { BOOKING_PRICE_DISPLAYS } from '../model/booking-price'\nimport { BOOKING_MAX_DURATION_MINUTES, BOOKING_MIN_DURATION_MINUTES } from '../model/bookings'\nimport {\n  BOOKING_SERVICE_DESCRIPTION_MAX,\n  BOOKING_SERVICE_DRAFT_RESOURCE,\n  BOOKING_SERVICE_NAME_MAX,\n  BOOKING_SERVICE_PRICE_MAX_USD,\n} from './booking-service-drafts'\n\n/**\n * WHAT AN AI BUILD CAN MAKE IN BOOKINGS (AGL-3616): a bookable service, as a\n * draft.\n *\n * The capability the AI plugin's build planner offers for \"a way to book\n * me\". Its item is written by this plugin's `booking-service` draft writer,\n * so every rule is the writer's: the plan's `bookings` feature and service\n * allowance, the member's role, the shape a service takes. The service is\n * born a draft and takes no bookings until a person activates it on the\n * Bookings page.\n *\n * The arguments are flat, as the contract requires: one set of opening hours\n * on the weekdays named, which `draftContent` turns into the weekly windows\n * the service stores. A page that places the Booking block depends on the\n * service; when the service cannot be made, the page is built without the\n * block (`degrade: 'omit'`).\n */\n\n/** The operation's name in a build plan. */\nexport const BOOKING_SERVICE_AI_OP = 'booking-service'\n\n/** Weekday names as the planner writes them, in the model's order (0 = Sunday). */\nexport const BOOKING_SERVICE_AI_DAYS = ['sun', 'mon', 'tue', 'wed', 'thu', 'fri', 'sat'] as const\n\n/** \"09:30\" → 570; anything else → `null`. */\nfunction minutesOf(value: unknown): number | null {\n  const match = typeof value === 'string' ? value.trim().match(/^(\\d{1,2}):(\\d{2})$/) : null\n  if (!match) return null\n  const hours = Number(match[1])\n  const minutes = Number(match[2])\n  if (hours > 24 || minutes > 59 || (hours === 24 && minutes > 0)) return null\n  return hours * 60 + minutes\n}\n\n/**\n * The writer's content for an item. Hours that cannot be read are handed on\n * as a window the writer refuses, so the item fails with the writer's own\n * sentence rather than being stored with hours nobody asked for.\n */\nexport function bookingServiceDraftContentFromArgs(\n  args: PluginAiCapabilityArgs,\n): Readonly<Record<string, unknown>> {\n  const opens = minutesOf(args['opensAt'])\n  const closes = minutesOf(args['closesAt'])\n  const window = opens === null || closes === null ? { start: -1, end: -1 } : { start: opens, end: closes }\n  const days = Array.isArray(args['days']) ? (args['days'] as readonly string[]) : []\n  const windows: Record<number, Array<{ start: number; end: number }>> = {}\n  for (const day of days) {\n    const weekday = (BOOKING_SERVICE_AI_DAYS as readonly string[]).indexOf(day)\n    if (weekday >= 0) windows[weekday] = [window]\n  }\n  const copied = ['name', 'durationMinutes', 'description', 'timezone', 'priceDisplay', 'priceUsd', 'askPhone', 'askAddress']\n  return {\n    ...Object.fromEntries(copied.filter((key) => args[key] !== undefined).map((key) => [key, args[key]])),\n    windows,\n  }\n}\n\nexport const bookingServiceAiCapability: PluginAiCapability = {\n  op: BOOKING_SERVICE_AI_OP,\n  noun: 'booking service',\n  where: 'Bookings → Services',\n  intents: [\n    'a service visitors can book online, with its length, weekly hours and price — set up as a draft to activate',\n    'a way for visitors to book an appointment, consultation or estimate visit',\n  ],\n  argsSchema: {\n    type: 'object',\n    properties: {\n      name: {\n        type: 'string',\n        description: 'What the service is called on the booking widget, e.g. \"Free estimate visit\".',\n        maxLength: BOOKING_SERVICE_NAME_MAX,\n      },\n      durationMinutes: {\n        type: 'integer',\n        description: 'How long one booking takes, in minutes.',\n        minimum: BOOKING_MIN_DURATION_MINUTES,\n        maximum: BOOKING_MAX_DURATION_MINUTES,\n      },\n      description: {\n        type: 'string',\n        description: 'One or two sentences on what the visitor is booking.',\n        maxLength: BOOKING_SERVICE_DESCRIPTION_MAX,\n      },\n      days: {\n        type: 'array',\n        description: 'The weekdays it can be booked on.',\n        items: { type: 'string', enum: BOOKING_SERVICE_AI_DAYS },\n        maxItems: 7,\n      },\n      opensAt: {\n        type: 'string',\n        description: 'When bookable hours start on those days, 24-hour \"HH:MM\", e.g. \"09:00\".',\n        maxLength: 5,\n      },\n      closesAt: {\n        type: 'string',\n        description: 'When bookable hours end on those days, 24-hour \"HH:MM\", e.g. \"17:00\".',\n        maxLength: 5,\n      },\n      timezone: {\n        type: 'string',\n        description: 'The IANA time zone the hours are in, e.g. \"America/Chicago\".',\n        maxLength: 64,\n      },\n      priceDisplay: {\n        type: 'string',\n        description:\n          'How the price is stated: \"fixed\" charges priceUsd when booked; \"varies\", \"estimate\" ' +\n          '(a free estimate) and \"contact\" show a label and book with no charge. Use \"fixed\" only ' +\n          'when the request states the price; otherwise \"contact\" unless it says otherwise.',\n        enum: BOOKING_PRICE_DISPLAYS,\n      },\n      priceUsd: {\n        type: 'integer',\n        description: 'The price in whole dollars, only with priceDisplay \"fixed\" and only when the request states it.',\n        minimum: 0,\n        maximum: BOOKING_SERVICE_PRICE_MAX_USD,\n      },\n      askPhone: {\n        type: 'string',\n        description: 'Whether the booking form asks for a phone number.',\n        enum: BOOKING_FIELD_ASKS,\n      },\n      askAddress: {\n        type: 'string',\n        description: 'Whether the booking form asks for the address the job is at, for work done on site.',\n        enum: BOOKING_FIELD_ASKS,\n      },\n    },\n    required: ['name', 'durationMinutes', 'days', 'opensAt', 'closesAt', 'timezone'],\n    additionalProperties: false,\n  },\n  maxPerPlan: 5,\n  // Free includes no services (`servicesPerHost: 0`) and no bookings.\n  freeAllowed: false,\n  feature: 'bookings',\n  quota: 'servicesPerHost',\n  draftResource: BOOKING_SERVICE_DRAFT_RESOURCE,\n  // Written without a model: the planner already filled the arguments.\n  estimateCredits: () => 0,\n  degrade: 'omit',\n  // A page that books this service places the Booking block.\n  pageBlocks: ['booking'],\n  draftContent: (item) => bookingServiceDraftContentFromArgs(item.args),\n}\n\n/**\n * Registers the capability; the console surface calls it beside the writer,\n * since only the console runs AI jobs (AGL-3026). Idempotent.\n */\nexport function registerBookingServiceAiCapability(): void {\n  registerPluginAiCapability(bookingServiceAiCapability, { pluginId: BUNDLE_ID })\n}\n"],"names":["registerPluginAiCapability","BUNDLE_ID","BOOKING_FIELD_ASKS","BOOKING_PRICE_DISPLAYS","BOOKING_MAX_DURATION_MINUTES","BOOKING_MIN_DURATION_MINUTES","BOOKING_SERVICE_DESCRIPTION_MAX","BOOKING_SERVICE_DRAFT_RESOURCE","BOOKING_SERVICE_NAME_MAX","BOOKING_SERVICE_PRICE_MAX_USD","BOOKING_SERVICE_AI_OP","BOOKING_SERVICE_AI_DAYS","minutesOf","value","match","trim","hours","Number","minutes","bookingServiceDraftContentFromArgs","args","opens","closes","window","start","end","days","Array","isArray","windows","day","weekday","indexOf","copied","Object","fromEntries","filter","key","undefined","map","bookingServiceAiCapability","op","noun","where","intents","argsSchema","type","properties","name","description","maxLength","durationMinutes","minimum","maximum","items","enum","maxItems","opensAt","closesAt","timezone","priceDisplay","priceUsd","askPhone","askAddress","required","additionalProperties","maxPerPlan","freeAllowed","feature","quota","draftResource","estimateCredits","degrade","pageBlocks","draftContent","item","registerBookingServiceAiCapability","pluginId"],"mappings":"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"}

package/src/lib/server/booking-service-drafts.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type PluginDraftCheck, type PluginResourceDraftWriter } from '@aglyn/aglyn/plugin-manager/plugin-resource-drafts';
+import { type BookingFieldAsk } from '../model/booking-contact-fields';
+import { type BookingPriceDisplay } from '../model/booking-price';
+import { type HostBookingService } from '../model/bookings';
+/**
+ * A BOOKING SERVICE ANOTHER PLUGIN ASKS FOR (AGL-3616).
+ *
+ * The draft writer this plugin registers for the `booking-service` resource
+ * on the core's resource-drafts seam. A plugin that sets a site up from a
+ * brief asks for the writer by name and gets this plugin's rules:
+ *
+ *  - THE DOCUMENT is a `hosts/{hostId}/services/{id}` service in the shape
+ *    the console's service dialog saves, born `status: 'draft'`. A draft is
+ *    offered nowhere — not in the Booking block's list, not by its slots, not
+ *    by the booking route — until a person activates it on the Bookings page.
+ *  - THE ROOM is the `servicesPerHost` allowance, counted the way the
+ *    resources route counts it and inside the transaction that creates, so
+ *    two writes at once cannot both take the last slot. Free includes none.
+ *  - THE PLAN is the `bookings` feature, and THE ROLE is a member who may
+ *    write the site's content — the resources route's two gates, refused in
+ *    its words.
+ *  - THE PRICE is a label (`contact`, `varies`, `estimate`) unless the
+ *    content states a fixed price, so nothing the caller did not say is
+ *    charged. No price stated and no label asked for is `contact`.
+ *
+ * Nothing is published or charged. The writer touches the one new document.
+ */
+type Firestore = FirebaseFirestore.Firestore;
+/** The resource name this writer is registered under. */
+export declare const BOOKING_SERVICE_DRAFT_RESOURCE = "booking-service";
+/** The longest name the console's dialog keeps. */
+export declare const BOOKING_SERVICE_NAME_MAX = 80;
+/** The longest description the console's dialog keeps. */
+export declare const BOOKING_SERVICE_DESCRIPTION_MAX = 500;
+/** The most open intervals one weekday holds. */
+export declare const BOOKING_SERVICE_WINDOWS_PER_DAY_MAX = 12;
+/** The highest fixed price a draft may state, in whole dollars. */
+export declare const BOOKING_SERVICE_PRICE_MAX_USD = 100000;
+/** The resources route's refusal for a member who may not write the site. */
+export declare const BOOKING_SERVICE_ROLE_REFUSAL = "Editing requires the editor role";
+/** The resources route's refusal for a plan without the feature. */
+export declare const BOOKING_SERVICE_PLAN_REFUSAL = "This feature is not included in your plan \u2014 see Billing";
+/** The resources route's refusal at the plan's allowance. */
+export declare function bookingServiceLimitRefusal(limit: number): string;
+/**
+ * What a caller sends as `content`. `windows` is keyed by weekday
+ * (0 = Sunday … 6 = Saturday), each a list of `{ start, end }` in minutes
+ * since midnight in `timezone`. `priceUsd` is read only with
+ * `priceDisplay: 'fixed'`, which needs it.
+ */
+export interface BookingServiceDraftContent {
+    name: string;
+    durationMinutes: number;
+    description?: string;
+    windows: Partial<Record<number, Array<{
+        start: number;
+        end: number;
+    }>>>;
+    timezone: string;
+    priceDisplay?: BookingPriceDisplay;
+    priceUsd?: number;
+    askPhone?: BookingFieldAsk;
+    askAddress?: BookingFieldAsk;
+    crmFollowUpTask?: boolean;
+    crmMeetingActivity?: boolean;
+}
+/** The service document's editable fields, as the writer stores them. */
+export type BookingServiceDraftFields = Required<Pick<HostBookingService, 'name' | 'durationMinutes' | 'windows' | 'timezone' | 'priceDisplay' | 'priceUsd' | 'askPhone' | 'askAddress' | 'crmFollowUpTask' | 'crmMeetingActivity'>> & Pick<HostBookingService, 'description'>;
+export type BookingServiceContentRead = {
+    ok: true;
+    value: BookingServiceDraftFields;
+} | {
+    ok: false;
+    problems: string[];
+};
+/** The content as the writer stores it, or every problem that stops it. */
+export declare function readBookingServiceContent(content: Readonly<Record<string, unknown>>): BookingServiceContentRead;
+/** Whether content is a service this plugin would store, with what it says about it. Pure. */
+export declare function checkBookingServiceContent(content: Readonly<Record<string, unknown>>): PluginDraftCheck;
+export interface BookingServiceDraftWriterDeps {
+    /** The Admin SDK handle; specs hand in a double. */
+    firestore?: () => Firestore;
+}
+export declare function createBookingServiceDraftWriter(deps?: BookingServiceDraftWriterDeps): PluginResourceDraftWriter;
+export declare const bookingServiceDraftWriter: PluginResourceDraftWriter;
+/**
+ * Registers the writer; the console surface calls it, since only the console
+ * runs AI jobs (AGL-3026). Idempotent: a second call replaces the first.
+ */
+export declare function registerBookingServiceDraftWriter(): void;
+export {};

package/src/lib/server/booking-service-drafts.js

@@ -0,0 +1,320 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { hostRoleCanWrite } from "@aglyn/aglyn/app-utils/organizations";
+import { checkEntitlement, checkQuota } from "@aglyn/aglyn/app-utils/plan-entitlements";
+import { registerPluginResourceDraftWriter } from "@aglyn/aglyn/plugin-manager/plugin-resource-drafts";
+import { isValidTimeZone } from "@aglyn/shared-util-timestamp/zoned-time";
+import { firebaseAdmin } from "@aglyn/tenant-data-admin";
+import { BUNDLE_ID } from "../constants/bundle-common.js";
+import { BOOKING_FIELD_ASKS } from "../model/booking-contact-fields.js";
+import { BOOKING_PRICE_DISPLAYS, bookingPriceText } from "../model/booking-price.js";
+import { BOOKING_MAX_DURATION_MINUTES, BOOKING_MIN_DURATION_MINUTES } from "../model/bookings.js";
+/** The resource name this writer is registered under. */ export const BOOKING_SERVICE_DRAFT_RESOURCE = 'booking-service';
+/** The longest name the console's dialog keeps. */ export const BOOKING_SERVICE_NAME_MAX = 80;
+/** The longest description the console's dialog keeps. */ export const BOOKING_SERVICE_DESCRIPTION_MAX = 500;
+/** The most open intervals one weekday holds. */ export const BOOKING_SERVICE_WINDOWS_PER_DAY_MAX = 12;
+/** The highest fixed price a draft may state, in whole dollars. */ export const BOOKING_SERVICE_PRICE_MAX_USD = 100000;
+/** The resources route's refusal for a member who may not write the site. */ export const BOOKING_SERVICE_ROLE_REFUSAL = 'Editing requires the editor role';
+/** The resources route's refusal for a plan without the feature. */ export const BOOKING_SERVICE_PLAN_REFUSAL = 'This feature is not included in your plan — see Billing';
+/** The resources route's refusal at the plan's allowance. */ export function bookingServiceLimitRefusal(limit) {
+    return `Your plan includes ${limit} ${limit === 1 ? 'service' : 'services'} — ` + 'upgrade in Billing for more';
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Text on one line: controls and runs of space folded to one space. */ function line(value) {
+    return typeof value === 'string' ? value.replace(RegExp("[\\u0000-\\u001F\\u007F-\\u009F\\s]+", "gu"), ' ').trim() : '';
+}
+/** The weekly windows, or what is wrong with them. */ function readWindows(value, problems) {
+    const windows = {};
+    if (!isRecord(value)) {
+        problems.push('The service needs weekly hours: at least one open window on one weekday');
+        return windows;
+    }
+    for (const [key, raw] of Object.entries(value)){
+        const weekday = Number(key);
+        if (!/^[0-6]$/.test(key) || !Number.isInteger(weekday)) {
+            problems.push(`"${key}" is not a weekday: weekdays are 0 (Sunday) to 6 (Saturday)`);
+            continue;
+        }
+        if (!Array.isArray(raw)) {
+            problems.push(`The hours for weekday ${key} are not a list of windows`);
+            continue;
+        }
+        if (!raw.length) continue;
+        if (raw.length > BOOKING_SERVICE_WINDOWS_PER_DAY_MAX) {
+            problems.push(`Weekday ${key} has more than ${BOOKING_SERVICE_WINDOWS_PER_DAY_MAX} windows`);
+            continue;
+        }
+        const day = [];
+        for (const window of raw){
+            const start = isRecord(window) ? window['start'] : undefined;
+            const end = isRecord(window) ? window['end'] : undefined;
+            if (typeof start !== 'number' || typeof end !== 'number' || !Number.isInteger(start) || !Number.isInteger(end) || start < 0 || end > 24 * 60 || end <= start) {
+                problems.push(`A window on weekday ${key} is not a start before its end, in whole minutes from 0 to 1440`);
+                continue;
+            }
+            day.push({
+                start,
+                end
+            });
+        }
+        day.sort((a, b)=>a.start - b.start);
+        if (day.some((window, index)=>index > 0 && window.start < day[index - 1].end)) {
+            problems.push(`Two windows on weekday ${key} overlap`);
+        }
+        if (day.length) windows[weekday] = day;
+    }
+    if (!Object.keys(windows).length && !problems.length) {
+        problems.push('The service needs weekly hours: at least one open window on one weekday');
+    }
+    return windows;
+}
+function readAsk(label, value, problems) {
+    if (value === undefined) return 'off';
+    if (BOOKING_FIELD_ASKS.includes(value)) return value;
+    problems.push(`Asking for ${label} is off, optional or required`);
+    return 'off';
+}
+function readSwitch(label, value, fallback, problems) {
+    if (value === undefined) return fallback;
+    if (typeof value === 'boolean') return value;
+    problems.push(`${label} is on or off`);
+    return fallback;
+}
+/** The content as the writer stores it, or every problem that stops it. */ export function readBookingServiceContent(content) {
+    const problems = [];
+    const name = line(content['name']);
+    if (!name) problems.push('The service needs a name');
+    else if (name.length > BOOKING_SERVICE_NAME_MAX) {
+        problems.push(`The name is longer than ${BOOKING_SERVICE_NAME_MAX} characters`);
+    }
+    const duration = content['durationMinutes'];
+    if (typeof duration !== 'number' || !Number.isInteger(duration) || duration < BOOKING_MIN_DURATION_MINUTES || duration > BOOKING_MAX_DURATION_MINUTES) {
+        problems.push(`The length is whole minutes from ${BOOKING_MIN_DURATION_MINUTES} to ${BOOKING_MAX_DURATION_MINUTES}`);
+    }
+    const rawDescription = content['description'];
+    const description = typeof rawDescription === 'string' ? rawDescription.trim() : '';
+    if (rawDescription !== undefined && typeof rawDescription !== 'string') {
+        problems.push('The description is text');
+    } else if (description.length > BOOKING_SERVICE_DESCRIPTION_MAX) {
+        problems.push(`The description is longer than ${BOOKING_SERVICE_DESCRIPTION_MAX} characters`);
+    }
+    const timezone = line(content['timezone']);
+    if (!isValidTimeZone(timezone)) {
+        problems.push('The time zone is an IANA zone, such as America/Chicago');
+    }
+    const windows = readWindows(content['windows'], problems);
+    // No price stated and no label asked for is "Contact for price": a draft
+    // never charges what the caller did not say.
+    const rawPrice = content['priceUsd'];
+    const askedDisplay = content['priceDisplay'];
+    let priceDisplay = 'contact';
+    let priceUsd = 0;
+    if (askedDisplay !== undefined) {
+        if (BOOKING_PRICE_DISPLAYS.includes(askedDisplay)) {
+            priceDisplay = askedDisplay;
+        } else {
+            problems.push('The price is stated as fixed, varies, estimate or contact');
+        }
+    } else if (rawPrice !== undefined) {
+        priceDisplay = 'fixed';
+    }
+    if (priceDisplay === 'fixed') {
+        if (typeof rawPrice !== 'number' || !Number.isInteger(rawPrice) || rawPrice < 0 || rawPrice > BOOKING_SERVICE_PRICE_MAX_USD) {
+            problems.push(`A fixed price is whole dollars from 0 to ${BOOKING_SERVICE_PRICE_MAX_USD}; ` + 'state it, or say the price varies, is a free estimate, or is on request');
+        } else {
+            priceUsd = rawPrice;
+        }
+    }
+    const askPhone = readAsk('a phone number', content['askPhone'], problems);
+    const askAddress = readAsk('an address', content['askAddress'], problems);
+    // The model's defaults: a booking files a meeting, and owes no follow-up.
+    const crmMeetingActivity = readSwitch('Filing a meeting', content['crmMeetingActivity'], true, problems);
+    const crmFollowUpTask = readSwitch('A follow-up task', content['crmFollowUpTask'], false, problems);
+    if (problems.length) return {
+        ok: false,
+        problems: [
+            ...new Set(problems)
+        ]
+    };
+    return {
+        ok: true,
+        value: _extends({
+            name,
+            durationMinutes: duration
+        }, description ? {
+            description
+        } : {}, {
+            windows,
+            timezone,
+            priceDisplay,
+            priceUsd,
+            askPhone,
+            askAddress,
+            crmMeetingActivity,
+            crmFollowUpTask
+        })
+    };
+}
+/** What a caller is told about a service, written or about to be. */ function factsOf(value) {
+    var _value_priceDisplay, _value_timezone, _value_windows;
+    return {
+        status: 'draft',
+        durationMinutes: value.durationMinutes,
+        priceDisplay: (_value_priceDisplay = value.priceDisplay) != null ? _value_priceDisplay : 'fixed',
+        priceText: bookingPriceText(value),
+        timezone: (_value_timezone = value.timezone) != null ? _value_timezone : 'UTC',
+        openWeekdays: Object.keys((_value_windows = value.windows) != null ? _value_windows : {}).map(Number).sort((a, b)=>a - b)
+    };
+}
+/** Whether content is a service this plugin would store, with what it says about it. Pure. */ export function checkBookingServiceContent(content) {
+    const read = readBookingServiceContent(content);
+    if (read.ok === false) return read;
+    return {
+        ok: true,
+        facts: factsOf(read.value)
+    };
+}
+function recordOf(service) {
+    var _service_data, _data_name;
+    const data = (_service_data = service.data()) != null ? _service_data : {};
+    return {
+        id: service.id,
+        name: String((_data_name = data.name) != null ? _data_name : ''),
+        versionId: null,
+        facts: _extends({}, factsOf(data), {
+            status: data.status === 'draft' ? 'draft' : 'active'
+        })
+    };
+}
+function roleRefusal(host, uid) {
+    var _host_get;
+    const role = ((_host_get = host.get('memberRoles')) != null ? _host_get : {})[uid];
+    return hostRoleCanWrite(role) ? null : {
+        status: 403,
+        error: BOOKING_SERVICE_ROLE_REFUSAL
+    };
+}
+function planRefusal(org) {
+    return checkEntitlement(org, 'bookings') ? null : {
+        status: 403,
+        error: BOOKING_SERVICE_PLAN_REFUSAL
+    };
+}
+/**
+ * The allowance, counted as `/api/hosts/resources` counts a service create:
+ * every document in the collection.
+ */ function roomRefusal(org, used) {
+    const quota = checkQuota(org, 'servicesPerHost', used);
+    return quota.allowed ? null : {
+        status: 403,
+        error: bookingServiceLimitRefusal(quota.limit)
+    };
+}
+export function createBookingServiceDraftWriter(deps = {}) {
+    var _deps_firestore;
+    const firestore = (_deps_firestore = deps.firestore) != null ? _deps_firestore : ()=>firebaseAdmin.app().firestore();
+    return {
+        refusal: async (context)=>{
+            var _roleRefusal;
+            const hostRef = firestore().collection('hosts').doc(context.hostId);
+            const host = await hostRef.get();
+            if (!host.exists) return {
+                status: 404,
+                error: 'Unknown site'
+            };
+            const early = (_roleRefusal = roleRefusal(host, context.uid)) != null ? _roleRefusal : planRefusal(context.org);
+            if (early) return early;
+            const used = (await hostRef.collection('services').count().get()).data().count;
+            return roomRefusal(context.org, Number(used) || 0);
+        },
+        check: (content)=>checkBookingServiceContent(content),
+        read: async ({ hostId, id })=>{
+            const service = await firestore().collection('hosts').doc(hostId).collection('services').doc(id).get();
+            return service.exists ? recordOf(service) : null;
+        },
+        write: async (request)=>{
+            // The request's name is the one asked for; the content's stands in.
+            const asked = line(request.name);
+            const read = readBookingServiceContent(asked ? _extends({}, request.content, {
+                name: asked
+            }) : request.content);
+            if (read.ok === false) return {
+                ok: false,
+                status: 400,
+                error: read.problems[0]
+            };
+            const db = firestore();
+            const hostRef = db.collection('hosts').doc(request.hostId);
+            const servicesRef = hostRef.collection('services');
+            const serviceRef = servicesRef.doc(request.id);
+            return db.runTransaction(async (tx)=>{
+                var _roleRefusal;
+                // Every read before any write, which Firestore requires.
+                const [host, existing] = await Promise.all([
+                    tx.get(hostRef),
+                    tx.get(serviceRef)
+                ]);
+                if (!host.exists) return {
+                    ok: false,
+                    status: 404,
+                    error: 'Unknown site'
+                };
+                // Asked again under the same id: the draft it already wrote.
+                if (existing.exists) return _extends({
+                    ok: true,
+                    replayed: true
+                }, recordOf(existing));
+                const early = (_roleRefusal = roleRefusal(host, request.uid)) != null ? _roleRefusal : planRefusal(request.org);
+                if (early) return _extends({
+                    ok: false
+                }, early);
+                const used = (await tx.get(servicesRef.count())).data().count;
+                const room = roomRefusal(request.org, Number(used) || 0);
+                if (room) return _extends({
+                    ok: false
+                }, room);
+                tx.create(serviceRef, _extends({}, read.value, {
+                    status: 'draft',
+                    createdAt: request.now,
+                    updatedAt: request.now,
+                    createdBy: request.uid
+                }));
+                return {
+                    ok: true,
+                    replayed: false,
+                    id: request.id,
+                    name: read.value.name,
+                    versionId: null,
+                    facts: factsOf(read.value)
+                };
+            });
+        }
+    };
+}
+export const bookingServiceDraftWriter = createBookingServiceDraftWriter();
+/**
+ * Registers the writer; the console surface calls it, since only the console
+ * runs AI jobs (AGL-3026). Idempotent: a second call replaces the first.
+ */ export function registerBookingServiceDraftWriter() {
+    registerPluginResourceDraftWriter(BOOKING_SERVICE_DRAFT_RESOURCE, bookingServiceDraftWriter, {
+        pluginId: BUNDLE_ID
+    });
+}
+
+//# sourceMappingURL=booking-service-drafts.js.map