@foxscheduling/shared 0.1.0 → 0.2.2

package/README.md

@@ -1,56 +1,74 @@
 # @foxscheduling/shared
 
-Shared utilities and interfaces for FoxScheduling backend and frontend.
+Shared TypeScript types and utilities for the [Fox Scheduling](https://foxscheduling.com) platform.
 
-## Installation
+This package is the companion to [`@foxscheduling/sdk`](https://www.npmjs.com/package/@foxscheduling/sdk). It contains the data types (DTOs, enums, webhook payloads) and helper functions used across Fox Scheduling, so you can share strong typing between your code and the API.
 
-With npm workspaces (already configured in the root `package.json`):
+> If you just want to call the Partner API, install `@foxscheduling/sdk` — it re-exports the types you need from this package.
 
-```bash
-# From project root
-npm install
-```
-
-Then add the dependency to your backend or frontend:
+## Installation
 
 ```bash
-# In backend or frontend directory
 npm install @foxscheduling/shared
 ```
 
-Or add to `package.json`:
+```bash
+pnpm add @foxscheduling/shared
+```
 
-```json
-{
-  "dependencies": {
-    "@foxscheduling/shared": "file:../shared-library"
-  }
-}
+```bash
+yarn add @foxscheduling/shared
 ```
 
-(Use `workspace:*` if using pnpm or yarn workspaces.)
+Requires Node.js 18+. Ships with both ESM and CommonJS builds and bundled type declarations.
 
 ## Usage
 
 ```ts
-// Import everything
-import { formatCurrency, type CDKConfig, type DeploymentEnvironments } from "@foxscheduling/shared";
+import {
+  type BusinessProfileDto,
+  type PartnerBookingDto,
+  type PartnerEmbedOptions,
+  type PartnerWebhookEvent,
+  isValidYearMonth,
+  partnerPaginate,
+} from "@foxscheduling/shared";
+
+// Validate a booking month before querying
+if (!isValidYearMonth("2026-06")) {
+  throw new Error("month must be YYYY-MM");
+}
+```
+
+CommonJS works too:
 
-// Or import subpaths
-import { formatCurrency } from "@foxscheduling/shared/utils";
-import type { CDKConfig } from "@foxscheduling/shared/types";
+```js
+const { isValidYearMonth } = require("@foxscheduling/shared");
 ```
 
-## Development
+### Subpath imports
 
-```bash
-cd src/v1/shared-library
-npm run build    # Build once
-npm run dev      # Watch mode
+For smaller imports you can target a subpath directly:
+
+```ts
+import { isValidYearMonth } from "@foxscheduling/shared/types";
+import { buildBookingEmbedUrl } from "@foxscheduling/shared/utils/bookingEmbed";
 ```
 
-## Structure
+| Entry point                            | Contents                                  |
+| -------------------------------------- | ----------------------------------------- |
+| `@foxscheduling/shared`                | Everything (types + utils)                |
+| `@foxscheduling/shared/types`          | Type and interface definitions            |
+| `@foxscheduling/shared/utils`          | Utility functions                         |
+| `@foxscheduling/shared/utils/bookingEmbed` | Booking embed URL and snippet builders |
+
+## What's inside
+
+- **Partner API types** — `BusinessProfileDto`, `PartnerBookingDto`, `PartnerServiceDto`, `PartnerCustomerDto`, `PartnerStaffDto`, `PartnerPage<T>`, and more.
+- **Webhooks** — `PartnerWebhookEvent` and the `PARTNER_WEBHOOK_EVENTS` list.
+- **Embedding** — `PartnerEmbedOptions` plus `buildBookingEmbedUrl`, `buildInlineIframeEmbedCode`, and `buildWidgetScriptSnippet` for rendering booking widgets.
+- **Helpers** — pagination (`partnerPaginate`, `resolvePartnerPageParams`), validation (`isValidYearMonth`), formatting utilities, and shared enums.
+
+## License
 
-- `src/types/` - Shared interfaces and type definitions
-- `src/utils/` - Shared utility functions
-- `src/index.ts` - Main entry point (re-exports all)
+Proprietary © Fox Scheduling.

package/dist/cjs/types/db.webhook.cjs

@@ -7,4 +7,5 @@ exports.PARTNER_WEBHOOK_EVENTS = [
     "booking.cancelled",
     "customer.created",
     "customer.updated",
+    "business.booking_url.updated",
 ];

package/dist/cjs/types/db.webhook.d.ts

@@ -1,5 +1,5 @@
 import { DBRecord } from "./db.js";
-export declare const PARTNER_WEBHOOK_EVENTS: readonly ["booking.created", "booking.updated", "booking.cancelled", "customer.created", "customer.updated"];
+export declare const PARTNER_WEBHOOK_EVENTS: readonly ["booking.created", "booking.updated", "booking.cancelled", "customer.created", "customer.updated", "business.booking_url.updated"];
 export type PartnerWebhookEvent = (typeof PARTNER_WEBHOOK_EVENTS)[number];
 export interface WebhookSubscription extends DBRecord {
     recordType: "WEBHOOK_SUBSCRIPTION";

package/dist/cjs/types/db.webhook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db.webhook.d.ts","sourceRoot":"","sources":["../../../src/types/db.webhook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,eAAO,MAAM,sBAAsB,8GAMzB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,MAAM,WAAW,mBAAoB,SAAQ,QAAQ;IACnD,UAAU,EAAE,sBAAsB,CAAC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"db.webhook.d.ts","sourceRoot":"","sources":["../../../src/types/db.webhook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,eAAO,MAAM,sBAAsB,8IAOzB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,MAAM,WAAW,mBAAoB,SAAQ,QAAQ;IACnD,UAAU,EAAE,sBAAsB,CAAC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/cjs/types/partnerDto.cjs

@@ -1,2 +1,38 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.PARTNER_DEFAULT_PAGE_SIZE = exports.PARTNER_MAX_PAGE_SIZE = void 0;
+exports.resolvePartnerPageParams = resolvePartnerPageParams;
+exports.partnerPaginate = partnerPaginate;
+exports.isValidYearMonth = isValidYearMonth;
+/** Maximum number of items the Partner API returns in a single list page. */
+exports.PARTNER_MAX_PAGE_SIZE = 100;
+/** Default page size when no limit is supplied. */
+exports.PARTNER_DEFAULT_PAGE_SIZE = 100;
+function toBoundedInt(value, fallback, min, max) {
+    const parsed = typeof value === "string" ? Number.parseInt(value, 10) : value ?? fallback;
+    const n = Number.isFinite(parsed) ? Math.floor(parsed) : fallback;
+    return Math.min(Math.max(min, n), max);
+}
+/** Clamp raw pagination params to valid bounds (limit 1–100, offset >= 0). */
+function resolvePartnerPageParams(input) {
+    const limit = toBoundedInt(input?.limit, exports.PARTNER_DEFAULT_PAGE_SIZE, 1, exports.PARTNER_MAX_PAGE_SIZE);
+    const offset = toBoundedInt(input?.offset, 0, 0, Number.MAX_SAFE_INTEGER);
+    return { limit, offset };
+}
+/** Slice a full array into a typed {@link PartnerPage}, enforcing the max page size. */
+function partnerPaginate(items, input) {
+    const { limit, offset } = resolvePartnerPageParams(input);
+    const slice = items.slice(offset, offset + limit);
+    return {
+        items: slice,
+        total: items.length,
+        limit,
+        offset,
+        hasMore: offset + slice.length < items.length,
+    };
+}
+const YEAR_MONTH_PATTERN = /^\d{4}-(0[1-9]|1[0-2])$/;
+/** True when `value` matches the `YYYY-MM` format (e.g. "2026-06"). */
+function isValidYearMonth(value) {
+    return typeof value === "string" && YEAR_MONTH_PATTERN.test(value);
+}

package/dist/cjs/types/partnerDto.d.ts

@@ -66,4 +66,106 @@ export interface CreatePartnerApiKeyResponseDto {
     key: PartnerApiKeyPublicDto;
     api_key: string;
 }
+/** Maximum number of items the Partner API returns in a single list page. */
+export declare const PARTNER_MAX_PAGE_SIZE = 100;
+/** Default page size when no limit is supplied. */
+export declare const PARTNER_DEFAULT_PAGE_SIZE = 100;
+/** A single page of Partner API list results. */
+export interface PartnerPage<T> {
+    /** Items in this page (never more than {@link PARTNER_MAX_PAGE_SIZE}). */
+    items: T[];
+    /** Total number of items available across all pages. */
+    total: number;
+    /** Effective page size used for this response. */
+    limit: number;
+    /** Offset used for this response. */
+    offset: number;
+    /** True when more items exist beyond this page. */
+    hasMore: boolean;
+}
+/** Raw pagination inputs (query strings or numbers). */
+export interface PartnerPaginationInput {
+    limit?: number | string;
+    offset?: number | string;
+}
+/** Clamp raw pagination params to valid bounds (limit 1–100, offset >= 0). */
+export declare function resolvePartnerPageParams(input?: PartnerPaginationInput): {
+    limit: number;
+    offset: number;
+};
+/** Slice a full array into a typed {@link PartnerPage}, enforcing the max page size. */
+export declare function partnerPaginate<T>(items: T[], input?: PartnerPaginationInput): PartnerPage<T>;
+/** True when `value` matches the `YYYY-MM` format (e.g. "2026-06"). */
+export declare function isValidYearMonth(value: string | undefined | null): boolean;
+/** Color theme for an embedded booking page. */
+export type PartnerEmbedTheme = "light" | "dark" | "auto";
+/** How the popup widget opens the booking page. */
+export type PartnerEmbedOpenMode = "popup" | "newTab";
+/**
+ * Whether the popup widget renders its own button (`create`) or attaches to an
+ * existing element already on the host page (`existing`).
+ */
+export type PartnerEmbedButtonMode = "create" | "existing";
+/** Options for {@link PartnerEmbedCodeDto} generation. */
+export interface PartnerEmbedOptions {
+    /** Book a specific service path/slug instead of the business landing page. */
+    servicePath?: string;
+    /** Color theme. Defaults to "auto". */
+    theme?: PartnerEmbedTheme;
+    /** Hide the business header/details inside the embed. Defaults to false. */
+    hidePageDetails?: boolean;
+    /** Show the light/dark toggle. Defaults to true. */
+    showThemeToggle?: boolean;
+    /** Inline iframe height in px. Defaults to 760. */
+    heightPx?: number;
+    /** Inline iframe border-radius key (none|sm|medium|lg|xl|2xl). Defaults to "medium". */
+    iframeBorderRadius?: string;
+    /** Popup vs new tab for the script widget. Defaults to "popup". */
+    openMode?: PartnerEmbedOpenMode;
+    /**
+     * Render a generated button (`create`, default) or wire the widget to an
+     * element already on your site (`existing`). When `existing`, set
+     * {@link triggerId} and the button styling fields are ignored.
+     */
+    buttonMode?: PartnerEmbedButtonMode;
+    /**
+     * HTML id (without the leading `#`) of an existing element on the host page
+     * that should open the booking popup. Required when `buttonMode` is
+     * `existing`, e.g. `book-appointment` for `<button id="book-appointment">`.
+     */
+    triggerId?: string;
+    /** Popup button text. Defaults to "Book now". */
+    buttonText?: string;
+    /** Popup button background color (hex). */
+    buttonBackgroundColor?: string;
+    /** Popup button text color (hex). */
+    buttonTextColor?: string;
+    /** Popup button border radius in px. */
+    buttonBorderRadiusPx?: number;
+}
+/** Resolved embed options actually applied (after defaults). */
+export interface PartnerEmbedAppliedOptions {
+    servicePath?: string;
+    theme: PartnerEmbedTheme;
+    hidePageDetails: boolean;
+    showThemeToggle: boolean;
+    heightPx: number;
+    iframeBorderRadius: string;
+    openMode: PartnerEmbedOpenMode;
+    /** Whether a button was generated or an existing element is used. */
+    buttonMode: PartnerEmbedButtonMode;
+    /** The existing element id wired to the popup, when `buttonMode` is `existing`. */
+    triggerId?: string;
+}
+/** Booking embed code for a business (iframe + popup script + raw URL). */
+export interface PartnerEmbedCodeDto {
+    /** Fully-qualified booking URL with the chosen options applied. */
+    bookingUrl: string;
+    /** Inline iframe HTML snippet. */
+    iframe: string;
+    /** Popup widget `<script>` snippet. */
+    popupScript: string;
+    /** The options actually applied after defaults. */
+    appliedOptions: PartnerEmbedAppliedOptions;
+}
 //# sourceMappingURL=partnerDto.d.ts.map

package/dist/cjs/types/partnerDto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"partnerDto.d.ts","sourceRoot":"","sources":["../../../src/types/partnerDto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AACnD,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC;AACxC,MAAM,MAAM,eAAe,GAAG,KAAK,CAAC;AACpC,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAE1C,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,kEAAkE;AAClE,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,uDAAuD;AACvD,MAAM,WAAW,8BAA8B;IAC7C,GAAG,EAAE,sBAAsB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"partnerDto.d.ts","sourceRoot":"","sources":["../../../src/types/partnerDto.ts"],"names":[],"mappings":"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"}

package/dist/types/db.webhook.d.ts

@@ -1,5 +1,5 @@
 import { DBRecord } from "./db.js";
-export declare const PARTNER_WEBHOOK_EVENTS: readonly ["booking.created", "booking.updated", "booking.cancelled", "customer.created", "customer.updated"];
+export declare const PARTNER_WEBHOOK_EVENTS: readonly ["booking.created", "booking.updated", "booking.cancelled", "customer.created", "customer.updated", "business.booking_url.updated"];
 export type PartnerWebhookEvent = (typeof PARTNER_WEBHOOK_EVENTS)[number];
 export interface WebhookSubscription extends DBRecord {
     recordType: "WEBHOOK_SUBSCRIPTION";

package/dist/types/db.webhook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db.webhook.d.ts","sourceRoot":"","sources":["../../src/types/db.webhook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,eAAO,MAAM,sBAAsB,8GAMzB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,MAAM,WAAW,mBAAoB,SAAQ,QAAQ;IACnD,UAAU,EAAE,sBAAsB,CAAC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"db.webhook.d.ts","sourceRoot":"","sources":["../../src/types/db.webhook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,eAAO,MAAM,sBAAsB,8IAOzB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,MAAM,WAAW,mBAAoB,SAAQ,QAAQ;IACnD,UAAU,EAAE,sBAAsB,CAAC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/types/db.webhook.js

@@ -4,4 +4,5 @@ export const PARTNER_WEBHOOK_EVENTS = [
     "booking.cancelled",
     "customer.created",
     "customer.updated",
+    "business.booking_url.updated",
 ];

package/dist/types/partnerDto.d.ts

@@ -66,4 +66,106 @@ export interface CreatePartnerApiKeyResponseDto {
     key: PartnerApiKeyPublicDto;
     api_key: string;
 }
+/** Maximum number of items the Partner API returns in a single list page. */
+export declare const PARTNER_MAX_PAGE_SIZE = 100;
+/** Default page size when no limit is supplied. */
+export declare const PARTNER_DEFAULT_PAGE_SIZE = 100;
+/** A single page of Partner API list results. */
+export interface PartnerPage<T> {
+    /** Items in this page (never more than {@link PARTNER_MAX_PAGE_SIZE}). */
+    items: T[];
+    /** Total number of items available across all pages. */
+    total: number;
+    /** Effective page size used for this response. */
+    limit: number;
+    /** Offset used for this response. */
+    offset: number;
+    /** True when more items exist beyond this page. */
+    hasMore: boolean;
+}
+/** Raw pagination inputs (query strings or numbers). */
+export interface PartnerPaginationInput {
+    limit?: number | string;
+    offset?: number | string;
+}
+/** Clamp raw pagination params to valid bounds (limit 1–100, offset >= 0). */
+export declare function resolvePartnerPageParams(input?: PartnerPaginationInput): {
+    limit: number;
+    offset: number;
+};
+/** Slice a full array into a typed {@link PartnerPage}, enforcing the max page size. */
+export declare function partnerPaginate<T>(items: T[], input?: PartnerPaginationInput): PartnerPage<T>;
+/** True when `value` matches the `YYYY-MM` format (e.g. "2026-06"). */
+export declare function isValidYearMonth(value: string | undefined | null): boolean;
+/** Color theme for an embedded booking page. */
+export type PartnerEmbedTheme = "light" | "dark" | "auto";
+/** How the popup widget opens the booking page. */
+export type PartnerEmbedOpenMode = "popup" | "newTab";
+/**
+ * Whether the popup widget renders its own button (`create`) or attaches to an
+ * existing element already on the host page (`existing`).
+ */
+export type PartnerEmbedButtonMode = "create" | "existing";
+/** Options for {@link PartnerEmbedCodeDto} generation. */
+export interface PartnerEmbedOptions {
+    /** Book a specific service path/slug instead of the business landing page. */
+    servicePath?: string;
+    /** Color theme. Defaults to "auto". */
+    theme?: PartnerEmbedTheme;
+    /** Hide the business header/details inside the embed. Defaults to false. */
+    hidePageDetails?: boolean;
+    /** Show the light/dark toggle. Defaults to true. */
+    showThemeToggle?: boolean;
+    /** Inline iframe height in px. Defaults to 760. */
+    heightPx?: number;
+    /** Inline iframe border-radius key (none|sm|medium|lg|xl|2xl). Defaults to "medium". */
+    iframeBorderRadius?: string;
+    /** Popup vs new tab for the script widget. Defaults to "popup". */
+    openMode?: PartnerEmbedOpenMode;
+    /**
+     * Render a generated button (`create`, default) or wire the widget to an
+     * element already on your site (`existing`). When `existing`, set
+     * {@link triggerId} and the button styling fields are ignored.
+     */
+    buttonMode?: PartnerEmbedButtonMode;
+    /**
+     * HTML id (without the leading `#`) of an existing element on the host page
+     * that should open the booking popup. Required when `buttonMode` is
+     * `existing`, e.g. `book-appointment` for `<button id="book-appointment">`.
+     */
+    triggerId?: string;
+    /** Popup button text. Defaults to "Book now". */
+    buttonText?: string;
+    /** Popup button background color (hex). */
+    buttonBackgroundColor?: string;
+    /** Popup button text color (hex). */
+    buttonTextColor?: string;
+    /** Popup button border radius in px. */
+    buttonBorderRadiusPx?: number;
+}
+/** Resolved embed options actually applied (after defaults). */
+export interface PartnerEmbedAppliedOptions {
+    servicePath?: string;
+    theme: PartnerEmbedTheme;
+    hidePageDetails: boolean;
+    showThemeToggle: boolean;
+    heightPx: number;
+    iframeBorderRadius: string;
+    openMode: PartnerEmbedOpenMode;
+    /** Whether a button was generated or an existing element is used. */
+    buttonMode: PartnerEmbedButtonMode;
+    /** The existing element id wired to the popup, when `buttonMode` is `existing`. */
+    triggerId?: string;
+}
+/** Booking embed code for a business (iframe + popup script + raw URL). */
+export interface PartnerEmbedCodeDto {
+    /** Fully-qualified booking URL with the chosen options applied. */
+    bookingUrl: string;
+    /** Inline iframe HTML snippet. */
+    iframe: string;
+    /** Popup widget `<script>` snippet. */
+    popupScript: string;
+    /** The options actually applied after defaults. */
+    appliedOptions: PartnerEmbedAppliedOptions;
+}
 //# sourceMappingURL=partnerDto.d.ts.map

package/dist/types/partnerDto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"partnerDto.d.ts","sourceRoot":"","sources":["../../src/types/partnerDto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AACnD,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC;AACxC,MAAM,MAAM,eAAe,GAAG,KAAK,CAAC;AACpC,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAE1C,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,kEAAkE;AAClE,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,uDAAuD;AACvD,MAAM,WAAW,8BAA8B;IAC7C,GAAG,EAAE,sBAAsB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"partnerDto.d.ts","sourceRoot":"","sources":["../../src/types/partnerDto.ts"],"names":[],"mappings":"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"}

package/dist/types/partnerDto.js

@@ -1 +1,32 @@
-export {};
+/** Maximum number of items the Partner API returns in a single list page. */
+export const PARTNER_MAX_PAGE_SIZE = 100;
+/** Default page size when no limit is supplied. */
+export const PARTNER_DEFAULT_PAGE_SIZE = 100;
+function toBoundedInt(value, fallback, min, max) {
+    const parsed = typeof value === "string" ? Number.parseInt(value, 10) : value ?? fallback;
+    const n = Number.isFinite(parsed) ? Math.floor(parsed) : fallback;
+    return Math.min(Math.max(min, n), max);
+}
+/** Clamp raw pagination params to valid bounds (limit 1–100, offset >= 0). */
+export function resolvePartnerPageParams(input) {
+    const limit = toBoundedInt(input?.limit, PARTNER_DEFAULT_PAGE_SIZE, 1, PARTNER_MAX_PAGE_SIZE);
+    const offset = toBoundedInt(input?.offset, 0, 0, Number.MAX_SAFE_INTEGER);
+    return { limit, offset };
+}
+/** Slice a full array into a typed {@link PartnerPage}, enforcing the max page size. */
+export function partnerPaginate(items, input) {
+    const { limit, offset } = resolvePartnerPageParams(input);
+    const slice = items.slice(offset, offset + limit);
+    return {
+        items: slice,
+        total: items.length,
+        limit,
+        offset,
+        hasMore: offset + slice.length < items.length,
+    };
+}
+const YEAR_MONTH_PATTERN = /^\d{4}-(0[1-9]|1[0-2])$/;
+/** True when `value` matches the `YYYY-MM` format (e.g. "2026-06"). */
+export function isValidYearMonth(value) {
+    return typeof value === "string" && YEAR_MONTH_PATTERN.test(value);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxscheduling/shared",
-  "version": "0.1.0",
+  "version": "0.2.2",
   "description": "Shared utilities and interfaces for FoxScheduling backend and frontend",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,7 +31,12 @@
       "default": "./dist/types/index.js"
     }
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "tsc && tsc -p tsconfig.cjs.json && node scripts/rename-cjs.mjs",
     "dev": "tsc --watch",
@@ -43,4 +48,4 @@
   "dependencies": {
     "dayjs": "^1.11.19"
   }
-}
+}