@foxscheduling/sdk 0.1.0 → 0.2.0

package/README.md

@@ -2,27 +2,195 @@
 
 Official Node.js SDK for the [Fox Scheduling Partner API](https://foxscheduling.com/developers).
 
+Use this package to read and manage bookings, customers, availability, and more on behalf of a Fox Scheduling business — from your own server or integration.
+
+**Requirements:** Node.js 18+
+
+**Full API reference:** [foxscheduling.com/developers](https://foxscheduling.com/developers)
+
+---
+
 ## Install
 
 ```bash
 npm install @foxscheduling/sdk @foxscheduling/shared
 ```
 
-## API key (single business)
+Both packages are required. `@foxscheduling/shared` provides shared types and scope names.
+
+---
+
+## Choose how to authenticate
+
+| Method | Best for | Dashboard setup |
+| --- | --- | --- |
+| **API key** | Scripts, cron jobs, or automation for **your own** Fox business | [Developers → API keys](https://foxscheduling.com/dashboard/developers?tab=api-keys) |
+| **OAuth** | SaaS apps where **other people** connect their Fox business to your product | [Developers → OAuth apps](https://foxscheduling.com/dashboard/developers) |
+
+If you only need to access a business you own, start with an **API key**. It is the fastest path.
+
+---
+
+## Quick start: API key
+
+### 1. Create a key
+
+1. Sign in to [Fox Scheduling](https://foxscheduling.com).
+2. Open **Developers → API keys**.
+3. Pick the business, choose scopes (e.g. `business:read`, `bookings:read`), and create a key.
+4. Copy the key immediately — it is shown only once. Keys look like `fx_live_...`.
+
+### 2. Call the API
 
 ```typescript
 import { FoxScheduling } from "@foxscheduling/sdk";
 
 const fox = new FoxScheduling({
-  auth: { type: "apiKey", apiKey: process.env.FOX_API_KEY! },
+  auth: {
+    type: "apiKey",
+    apiKey: process.env.FOX_API_KEY!, // fx_live_...
+  },
 });
 
+// Example: read the connected business profile
 const business = await fox.business.get();
+console.log(business.name);
 ```
 
-Create keys under **Settings → API keys** in the Fox Scheduling dashboard.
+### Available resources
 
-## OAuth (multi-tenant integrations)
+After creating a client, use:
+
+- `fox.business` — business profile
+- `fox.services` — services
+- `fox.staff` — staff members
+- `fox.availability` — availability rules
+- `fox.bookings` — bookings
+- `fox.customers` — customers
+- `fox.webhooks` — webhook subscriptions
+
+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
+```
+
+---
+
+## OAuth: connect other users' businesses
+
+Use OAuth when you are building an integration (e.g. a CRM or reporting tool) and Fox Scheduling **users** need to authorize your app to access **their** business.
+
+OAuth is a browser-based flow. At a high level:
+
+```
+Your app                    Fox Scheduling              User's browser
+   |                              |                            |
+   |-- 1. Build authorize URL --->|                            |
+   |-- 2. Redirect user -------------------------------------->|
+   |                              |<-- 3. User signs in & allows
+   |<-- 4. Redirect to your URL with ?code=... ---------------|
+   |-- 5. Exchange code for tokens ->|                          |
+   |-- 6. Call Partner API with stored tokens                   |
+```
+
+You never type the authorization `code` yourself. Fox appends it to your redirect URL after the user clicks **Allow**.
+
+### Before you write code
+
+1. Create an OAuth app under **Developers → OAuth apps**.
+2. Note the **client ID** and **client secret** (secret is shown once).
+3. Add a **redirect URI** — the exact URL Fox will send users back to, e.g. `https://your-app.com/oauth/callback`. It must match character-for-character in your code.
+
+### Step 1 — Send the user to Fox
+
+Create the SDK client and build the authorization URL:
 
 ```typescript
 import { FoxScheduling, FileTokenStore } from "@foxscheduling/sdk";
@@ -32,27 +200,148 @@ const fox = new FoxScheduling({
     type: "oauth",
     clientId: process.env.FOX_CLIENT_ID!,
     clientSecret: process.env.FOX_CLIENT_SECRET!,
-    redirectUri: "https://your-domain.com/oauth/callback",
+    redirectUri: "https://your-app.com/oauth/callback", // must match dashboard
     tokenStore: new FileTokenStore("./fox-tokens.json"),
   },
 });
 
-const { url, codeVerifier } = fox.oauth!.getAuthorizationUrl({
+const { url, codeVerifier, state } = fox.oauth!.getAuthorizationUrl({
   scopes: ["business:read", "bookings:read"],
 });
-// Redirect user to url, then on callback:
-await fox.oauth!.exchangeCode(code, codeVerifier);
 ```
 
-## Webhook verification
+**Important:** Before redirecting the user, save `codeVerifier` and `state` somewhere tied to that user session (memory, Redis, database, encrypted cookie, etc.). You need them on the next step.
+
+Then redirect the user's browser to `url` (e.g. `res.redirect(url)` in Express).
+
+### Step 2 — Handle the callback
+
+When the user approves, Fox redirects to your `redirectUri` with query parameters:
+
+```
+https://your-app.com/oauth/callback?code=AUTHORIZATION_CODE&state=SAME_STATE_YOU_SAVED
+```
+
+In your callback route:
+
+1. Read `code` and `state` from the query string.
+2. Confirm `state` matches what you saved (prevents CSRF).
+3. Load the saved `codeVerifier` for that session.
+4. Exchange the code for tokens.
+
+```typescript
+// Example: Express route GET /oauth/callback
+app.get("/oauth/callback", async (req, res) => {
+  const code = req.query.code as string | undefined;
+  const returnedState = req.query.state as string | undefined;
+
+  if (!code) {
+    return res.status(400).send("Authorization was denied or failed.");
+  }
+  if (returnedState !== savedState) {
+    return res.status(400).send("Invalid state — possible CSRF.");
+  }
+
+  await fox.oauth!.exchangeCode(code, savedCodeVerifier);
+
+  // Tokens are saved automatically. Redirect to your app.
+  res.redirect("/dashboard");
+});
+```
+
+### Step 3 — Use the API
+
+Once `exchangeCode` succeeds, the SDK stores tokens and attaches them to every request. You can call the same resources as with an API key:
+
+```typescript
+const business = await fox.business.get();
+const bookings = await fox.bookings.list({ month: "2026-06" });
+```
+
+The SDK refreshes access tokens automatically before they expire.
+
+### What is `fox-tokens.json`?
+
+In the examples above, `FileTokenStore("./fox-tokens.json")` tells the SDK **where to save OAuth tokens on disk**.
+
+- **You do not create this file.** The SDK writes it after a successful `exchangeCode`.
+- The path is just an example — use any path you like.
+- **Keep it secret** — it contains refresh tokens. Add it to `.gitignore`.
+- **One file = one connection.** Fine for local scripts or a single test business.
+
+Example contents (written by the SDK):
+
+```json
+{
+  "accessToken": "eyJhbGciOiJSUzI1NiIs...",
+  "refreshToken": "opaque-refresh-token",
+  "expiresAt": 1710003600000,
+  "scope": "business:read bookings:read",
+  "tokenType": "Bearer"
+}
+```
+
+### Production OAuth apps
+
+If many Fox users will connect their businesses, **do not** use one shared file. Implement the `TokenStore` interface and save tokens in your database, keyed by your user ID (or Fox `tenant_id`):
+
+```typescript
+import type { TokenStore, TokenSet } from "@foxscheduling/sdk";
+
+class DatabaseTokenStore implements TokenStore {
+  constructor(private userId: string) {}
+  async load(): Promise<TokenSet | null> { /* read from DB */ }
+  async save(tokens: TokenSet): Promise<void> { /* write to DB */ }
+  async clear(): Promise<void> { /* delete from DB */ }
+}
+```
+
+For unit tests, use `MemoryTokenStore()` (tokens disappear when the process exits).
+
+More detail: [OAuth2 integration guide](https://foxscheduling.com/developers/oauth2)
+
+---
+
+## Webhook signature verification
+
+When Fox sends a webhook to your server, verify the `X-Fox-Signature` header:
 
 ```typescript
 import { verifyFoxWebhookSignature } from "@foxscheduling/sdk";
 
 const ok = verifyFoxWebhookSignature({
-  secret: webhookSecret,
+  secret: process.env.FOX_WEBHOOK_SECRET!,
   timestamp: req.headers["x-fox-timestamp"],
-  rawBody: req.rawBody,
+  rawBody: req.rawBody, // unparsed request body string
   signatureHex: req.headers["x-fox-signature"],
 });
+
+if (!ok) {
+  return res.status(401).send("Invalid signature");
+}
 ```
+
+Your HTTP framework must give you the **raw** body (before JSON parsing) for verification to work.
+
+---
+
+## Scopes
+
+Each API key or OAuth request uses scopes such as:
+
+`business:read`, `services:read`, `staff:read`, `availability:read`, `availability:write`, `bookings:read`, `bookings:write`, `customers:read`, `customers:write`, `webhooks:read`, `webhooks:write`
+
+Request only the scopes your integration needs. See the [scope reference](https://foxscheduling.com/developers/oauth2#scopes).
+
+---
+
+## Links
+
+- [Developers hub](https://foxscheduling.com/developers)
+- [OAuth2 guide](https://foxscheduling.com/developers/oauth2)
+- [API key guide](https://foxscheduling.com/developers/api-key)
+- [Developers dashboard](https://foxscheduling.com/dashboard/developers)
+
+## Support
+
+Questions or integration help: [foxscheduling.com/contact](https://foxscheduling.com/contact)

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, } 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,GAC1B,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,27 @@ 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,
+            buttonText: options.buttonText,
+            buttonBackgroundColor: options.buttonBackgroundColor,
+            buttonTextColor: options.buttonTextColor,
+            buttonBorderRadiusPx: options.buttonBorderRadiusPx != null
+                ? String(options.buttonBorderRadiusPx)
+                : undefined,
+        });
+    }
 }
 exports.BusinessResource = BusinessResource;
 class ServicesResource {
@@ -16,8 +46,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 +59,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 +72,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 +94,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 +134,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 +153,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":"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"}

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, } 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, } 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,GAC1B,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,35 @@ 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,
+            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 +54,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 +66,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 +87,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 +126,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 +144,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, } 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.0",
+  "version": "0.2.0",
   "description": "Official Fox Scheduling Partner API SDK",
   "type": "module",
   "main": "./dist/cjs/index.cjs",