@foxscheduling/sdk 0.1.1 → 0.2.2

package/README.md

@@ -69,7 +69,116 @@ After creating a client, use:
 - `fox.customers` — customers
 - `fox.webhooks` — webhook subscriptions
 
-All methods return typed data and throw on API errors.
+All methods are fully typed (no `unknown` inputs or outputs) and throw a
+`FoxSchedulingError` on API errors.
+
+### Lists are paginated (max 100 per page)
+
+Pagination is enforced by the API — every `list()` method sends `limit`/`offset`
+to the server and returns a typed `Page<T>`, never a raw array:
+
+```typescript
+interface Page<T> {
+  items: T[]; // at most 100
+  total: number; // total across all pages
+  limit: number; // effective page size
+  offset: number; // current offset
+  hasMore: boolean; // true if more items exist
+}
+```
+
+Pass `limit` (1–100, default 100) and `offset` to page through results:
+
+```typescript
+const first = await fox.customers.list({ limit: 50, offset: 0 });
+console.log(first.items.length, first.total, first.hasMore);
+
+if (first.hasMore) {
+  const next = await fox.customers.list({ limit: 50, offset: 50 });
+}
+```
+
+`limit` is clamped to a maximum of 100.
+
+### Bookings require a month
+
+`fox.bookings.list()` **requires** a `month` (format `YYYY-MM`) so responses stay
+small. Other filters are optional and typed:
+
+```typescript
+const page = await fox.bookings.list({
+  month: "2026-06", // required
+  status: "booked", // optional, typed union
+  serviceId: "…", // optional
+  limit: 100, // optional
+});
+```
+
+Omitting or malformatting `month` throws a `FoxSchedulingError` before any
+request is sent.
+
+### Typed create & update
+
+Create and update bodies are typed — for example:
+
+```typescript
+// Create a customer
+const customer = await fox.customers.create({
+  name: "Jane Doe",
+  email: "jane@example.com",
+});
+
+// Create a booking
+const result = await fox.bookings.create({
+  serviceId: "…",
+  name: "Jane Doe",
+  email: "jane@example.com",
+  slots: [{ date: "2026-06-12", start: "09:00", end: "09:30" }],
+});
+console.log(result.bookingSummary, result.customerId);
+```
+
+### Get booking embed code
+
+`fox.business.getEmbedCode()` returns ready-to-paste embed snippets for the
+connected business: an inline `iframe`, a popup `<script>` widget, and the raw
+`bookingUrl`. All options are optional and typed:
+
+```typescript
+const embed = await fox.business.getEmbedCode({
+  theme: "dark", // "light" | "dark" | "auto" (default)
+  servicePath: "haircut", // optional: link straight to one service
+  hidePageDetails: false, // hide business header inside the embed
+  heightPx: 760, // inline iframe height
+  iframeBorderRadius: "medium", // none | sm | medium | lg | xl | 2xl
+  openMode: "popup", // "popup" | "newTab" for the script widget
+  buttonText: "Book now", // popup button label
+});
+
+console.log(embed.bookingUrl); // shareable URL
+console.log(embed.iframe); // <style>…</style><div>…<iframe …></div>
+console.log(embed.popupScript); // <script … data-booking-url="…"></script>
+console.log(embed.appliedOptions); // options after defaults applied
+```
+
+By default the popup widget renders its own button. To open the popup from a
+button that already exists on your page, set `buttonMode: "existing"` and pass
+the element's `id` (without `#`) as `triggerId`:
+
+```typescript
+// For an element like <button id="book-appointment">Book</button>
+const embed = await fox.business.getEmbedCode({
+  buttonMode: "existing",
+  triggerId: "book-appointment",
+});
+
+// embed.popupScript now wires the popup to your element instead of injecting a button.
+// embed.appliedOptions.buttonMode === "existing"
+// embed.appliedOptions.triggerId === "book-appointment"
+```
+
+An invalid or missing `triggerId` while `buttonMode` is `"existing"` is rejected
+by the API.
 
 ---
 
@@ -165,7 +274,7 @@ Once `exchangeCode` succeeds, the SDK stores tokens and attaches them to every r
 
 ```typescript
 const business = await fox.business.get();
-const bookings = await fox.bookings.list();
+const bookings = await fox.bookings.list({ month: "2026-06" });
 ```
 
 The SDK refreshes access tokens automatically before they expire.

package/dist/cjs/index.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_BASE_URL = exports.verifyFoxWebhookSignature = exports.generateState = exports.generateCodeChallengeS256 = exports.generateCodeVerifier = exports.FileTokenStore = exports.MemoryTokenStore = exports.isFoxSchedulingError = exports.FoxSchedulingError = exports.FoxScheduling = void 0;
+exports.isValidMonth = exports.MAX_PAGE_SIZE = exports.DEFAULT_BASE_URL = exports.verifyFoxWebhookSignature = exports.generateState = exports.generateCodeChallengeS256 = exports.generateCodeVerifier = exports.FileTokenStore = exports.MemoryTokenStore = exports.isFoxSchedulingError = exports.FoxSchedulingError = exports.FoxScheduling = void 0;
 var client_js_1 = require("./client.cjs");
 Object.defineProperty(exports, "FoxScheduling", { enumerable: true, get: function () { return client_js_1.FoxScheduling; } });
 var errors_js_1 = require("./errors.cjs");
@@ -17,3 +17,5 @@ var verify_js_1 = require("./webhooks/verify.cjs");
 Object.defineProperty(exports, "verifyFoxWebhookSignature", { enumerable: true, get: function () { return verify_js_1.verifyFoxWebhookSignature; } });
 var types_js_1 = require("./types.cjs");
 Object.defineProperty(exports, "DEFAULT_BASE_URL", { enumerable: true, get: function () { return types_js_1.DEFAULT_BASE_URL; } });
+Object.defineProperty(exports, "MAX_PAGE_SIZE", { enumerable: true, get: function () { return types_js_1.MAX_PAGE_SIZE; } });
+Object.defineProperty(exports, "isValidMonth", { enumerable: true, get: function () { return types_js_1.isValidMonth; } });

package/dist/cjs/index.d.ts

@@ -3,5 +3,6 @@ export { FoxSchedulingError, isFoxSchedulingError } from "./errors.js";
 export { MemoryTokenStore, FileTokenStore, type TokenStore, } from "./auth/tokenStore.js";
 export { generateCodeVerifier, generateCodeChallengeS256, generateState, } from "./auth/pkce.js";
 export { verifyFoxWebhookSignature } from "./webhooks/verify.js";
-export { DEFAULT_BASE_URL, type FoxSchedulingConfig, type FoxSchedulingAuth, type FoxSchedulingApiKeyAuth, type FoxSchedulingOAuthAuth, type TokenSet, type AuthorizationUrlResult, } from "./types.js";
+export type { WebhookSubscriptionPublic, CreateWebhookResult, } from "./resources/index.js";
+export { DEFAULT_BASE_URL, MAX_PAGE_SIZE, isValidMonth, type FoxSchedulingConfig, type FoxSchedulingAuth, type FoxSchedulingApiKeyAuth, type FoxSchedulingOAuthAuth, type TokenSet, type AuthorizationUrlResult, type ListQuery, type Page, type BookingStatus, type BookingListQuery, type CreateAvailabilityInput, type UpdateAvailabilityInput, type BookingSlotInput, type CreateBookingInput, type BookingCreatedResult, type CreateCustomerInput, type UpdateCustomerInput, type CreateWebhookInput, type UpdateWebhookInput, type PartnerEmbedOptions, type PartnerEmbedCodeDto, type PartnerEmbedTheme, type PartnerEmbedOpenMode, type PartnerEmbedButtonMode, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,KAAK,UAAU,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,QAAQ,EACb,KAAK,sBAAsB,GAC5B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,KAAK,UAAU,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,YAAY,EACV,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,QAAQ,EACb,KAAK,sBAAsB,EAC3B,KAAK,SAAS,EACd,KAAK,IAAI,EACT,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,YAAY,CAAC"}

package/dist/cjs/resources/index.cjs

@@ -1,6 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebhooksResource = exports.CustomersResource = exports.BookingsResource = exports.AvailabilityResource = exports.StaffResource = exports.ServicesResource = exports.BusinessResource = void 0;
+const types_js_1 = require("../types.js");
+const errors_js_1 = require("../errors.js");
+/** Convert pagination options to string query params. */
+function pageQuery(query) {
+    return {
+        limit: query?.limit != null ? String(query.limit) : undefined,
+        offset: query?.offset != null ? String(query.offset) : undefined,
+    };
+}
 class BusinessResource {
     http;
     constructor(http) {
@@ -9,6 +18,29 @@ class BusinessResource {
     get() {
         return this.http.get("/partner/business");
     }
+    /**
+     * Get booking embed code (inline iframe + popup script + raw URL) for this
+     * business, with optional theming and button styling.
+     */
+    getEmbedCode(options = {}) {
+        return this.http.get("/partner/business/embed", {
+            servicePath: options.servicePath,
+            theme: options.theme,
+            hidePageDetails: options.hidePageDetails != null ? String(options.hidePageDetails) : undefined,
+            showThemeToggle: options.showThemeToggle != null ? String(options.showThemeToggle) : undefined,
+            heightPx: options.heightPx != null ? String(options.heightPx) : undefined,
+            iframeBorderRadius: options.iframeBorderRadius,
+            openMode: options.openMode,
+            buttonMode: options.buttonMode,
+            triggerId: options.triggerId,
+            buttonText: options.buttonText,
+            buttonBackgroundColor: options.buttonBackgroundColor,
+            buttonTextColor: options.buttonTextColor,
+            buttonBorderRadiusPx: options.buttonBorderRadiusPx != null
+                ? String(options.buttonBorderRadiusPx)
+                : undefined,
+        });
+    }
 }
 exports.BusinessResource = BusinessResource;
 class ServicesResource {
@@ -16,8 +48,8 @@ class ServicesResource {
     constructor(http) {
         this.http = http;
     }
-    list() {
-        return this.http.get("/partner/services");
+    list(query) {
+        return this.http.get("/partner/services", pageQuery(query));
     }
     get(id) {
         return this.http.get(`/partner/services/${id}`);
@@ -29,8 +61,8 @@ class StaffResource {
     constructor(http) {
         this.http = http;
     }
-    list() {
-        return this.http.get("/partner/staff");
+    list(query) {
+        return this.http.get("/partner/staff", pageQuery(query));
     }
     get(id) {
         return this.http.get(`/partner/staff/${id}`);
@@ -42,8 +74,8 @@ class AvailabilityResource {
     constructor(http) {
         this.http = http;
     }
-    list() {
-        return this.http.get("/partner/availability");
+    list(query) {
+        return this.http.get("/partner/availability", pageQuery(query));
     }
     get(id) {
         return this.http.get(`/partner/availability/${id}`);
@@ -64,19 +96,38 @@ class BookingsResource {
     constructor(http) {
         this.http = http;
     }
-    list(query) {
-        return this.http.get("/partner/bookings", query);
+    /**
+     * List bookings for a single month.
+     *
+     * `query.month` is required (format `YYYY-MM`, e.g. "2026-06") to keep the
+     * response small.
+     */
+    async list(query) {
+        if (!query || !query.month) {
+            throw new errors_js_1.FoxSchedulingError("MONTH_REQUIRED", 'bookings.list requires a "month" in YYYY-MM format, e.g. "2026-06".');
+        }
+        if (!(0, types_js_1.isValidMonth)(query.month)) {
+            throw new errors_js_1.FoxSchedulingError("INVALID_MONTH", `Invalid month "${query.month}". Expected YYYY-MM, e.g. "2026-06".`);
+        }
+        return this.http.get("/partner/bookings", {
+            yearMonth: query.month,
+            serviceId: query.serviceId,
+            providerId: query.providerId,
+            status: query.status,
+            search: query.search,
+            ...pageQuery(query),
+        });
     }
     get(id, serviceId) {
-        return this.http.get(`/partner/bookings/${id}`, { serviceId });
+        return this.http.get(`/partner/bookings/${id}`, {
+            serviceId,
+        });
     }
     create(body) {
         return this.http.post("/partner/bookings", body);
     }
     cancel(id, serviceId) {
-        return this.http.post(`/partner/bookings/${id}/cancel`, undefined, {
-            serviceId,
-        });
+        return this.http.post(`/partner/bookings/${id}/cancel`, undefined, { serviceId });
     }
 }
 exports.BookingsResource = BookingsResource;
@@ -85,8 +136,8 @@ class CustomersResource {
     constructor(http) {
         this.http = http;
     }
-    list() {
-        return this.http.get("/partner/customers");
+    list(query) {
+        return this.http.get("/partner/customers", pageQuery(query));
     }
     get(id) {
         return this.http.get(`/partner/customers/${id}`);
@@ -104,8 +155,8 @@ class WebhooksResource {
     constructor(http) {
         this.http = http;
     }
-    list() {
-        return this.http.get("/partner/webhooks");
+    list(query) {
+        return this.http.get("/partner/webhooks", pageQuery(query));
     }
     create(body) {
         return this.http.post("/partner/webhooks", body);

package/dist/cjs/resources/index.d.ts

@@ -1,49 +1,58 @@
-import type { BusinessProfileDto, PartnerBookingDto, PartnerCustomerDto, PartnerServiceDto, PartnerStaffDto, PartnerWebhookEvent } from "@foxscheduling/shared";
+import type { Availability, BusinessProfileDto, PartnerBookingDto, PartnerCustomerDto, PartnerEmbedCodeDto, PartnerEmbedOptions, PartnerServiceDto, PartnerStaffDto, PartnerWebhookEvent } from "@foxscheduling/shared";
 import type { HttpClient } from "../http/client.js";
+import { type BookingCreatedResult, type BookingListQuery, type CreateAvailabilityInput, type CreateBookingInput, type CreateCustomerInput, type CreateWebhookInput, type ListQuery, type Page, type UpdateAvailabilityInput, type UpdateCustomerInput, type UpdateWebhookInput } from "../types.js";
 export declare class BusinessResource {
     private readonly http;
     constructor(http: HttpClient);
     get(): Promise<BusinessProfileDto>;
+    /**
+     * Get booking embed code (inline iframe + popup script + raw URL) for this
+     * business, with optional theming and button styling.
+     */
+    getEmbedCode(options?: PartnerEmbedOptions): Promise<PartnerEmbedCodeDto>;
 }
 export declare class ServicesResource {
     private readonly http;
     constructor(http: HttpClient);
-    list(): Promise<PartnerServiceDto[]>;
+    list(query?: ListQuery): Promise<Page<PartnerServiceDto>>;
     get(id: string): Promise<PartnerServiceDto>;
 }
 export declare class StaffResource {
     private readonly http;
     constructor(http: HttpClient);
-    list(): Promise<PartnerStaffDto[]>;
+    list(query?: ListQuery): Promise<Page<PartnerStaffDto>>;
     get(id: string): Promise<PartnerStaffDto>;
 }
 export declare class AvailabilityResource {
     private readonly http;
     constructor(http: HttpClient);
-    list(): Promise<unknown[]>;
-    get(id: string): Promise<unknown>;
-    create(body: unknown): Promise<unknown>;
-    update(id: string, body: unknown): Promise<unknown>;
-    delete(id: string): Promise<unknown>;
+    list(query?: ListQuery): Promise<Page<Availability>>;
+    get(id: string): Promise<Availability>;
+    create(body: CreateAvailabilityInput): Promise<Availability>;
+    update(id: string, body: UpdateAvailabilityInput): Promise<Availability>;
+    delete(id: string): Promise<boolean>;
 }
 export declare class BookingsResource {
     private readonly http;
     constructor(http: HttpClient);
-    list(query?: Record<string, string>): Promise<PartnerBookingDto[]>;
+    /**
+     * List bookings for a single month.
+     *
+     * `query.month` is required (format `YYYY-MM`, e.g. "2026-06") to keep the
+     * response small.
+     */
+    list(query: BookingListQuery): Promise<Page<PartnerBookingDto>>;
     get(id: string, serviceId: string): Promise<PartnerBookingDto>;
-    create(body: unknown): Promise<unknown>;
-    cancel(id: string, serviceId: string): Promise<unknown>;
+    create(body: CreateBookingInput): Promise<BookingCreatedResult>;
+    cancel(id: string, serviceId: string): Promise<PartnerBookingDto>;
 }
 export declare class CustomersResource {
     private readonly http;
     constructor(http: HttpClient);
-    list(): Promise<PartnerCustomerDto[]>;
+    list(query?: ListQuery): Promise<Page<PartnerCustomerDto>>;
     get(id: string): Promise<PartnerCustomerDto>;
-    create(body: {
-        name: string;
-        email: string;
-    }): Promise<PartnerCustomerDto>;
-    update(id: string, body: unknown): Promise<PartnerCustomerDto>;
+    create(body: CreateCustomerInput): Promise<PartnerCustomerDto>;
+    update(id: string, body: UpdateCustomerInput): Promise<PartnerCustomerDto>;
 }
 export interface WebhookSubscriptionPublic {
     id: string;
@@ -51,21 +60,16 @@ export interface WebhookSubscriptionPublic {
     events: PartnerWebhookEvent[];
     creationDate?: string;
 }
+export interface CreateWebhookResult {
+    subscription: WebhookSubscriptionPublic;
+    secret: string;
+}
 export declare class WebhooksResource {
     private readonly http;
     constructor(http: HttpClient);
-    list(): Promise<WebhookSubscriptionPublic[]>;
-    create(body: {
-        url: string;
-        events: PartnerWebhookEvent[];
-    }): Promise<{
-        subscription: WebhookSubscriptionPublic;
-        secret: string;
-    }>;
-    update(id: string, body: Partial<{
-        url: string;
-        events: PartnerWebhookEvent[];
-    }>): Promise<WebhookSubscriptionPublic>;
-    delete(id: string): Promise<unknown>;
+    list(query?: ListQuery): Promise<Page<WebhookSubscriptionPublic>>;
+    create(body: CreateWebhookInput): Promise<CreateWebhookResult>;
+    update(id: string, body: UpdateWebhookInput): Promise<WebhookSubscriptionPublic>;
+    delete(id: string): Promise<boolean>;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/resources/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resources/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,IAAI,EACT,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAWrB,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,GAAG,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAIlC;;;OAGG;IACH,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAsB9E;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,IAAI,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAOzD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAG5C;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,IAAI,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAIvD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;CAG1C;AAED,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,IAAI,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAOpD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAItC,MAAM,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;IAI5D,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;IAIxE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGrC;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;OAKG;IACG,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAuBrE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAM9D,MAAM,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAI/D,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAOlE;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,IAAI,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAO1D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI5C,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI9D,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAG3E;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,yBAAyB,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,IAAI,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAOjE,MAAM,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI9D,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,yBAAyB,CAAC;IAOrC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGrC"}

package/dist/cjs/types.cjs

@@ -1,4 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_BASE_URL = void 0;
+exports.MAX_PAGE_SIZE = exports.DEFAULT_BASE_URL = void 0;
+exports.isValidMonth = isValidMonth;
+const shared_1 = require("@foxscheduling/shared");
 exports.DEFAULT_BASE_URL = "https://foxscheduling.com/api/v1";
+/** Maximum number of items returned in a single page (enforced by the API). */
+exports.MAX_PAGE_SIZE = shared_1.PARTNER_MAX_PAGE_SIZE;
+/** True when `value` matches the `YYYY-MM` format (e.g. "2026-06"). */
+function isValidMonth(value) {
+    return (0, shared_1.isValidYearMonth)(value);
+}

package/dist/cjs/types.d.ts

@@ -1,4 +1,100 @@
+import type { Availability, Booking, BookingSummary, PartnerPage, PartnerWebhookEvent } from "@foxscheduling/shared";
 export declare const DEFAULT_BASE_URL = "https://foxscheduling.com/api/v1";
+/** Maximum number of items returned in a single page (enforced by the API). */
+export declare const MAX_PAGE_SIZE = 100;
+/** Pagination options accepted by every list endpoint. */
+export interface ListQuery {
+    /** Items per page (1–{@link MAX_PAGE_SIZE}). The API clamps higher values. */
+    limit?: number;
+    /** Number of items to skip from the start. Defaults to 0. */
+    offset?: number;
+}
+/**
+ * A single page of results, returned by every `list()` method.
+ *
+ * Re-exported from `@foxscheduling/shared` as `PartnerPage<T>`.
+ */
+export type Page<T> = PartnerPage<T>;
+/** Re-export the embed options/result types for SDK consumers. */
+export type { PartnerEmbedOptions, PartnerEmbedCodeDto, PartnerEmbedTheme, PartnerEmbedOpenMode, PartnerEmbedButtonMode, } from "@foxscheduling/shared";
+/** Booking status values returned by the Partner API. */
+export type BookingStatus = Booking["status"];
+/**
+ * Query for {@link BookingsResource.list}.
+ *
+ * `month` is required to keep responses small — the API would otherwise return
+ * every booking for the business.
+ */
+export interface BookingListQuery extends ListQuery {
+    /** Required calendar month to fetch, format `YYYY-MM` (e.g. "2026-06"). */
+    month: string;
+    /** Restrict to a single service (UUID v4). */
+    serviceId?: string;
+    /** Restrict to a single staff/provider (UUID). */
+    providerId?: string;
+    /** Restrict to a booking status. */
+    status?: BookingStatus;
+    /** Case-insensitive search over customer name, email, or slug. */
+    search?: string;
+}
+/** Body for {@link AvailabilityResource.create}. */
+export type CreateAvailabilityInput = Omit<Availability, "id" | "ttl" | "sortKey" | "updatedOn" | "creationDate" | "schemaVersion" | "recordType" | "tenantId">;
+/** Body for {@link AvailabilityResource.update}. */
+export type UpdateAvailabilityInput = Partial<CreateAvailabilityInput>;
+/** A slot to book within {@link CreateBookingInput}. */
+export interface BookingSlotInput {
+    /** Date in `YYYY-MM-DD`. */
+    date: string;
+    /** Start time, e.g. "09:00". */
+    start: string;
+    /** End time, e.g. "09:30". */
+    end: string;
+    /** Optional specific staff member (UUID). */
+    staffId?: string;
+}
+/** Body for {@link BookingsResource.create}. */
+export interface CreateBookingInput {
+    /** Service to book (UUID v4). */
+    serviceId: string;
+    /** One or more slots to reserve. */
+    slots: BookingSlotInput[];
+    /** Customer name. */
+    name: string;
+    /** Customer email. */
+    email: string;
+    /** Optional IANA timezone, e.g. "Europe/London". */
+    timezone?: string;
+    /** Optional answers to the service's booking questions. */
+    questionAnswers?: Record<string, string>;
+}
+/** Result of {@link BookingsResource.create}. */
+export interface BookingCreatedResult {
+    bookingSummary: BookingSummary[];
+    customerId: string;
+}
+/** Body for {@link CustomersResource.create}. */
+export interface CreateCustomerInput {
+    name: string;
+    email: string;
+}
+/** Body for {@link CustomersResource.update}. */
+export interface UpdateCustomerInput {
+    name?: string;
+    email?: string;
+    blacklisted?: boolean;
+}
+/** Body for {@link WebhooksResource.create}. */
+export interface CreateWebhookInput {
+    url: string;
+    events: PartnerWebhookEvent[];
+}
+/** Body for {@link WebhooksResource.update}. */
+export interface UpdateWebhookInput {
+    url?: string;
+    events?: PartnerWebhookEvent[];
+}
+/** True when `value` matches the `YYYY-MM` format (e.g. "2026-06"). */
+export declare function isValidMonth(value: string): boolean;
 export interface TokenSet {
     accessToken: string;
     refreshToken: string;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,qCAAqC,CAAC;AAEnE,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,sBAAsB,EAAE,UAAU,CAAC;CACvD;AAED,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,GAAG,sBAAsB,CAAC;AAEjF,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -3,5 +3,6 @@ export { FoxSchedulingError, isFoxSchedulingError } from "./errors.js";
 export { MemoryTokenStore, FileTokenStore, type TokenStore, } from "./auth/tokenStore.js";
 export { generateCodeVerifier, generateCodeChallengeS256, generateState, } from "./auth/pkce.js";
 export { verifyFoxWebhookSignature } from "./webhooks/verify.js";
-export { DEFAULT_BASE_URL, type FoxSchedulingConfig, type FoxSchedulingAuth, type FoxSchedulingApiKeyAuth, type FoxSchedulingOAuthAuth, type TokenSet, type AuthorizationUrlResult, } from "./types.js";
+export type { WebhookSubscriptionPublic, CreateWebhookResult, } from "./resources/index.js";
+export { DEFAULT_BASE_URL, MAX_PAGE_SIZE, isValidMonth, type FoxSchedulingConfig, type FoxSchedulingAuth, type FoxSchedulingApiKeyAuth, type FoxSchedulingOAuthAuth, type TokenSet, type AuthorizationUrlResult, type ListQuery, type Page, type BookingStatus, type BookingListQuery, type CreateAvailabilityInput, type UpdateAvailabilityInput, type BookingSlotInput, type CreateBookingInput, type BookingCreatedResult, type CreateCustomerInput, type UpdateCustomerInput, type CreateWebhookInput, type UpdateWebhookInput, type PartnerEmbedOptions, type PartnerEmbedCodeDto, type PartnerEmbedTheme, type PartnerEmbedOpenMode, type PartnerEmbedButtonMode, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,KAAK,UAAU,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,QAAQ,EACb,KAAK,sBAAsB,GAC5B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,KAAK,UAAU,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,YAAY,EACV,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,QAAQ,EACb,KAAK,sBAAsB,EAC3B,KAAK,SAAS,EACd,KAAK,IAAI,EACT,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -3,4 +3,4 @@ export { FoxSchedulingError, isFoxSchedulingError } from "./errors.js";
 export { MemoryTokenStore, FileTokenStore, } from "./auth/tokenStore.js";
 export { generateCodeVerifier, generateCodeChallengeS256, generateState, } from "./auth/pkce.js";
 export { verifyFoxWebhookSignature } from "./webhooks/verify.js";
-export { DEFAULT_BASE_URL, } from "./types.js";
+export { DEFAULT_BASE_URL, MAX_PAGE_SIZE, isValidMonth, } from "./types.js";

package/dist/resources/index.d.ts

@@ -1,49 +1,58 @@
-import type { BusinessProfileDto, PartnerBookingDto, PartnerCustomerDto, PartnerServiceDto, PartnerStaffDto, PartnerWebhookEvent } from "@foxscheduling/shared";
+import type { Availability, BusinessProfileDto, PartnerBookingDto, PartnerCustomerDto, PartnerEmbedCodeDto, PartnerEmbedOptions, PartnerServiceDto, PartnerStaffDto, PartnerWebhookEvent } from "@foxscheduling/shared";
 import type { HttpClient } from "../http/client.js";
+import { type BookingCreatedResult, type BookingListQuery, type CreateAvailabilityInput, type CreateBookingInput, type CreateCustomerInput, type CreateWebhookInput, type ListQuery, type Page, type UpdateAvailabilityInput, type UpdateCustomerInput, type UpdateWebhookInput } from "../types.js";
 export declare class BusinessResource {
     private readonly http;
     constructor(http: HttpClient);
     get(): Promise<BusinessProfileDto>;
+    /**
+     * Get booking embed code (inline iframe + popup script + raw URL) for this
+     * business, with optional theming and button styling.
+     */
+    getEmbedCode(options?: PartnerEmbedOptions): Promise<PartnerEmbedCodeDto>;
 }
 export declare class ServicesResource {
     private readonly http;
     constructor(http: HttpClient);
-    list(): Promise<PartnerServiceDto[]>;
+    list(query?: ListQuery): Promise<Page<PartnerServiceDto>>;
     get(id: string): Promise<PartnerServiceDto>;
 }
 export declare class StaffResource {
     private readonly http;
     constructor(http: HttpClient);
-    list(): Promise<PartnerStaffDto[]>;
+    list(query?: ListQuery): Promise<Page<PartnerStaffDto>>;
     get(id: string): Promise<PartnerStaffDto>;
 }
 export declare class AvailabilityResource {
     private readonly http;
     constructor(http: HttpClient);
-    list(): Promise<unknown[]>;
-    get(id: string): Promise<unknown>;
-    create(body: unknown): Promise<unknown>;
-    update(id: string, body: unknown): Promise<unknown>;
-    delete(id: string): Promise<unknown>;
+    list(query?: ListQuery): Promise<Page<Availability>>;
+    get(id: string): Promise<Availability>;
+    create(body: CreateAvailabilityInput): Promise<Availability>;
+    update(id: string, body: UpdateAvailabilityInput): Promise<Availability>;
+    delete(id: string): Promise<boolean>;
 }
 export declare class BookingsResource {
     private readonly http;
     constructor(http: HttpClient);
-    list(query?: Record<string, string>): Promise<PartnerBookingDto[]>;
+    /**
+     * List bookings for a single month.
+     *
+     * `query.month` is required (format `YYYY-MM`, e.g. "2026-06") to keep the
+     * response small.
+     */
+    list(query: BookingListQuery): Promise<Page<PartnerBookingDto>>;
     get(id: string, serviceId: string): Promise<PartnerBookingDto>;
-    create(body: unknown): Promise<unknown>;
-    cancel(id: string, serviceId: string): Promise<unknown>;
+    create(body: CreateBookingInput): Promise<BookingCreatedResult>;
+    cancel(id: string, serviceId: string): Promise<PartnerBookingDto>;
 }
 export declare class CustomersResource {
     private readonly http;
     constructor(http: HttpClient);
-    list(): Promise<PartnerCustomerDto[]>;
+    list(query?: ListQuery): Promise<Page<PartnerCustomerDto>>;
     get(id: string): Promise<PartnerCustomerDto>;
-    create(body: {
-        name: string;
-        email: string;
-    }): Promise<PartnerCustomerDto>;
-    update(id: string, body: unknown): Promise<PartnerCustomerDto>;
+    create(body: CreateCustomerInput): Promise<PartnerCustomerDto>;
+    update(id: string, body: UpdateCustomerInput): Promise<PartnerCustomerDto>;
 }
 export interface WebhookSubscriptionPublic {
     id: string;
@@ -51,21 +60,16 @@ export interface WebhookSubscriptionPublic {
     events: PartnerWebhookEvent[];
     creationDate?: string;
 }
+export interface CreateWebhookResult {
+    subscription: WebhookSubscriptionPublic;
+    secret: string;
+}
 export declare class WebhooksResource {
     private readonly http;
     constructor(http: HttpClient);
-    list(): Promise<WebhookSubscriptionPublic[]>;
-    create(body: {
-        url: string;
-        events: PartnerWebhookEvent[];
-    }): Promise<{
-        subscription: WebhookSubscriptionPublic;
-        secret: string;
-    }>;
-    update(id: string, body: Partial<{
-        url: string;
-        events: PartnerWebhookEvent[];
-    }>): Promise<WebhookSubscriptionPublic>;
-    delete(id: string): Promise<unknown>;
+    list(query?: ListQuery): Promise<Page<WebhookSubscriptionPublic>>;
+    create(body: CreateWebhookInput): Promise<CreateWebhookResult>;
+    update(id: string, body: UpdateWebhookInput): Promise<WebhookSubscriptionPublic>;
+    delete(id: string): Promise<boolean>;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/resources/index.d.ts.map

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

package/dist/resources/index.js

@@ -1,3 +1,12 @@
+import { isValidMonth, } from "../types.js";
+import { FoxSchedulingError } from "../errors.js";
+/** Convert pagination options to string query params. */
+function pageQuery(query) {
+    return {
+        limit: query?.limit != null ? String(query.limit) : undefined,
+        offset: query?.offset != null ? String(query.offset) : undefined,
+    };
+}
 export class BusinessResource {
     http;
     constructor(http) {
@@ -6,14 +15,37 @@ export class BusinessResource {
     get() {
         return this.http.get("/partner/business");
     }
+    /**
+     * Get booking embed code (inline iframe + popup script + raw URL) for this
+     * business, with optional theming and button styling.
+     */
+    getEmbedCode(options = {}) {
+        return this.http.get("/partner/business/embed", {
+            servicePath: options.servicePath,
+            theme: options.theme,
+            hidePageDetails: options.hidePageDetails != null ? String(options.hidePageDetails) : undefined,
+            showThemeToggle: options.showThemeToggle != null ? String(options.showThemeToggle) : undefined,
+            heightPx: options.heightPx != null ? String(options.heightPx) : undefined,
+            iframeBorderRadius: options.iframeBorderRadius,
+            openMode: options.openMode,
+            buttonMode: options.buttonMode,
+            triggerId: options.triggerId,
+            buttonText: options.buttonText,
+            buttonBackgroundColor: options.buttonBackgroundColor,
+            buttonTextColor: options.buttonTextColor,
+            buttonBorderRadiusPx: options.buttonBorderRadiusPx != null
+                ? String(options.buttonBorderRadiusPx)
+                : undefined,
+        });
+    }
 }
 export class ServicesResource {
     http;
     constructor(http) {
         this.http = http;
     }
-    list() {
-        return this.http.get("/partner/services");
+    list(query) {
+        return this.http.get("/partner/services", pageQuery(query));
     }
     get(id) {
         return this.http.get(`/partner/services/${id}`);
@@ -24,8 +56,8 @@ export class StaffResource {
     constructor(http) {
         this.http = http;
     }
-    list() {
-        return this.http.get("/partner/staff");
+    list(query) {
+        return this.http.get("/partner/staff", pageQuery(query));
     }
     get(id) {
         return this.http.get(`/partner/staff/${id}`);
@@ -36,8 +68,8 @@ export class AvailabilityResource {
     constructor(http) {
         this.http = http;
     }
-    list() {
-        return this.http.get("/partner/availability");
+    list(query) {
+        return this.http.get("/partner/availability", pageQuery(query));
     }
     get(id) {
         return this.http.get(`/partner/availability/${id}`);
@@ -57,19 +89,38 @@ export class BookingsResource {
     constructor(http) {
         this.http = http;
     }
-    list(query) {
-        return this.http.get("/partner/bookings", query);
+    /**
+     * List bookings for a single month.
+     *
+     * `query.month` is required (format `YYYY-MM`, e.g. "2026-06") to keep the
+     * response small.
+     */
+    async list(query) {
+        if (!query || !query.month) {
+            throw new FoxSchedulingError("MONTH_REQUIRED", 'bookings.list requires a "month" in YYYY-MM format, e.g. "2026-06".');
+        }
+        if (!isValidMonth(query.month)) {
+            throw new FoxSchedulingError("INVALID_MONTH", `Invalid month "${query.month}". Expected YYYY-MM, e.g. "2026-06".`);
+        }
+        return this.http.get("/partner/bookings", {
+            yearMonth: query.month,
+            serviceId: query.serviceId,
+            providerId: query.providerId,
+            status: query.status,
+            search: query.search,
+            ...pageQuery(query),
+        });
     }
     get(id, serviceId) {
-        return this.http.get(`/partner/bookings/${id}`, { serviceId });
+        return this.http.get(`/partner/bookings/${id}`, {
+            serviceId,
+        });
     }
     create(body) {
         return this.http.post("/partner/bookings", body);
     }
     cancel(id, serviceId) {
-        return this.http.post(`/partner/bookings/${id}/cancel`, undefined, {
-            serviceId,
-        });
+        return this.http.post(`/partner/bookings/${id}/cancel`, undefined, { serviceId });
     }
 }
 export class CustomersResource {
@@ -77,8 +128,8 @@ export class CustomersResource {
     constructor(http) {
         this.http = http;
     }
-    list() {
-        return this.http.get("/partner/customers");
+    list(query) {
+        return this.http.get("/partner/customers", pageQuery(query));
     }
     get(id) {
         return this.http.get(`/partner/customers/${id}`);
@@ -95,8 +146,8 @@ export class WebhooksResource {
     constructor(http) {
         this.http = http;
     }
-    list() {
-        return this.http.get("/partner/webhooks");
+    list(query) {
+        return this.http.get("/partner/webhooks", pageQuery(query));
     }
     create(body) {
         return this.http.post("/partner/webhooks", body);

package/dist/types.d.ts

@@ -1,4 +1,100 @@
+import type { Availability, Booking, BookingSummary, PartnerPage, PartnerWebhookEvent } from "@foxscheduling/shared";
 export declare const DEFAULT_BASE_URL = "https://foxscheduling.com/api/v1";
+/** Maximum number of items returned in a single page (enforced by the API). */
+export declare const MAX_PAGE_SIZE = 100;
+/** Pagination options accepted by every list endpoint. */
+export interface ListQuery {
+    /** Items per page (1–{@link MAX_PAGE_SIZE}). The API clamps higher values. */
+    limit?: number;
+    /** Number of items to skip from the start. Defaults to 0. */
+    offset?: number;
+}
+/**
+ * A single page of results, returned by every `list()` method.
+ *
+ * Re-exported from `@foxscheduling/shared` as `PartnerPage<T>`.
+ */
+export type Page<T> = PartnerPage<T>;
+/** Re-export the embed options/result types for SDK consumers. */
+export type { PartnerEmbedOptions, PartnerEmbedCodeDto, PartnerEmbedTheme, PartnerEmbedOpenMode, PartnerEmbedButtonMode, } from "@foxscheduling/shared";
+/** Booking status values returned by the Partner API. */
+export type BookingStatus = Booking["status"];
+/**
+ * Query for {@link BookingsResource.list}.
+ *
+ * `month` is required to keep responses small — the API would otherwise return
+ * every booking for the business.
+ */
+export interface BookingListQuery extends ListQuery {
+    /** Required calendar month to fetch, format `YYYY-MM` (e.g. "2026-06"). */
+    month: string;
+    /** Restrict to a single service (UUID v4). */
+    serviceId?: string;
+    /** Restrict to a single staff/provider (UUID). */
+    providerId?: string;
+    /** Restrict to a booking status. */
+    status?: BookingStatus;
+    /** Case-insensitive search over customer name, email, or slug. */
+    search?: string;
+}
+/** Body for {@link AvailabilityResource.create}. */
+export type CreateAvailabilityInput = Omit<Availability, "id" | "ttl" | "sortKey" | "updatedOn" | "creationDate" | "schemaVersion" | "recordType" | "tenantId">;
+/** Body for {@link AvailabilityResource.update}. */
+export type UpdateAvailabilityInput = Partial<CreateAvailabilityInput>;
+/** A slot to book within {@link CreateBookingInput}. */
+export interface BookingSlotInput {
+    /** Date in `YYYY-MM-DD`. */
+    date: string;
+    /** Start time, e.g. "09:00". */
+    start: string;
+    /** End time, e.g. "09:30". */
+    end: string;
+    /** Optional specific staff member (UUID). */
+    staffId?: string;
+}
+/** Body for {@link BookingsResource.create}. */
+export interface CreateBookingInput {
+    /** Service to book (UUID v4). */
+    serviceId: string;
+    /** One or more slots to reserve. */
+    slots: BookingSlotInput[];
+    /** Customer name. */
+    name: string;
+    /** Customer email. */
+    email: string;
+    /** Optional IANA timezone, e.g. "Europe/London". */
+    timezone?: string;
+    /** Optional answers to the service's booking questions. */
+    questionAnswers?: Record<string, string>;
+}
+/** Result of {@link BookingsResource.create}. */
+export interface BookingCreatedResult {
+    bookingSummary: BookingSummary[];
+    customerId: string;
+}
+/** Body for {@link CustomersResource.create}. */
+export interface CreateCustomerInput {
+    name: string;
+    email: string;
+}
+/** Body for {@link CustomersResource.update}. */
+export interface UpdateCustomerInput {
+    name?: string;
+    email?: string;
+    blacklisted?: boolean;
+}
+/** Body for {@link WebhooksResource.create}. */
+export interface CreateWebhookInput {
+    url: string;
+    events: PartnerWebhookEvent[];
+}
+/** Body for {@link WebhooksResource.update}. */
+export interface UpdateWebhookInput {
+    url?: string;
+    events?: PartnerWebhookEvent[];
+}
+/** True when `value` matches the `YYYY-MM` format (e.g. "2026-06"). */
+export declare function isValidMonth(value: string): boolean;
 export interface TokenSet {
     accessToken: string;
     refreshToken: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,qCAAqC,CAAC;AAEnE,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,sBAAsB,EAAE,UAAU,CAAC;CACvD;AAED,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,GAAG,sBAAsB,CAAC;AAEjF,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -1 +1,8 @@
+import { isValidYearMonth, PARTNER_MAX_PAGE_SIZE, } from "@foxscheduling/shared";
 export const DEFAULT_BASE_URL = "https://foxscheduling.com/api/v1";
+/** Maximum number of items returned in a single page (enforced by the API). */
+export const MAX_PAGE_SIZE = PARTNER_MAX_PAGE_SIZE;
+/** True when `value` matches the `YYYY-MM` format (e.g. "2026-06"). */
+export function isValidMonth(value) {
+    return isValidYearMonth(value);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxscheduling/sdk",
-  "version": "0.1.1",
+  "version": "0.2.2",
   "description": "Official Fox Scheduling Partner API SDK",
   "type": "module",
   "main": "./dist/cjs/index.cjs",
@@ -13,7 +13,10 @@
       "default": "./dist/index.js"
     }
   },
-  "files": ["dist", "README.md"],
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsc && tsc -p tsconfig.cjs.json && node scripts/rename-cjs.mjs",
     "test": "NODE_OPTIONS=--experimental-vm-modules jest",
@@ -36,4 +39,4 @@
     "ts-jest": "^29",
     "typescript": "~5.9.3"
   }
-}
+}