@voyantjs/availability 0.1.0

package/LICENSE

@@ -0,0 +1,109 @@
+# Functional Source License, Version 1.1, Apache 2.0 Future License
+
+## Abbreviation
+
+FSL-1.1-Apache-2.0
+
+## Notice
+
+Copyright 2026 PixelMakers Studio SRL
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly
+display and redistribute the Software for any Permitted Purpose identified
+below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing
+Use means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe
+our patents, the license grant above includes a license under our patents.
+If you make a claim against any party that the Software infringes or
+contributes to the infringement of any patent, then your patent license to
+the Software ends immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives
+of the Software.
+
+If you redistribute any copies, modifications or derivatives of the
+Software, you must include a copy of or a link to these Terms and Conditions
+and not remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A
+PARTICULAR PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO
+THE SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL
+DAMAGES, EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin
+of the Software, you have no right under these Terms and Conditions to use
+our trademarks, trade names, service marks or product names.
+
+---
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software
+under the Apache License, Version 2.0 that is effective on the second
+anniversary of the date we make the Software available. On or after that
+date, you may use the Software under the Apache License, Version 2.0, in
+which case the following will apply:
+
+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.

package/README.md

@@ -0,0 +1,35 @@
+# @voyantjs/availability
+
+Availability module for Voyant. Dated availability, slots, closeouts, and pickup capacity — the primary signal sellability consumes when resolving candidate offers.
+
+## Install
+
+```bash
+pnpm add @voyantjs/availability
+```
+
+## Usage
+
+```typescript
+import { availabilityModule } from "@voyantjs/availability"
+import { createApp } from "@voyantjs/hono"
+
+const app = createApp({
+  modules: [availabilityModule],
+  // ...
+})
+```
+
+## Exports
+
+| Entry | Description |
+| --- | --- |
+| `.` | Module export |
+| `./schema` | Drizzle tables |
+| `./validation` | Zod schemas |
+| `./routes` | Hono routes |
+| `./rrule` | RFC 5545 recurrence-rule helpers |
+
+## License
+
+FSL-1.1-Apache-2.0

package/dist/generate-slots.d.ts

@@ -0,0 +1,27 @@
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+export type GenerateAvailabilitySlotsOptions = {
+    /** If provided, only generate slots for this rule. Otherwise, process all active rules. */
+    ruleId?: string;
+    /** How many days ahead from "now" to generate slots for. Defaults to 90. */
+    horizonDays?: number;
+    /** Default start time (HH:MM, 24h) used when a rule does not define one. Defaults to "09:00". */
+    defaultStartTime?: string;
+    /** Cap on slots expanded per rule. Defaults to 1000. */
+    perRuleLimit?: number;
+    /** Override "now" for deterministic generation. Defaults to new Date(). */
+    now?: Date;
+};
+export type GenerateAvailabilitySlotsResult = {
+    rulesProcessed: number;
+    slotsCreated: number;
+    slotsSkipped: number;
+};
+/**
+ * Materialize availability slots from active availability rules.
+ *
+ * Wall-clock convention: `startsAt` is stored as if UTC for the wall-clock
+ * time on `dateLocal` in the rule's `timezone`. Callers that need true
+ * UTC-instant semantics should post-process with their own timezone library.
+ */
+export declare function generateAvailabilitySlots(db: PostgresJsDatabase, options?: GenerateAvailabilitySlotsOptions): Promise<GenerateAvailabilitySlotsResult>;
+//# sourceMappingURL=generate-slots.d.ts.map

package/dist/generate-slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-slots.d.ts","sourceRoot":"","sources":["../src/generate-slots.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAKjE,MAAM,MAAM,gCAAgC,GAAG;IAC7C,2FAA2F;IAC3F,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iGAAiG;IACjG,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2EAA2E;IAC3E,GAAG,CAAC,EAAE,IAAI,CAAA;CACX,CAAA;AAED,MAAM,MAAM,+BAA+B,GAAG;IAC5C,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,EAAE,EAAE,kBAAkB,EACtB,OAAO,GAAE,gCAAqC,GAC7C,OAAO,CAAC,+BAA+B,CAAC,CA6E1C"}

package/dist/generate-slots.js

@@ -0,0 +1,71 @@
+import { and, eq, inArray } from "drizzle-orm";
+import { expandRRule } from "./rrule.js";
+import { availabilityRules, availabilitySlots } from "./schema.js";
+/**
+ * Materialize availability slots from active availability rules.
+ *
+ * Wall-clock convention: `startsAt` is stored as if UTC for the wall-clock
+ * time on `dateLocal` in the rule's `timezone`. Callers that need true
+ * UTC-instant semantics should post-process with their own timezone library.
+ */
+export async function generateAvailabilitySlots(db, options = {}) {
+    const horizonDays = options.horizonDays ?? 90;
+    const defaultStartTime = options.defaultStartTime ?? "09:00";
+    const perRuleLimit = options.perRuleLimit ?? 1000;
+    const now = options.now ?? new Date();
+    const from = new Date(now);
+    from.setUTCHours(0, 0, 0, 0);
+    const to = new Date(from);
+    to.setUTCDate(to.getUTCDate() + horizonDays);
+    const ruleFilters = [eq(availabilityRules.active, true)];
+    if (options.ruleId)
+        ruleFilters.push(eq(availabilityRules.id, options.ruleId));
+    const rules = await db
+        .select()
+        .from(availabilityRules)
+        .where(and(...ruleFilters));
+    let slotsCreated = 0;
+    let slotsSkipped = 0;
+    for (const rule of rules) {
+        const dates = expandRRule(rule.recurrenceRule, from, to, perRuleLimit);
+        if (dates.length === 0)
+            continue;
+        const existing = await db
+            .select({ dateLocal: availabilitySlots.dateLocal })
+            .from(availabilitySlots)
+            .where(and(eq(availabilitySlots.productId, rule.productId), eq(availabilitySlots.availabilityRuleId, rule.id), inArray(availabilitySlots.dateLocal, dates)));
+        const existingSet = new Set(existing.map((row) => row.dateLocal));
+        const toInsert = dates.filter((d) => !existingSet.has(d));
+        slotsSkipped += dates.length - toInsert.length;
+        if (toInsert.length === 0)
+            continue;
+        const [hh, mm] = defaultStartTime.split(":");
+        const hour = Number.parseInt(hh ?? "9", 10) || 0;
+        const minute = Number.parseInt(mm ?? "0", 10) || 0;
+        const rows = toInsert.map((dateLocal) => {
+            const [y, m, d] = dateLocal.split("-").map((s) => Number.parseInt(s, 10));
+            // Wall-clock-as-UTC: interpret the local date/time as if it were UTC.
+            const startsAt = new Date(Date.UTC(y ?? 1970, (m ?? 1) - 1, d ?? 1, hour, minute, 0, 0));
+            return {
+                productId: rule.productId,
+                optionId: rule.optionId,
+                facilityId: rule.facilityId,
+                availabilityRuleId: rule.id,
+                dateLocal,
+                startsAt,
+                timezone: rule.timezone,
+                status: "open",
+                unlimited: false,
+                initialPax: rule.maxCapacity,
+                remainingPax: rule.maxCapacity,
+            };
+        });
+        await db.insert(availabilitySlots).values(rows);
+        slotsCreated += rows.length;
+    }
+    return {
+        rulesProcessed: rules.length,
+        slotsCreated,
+        slotsSkipped,
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import type { Module } from "@voyantjs/core";
+import type { HonoModule } from "@voyantjs/hono/module";
+import { availabilityService } from "./service.js";
+export type { AvailabilityRoutes } from "./routes.js";
+export declare const availabilityModule: Module;
+export declare const availabilityHonoModule: HonoModule;
+export { type GenerateAvailabilitySlotsOptions, type GenerateAvailabilitySlotsResult, generateAvailabilitySlots, } from "./generate-slots.js";
+export type { AvailabilityCloseout, AvailabilityPickupPoint, AvailabilityRule, AvailabilitySlot, AvailabilitySlotPickup, AvailabilityStartTime, CustomPickupArea, LocationPickupTime, NewAvailabilityCloseout, NewAvailabilityPickupPoint, NewAvailabilityRule, NewAvailabilitySlot, NewAvailabilitySlotPickup, NewAvailabilityStartTime, NewCustomPickupArea, NewLocationPickupTime, NewPickupGroup, NewPickupLocation, NewProductMeetingConfig, PickupGroup, PickupLocation, ProductMeetingConfig, } from "./schema.js";
+export { availabilityCloseouts, availabilityPickupPoints, availabilityRules, availabilitySlotPickups, availabilitySlots, availabilityStartTimes, customPickupAreas, locationPickupTimes, pickupGroups, pickupLocations, productMeetingConfigs, } from "./schema.js";
+export { availabilityCloseoutListQuerySchema, availabilityPickupPointListQuerySchema, availabilityRuleListQuerySchema, availabilitySlotListQuerySchema, availabilitySlotPickupListQuerySchema, availabilityStartTimeListQuerySchema, customPickupAreaListQuerySchema, insertAvailabilityCloseoutSchema, insertAvailabilityPickupPointSchema, insertAvailabilityRuleSchema, insertAvailabilitySlotPickupSchema, insertAvailabilitySlotSchema, insertAvailabilityStartTimeSchema, insertCustomPickupAreaSchema, insertLocationPickupTimeSchema, insertPickupGroupSchema, insertPickupLocationSchema, insertProductMeetingConfigSchema, locationPickupTimeListQuerySchema, pickupGroupListQuerySchema, pickupLocationListQuerySchema, productMeetingConfigListQuerySchema, updateAvailabilityCloseoutSchema, updateAvailabilityPickupPointSchema, updateAvailabilityRuleSchema, updateAvailabilitySlotPickupSchema, updateAvailabilitySlotSchema, updateAvailabilityStartTimeSchema, updateCustomPickupAreaSchema, updateLocationPickupTimeSchema, updatePickupGroupSchema, updatePickupLocationSchema, updateProductMeetingConfigSchema, } from "./validation.js";
+export { availabilityService };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAGvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAElD,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD,eAAO,MAAM,kBAAkB,EAAE,MAEhC,CAAA;AAED,eAAO,MAAM,sBAAsB,EAAE,UAGpC,CAAA;AAED,OAAO,EACL,KAAK,gCAAgC,EACrC,KAAK,+BAA+B,EACpC,yBAAyB,GAC1B,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,WAAW,EACX,cAAc,EACd,oBAAoB,GACrB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,qBAAqB,GACtB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,mCAAmC,EACnC,sCAAsC,EACtC,+BAA+B,EAC/B,+BAA+B,EAC/B,qCAAqC,EACrC,oCAAoC,EACpC,+BAA+B,EAC/B,gCAAgC,EAChC,mCAAmC,EACnC,4BAA4B,EAC5B,kCAAkC,EAClC,4BAA4B,EAC5B,iCAAiC,EACjC,4BAA4B,EAC5B,8BAA8B,EAC9B,uBAAuB,EACvB,0BAA0B,EAC1B,gCAAgC,EAChC,iCAAiC,EACjC,0BAA0B,EAC1B,6BAA6B,EAC7B,mCAAmC,EACnC,gCAAgC,EAChC,mCAAmC,EACnC,4BAA4B,EAC5B,kCAAkC,EAClC,4BAA4B,EAC5B,iCAAiC,EACjC,4BAA4B,EAC5B,8BAA8B,EAC9B,uBAAuB,EACvB,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,mBAAmB,EAAE,CAAA"}

package/dist/index.js

@@ -0,0 +1,13 @@
+import { availabilityRoutes } from "./routes.js";
+import { availabilityService } from "./service.js";
+export const availabilityModule = {
+    name: "availability",
+};
+export const availabilityHonoModule = {
+    module: availabilityModule,
+    routes: availabilityRoutes,
+};
+export { generateAvailabilitySlots, } from "./generate-slots.js";
+export { availabilityCloseouts, availabilityPickupPoints, availabilityRules, availabilitySlotPickups, availabilitySlots, availabilityStartTimes, customPickupAreas, locationPickupTimes, pickupGroups, pickupLocations, productMeetingConfigs, } from "./schema.js";
+export { availabilityCloseoutListQuerySchema, availabilityPickupPointListQuerySchema, availabilityRuleListQuerySchema, availabilitySlotListQuerySchema, availabilitySlotPickupListQuerySchema, availabilityStartTimeListQuerySchema, customPickupAreaListQuerySchema, insertAvailabilityCloseoutSchema, insertAvailabilityPickupPointSchema, insertAvailabilityRuleSchema, insertAvailabilitySlotPickupSchema, insertAvailabilitySlotSchema, insertAvailabilityStartTimeSchema, insertCustomPickupAreaSchema, insertLocationPickupTimeSchema, insertPickupGroupSchema, insertPickupLocationSchema, insertProductMeetingConfigSchema, locationPickupTimeListQuerySchema, pickupGroupListQuerySchema, pickupLocationListQuerySchema, productMeetingConfigListQuerySchema, updateAvailabilityCloseoutSchema, updateAvailabilityPickupPointSchema, updateAvailabilityRuleSchema, updateAvailabilitySlotPickupSchema, updateAvailabilitySlotSchema, updateAvailabilityStartTimeSchema, updateCustomPickupAreaSchema, updateLocationPickupTimeSchema, updatePickupGroupSchema, updatePickupLocationSchema, updateProductMeetingConfigSchema, } from "./validation.js";
+export { availabilityService };