@ophelio/sdk 0.3.0 → 0.3.2

package/dist/index.mjs

@@ -125,6 +125,21 @@ const DEFAULT_MAX_RETRIES = 2;
 function resolveIdempotencyKey(idempotencyKey) {
 	return idempotencyKey?.trim() || crypto.randomUUID();
 }
+/**
+* Serialises query parameters into a search string.
+*
+* `undefined` drops the parameter entirely. An empty array does not: it emits
+* the bare key (`?status=`), because "filter by nothing" and "do not filter"
+* are different requests and the API distinguishes them.
+*/
+function serialiseQuery(query) {
+	const search = new URLSearchParams();
+	for (const [key, value] of Object.entries(query ?? {})) {
+		if (value === void 0) continue;
+		search.set(key, Array.isArray(value) ? value.join(",") : value);
+	}
+	return search.toString();
+}
 var Transport = class {
 	apiKey;
 	baseUrl;
@@ -179,9 +194,7 @@ var Transport = class {
 		throw lastError;
 	}
 	buildUrl(params) {
-		const search = new URLSearchParams();
-		for (const [key, value] of Object.entries(params.query ?? {})) if (value !== void 0) search.set(key, value);
-		const queryString = search.toString();
+		const queryString = serialiseQuery(params.query);
 		return `${this.baseUrl}${params.path}${queryString ? `?${queryString}` : ""}`;
 	}
 	buildHeaders(params) {
@@ -313,6 +326,125 @@ var BillingOptionsResource = class extends APIResource {
 	}
 };
 //#endregion
+//#region src/resources/calendar-rules.ts
+/**
+* A calendar rule is one row of a calendar's date vocabulary. Conditions AND
+* within a rule and rules OR across a calendar, so "weekends in August" is a
+* single rule rather than two.
+*
+* Rules are created and listed through their calendar
+* (`ophelio.calendars.createRule` / `ophelio.calendars.listRules`); this
+* resource addresses an individual rule.
+*/
+var CalendarRulesResource = class extends APIResource {
+	get(id, options) {
+		return this.transport.request({
+			method: "GET",
+			path: `/api/v1/calendar-rules/${encodeURIComponent(id)}`,
+			retryable: true,
+			options
+		});
+	}
+	update(id, params, options) {
+		return this.transport.request({
+			method: "PATCH",
+			path: `/api/v1/calendar-rules/${encodeURIComponent(id)}`,
+			body: params,
+			retryable: false,
+			options
+		});
+	}
+	async delete(id, options) {
+		await this.transport.request({
+			method: "DELETE",
+			path: `/api/v1/calendar-rules/${encodeURIComponent(id)}`,
+			retryable: false,
+			options
+		});
+	}
+};
+//#endregion
+//#region src/resources/calendars.ts
+/**
+* Calendars are named, reusable date vocabularies ("Peak 2026", "Weekends").
+* The dates themselves live in the rules attached to them.
+*
+* A calendar containing no rules is valid for **all** dates, not none.
+*/
+var CalendarsResource = class extends APIResource {
+	async list(params, options) {
+		const response = await this.transport.request({
+			method: "GET",
+			path: "/api/v1/calendars",
+			query: pageQuery(params),
+			retryable: true,
+			options
+		});
+		return {
+			items: response.calendars,
+			next_page_token: response.next_page_token,
+			total_size: response.total_size
+		};
+	}
+	get(id, options) {
+		return this.transport.request({
+			method: "GET",
+			path: `/api/v1/calendars/${encodeURIComponent(id)}`,
+			retryable: true,
+			options
+		});
+	}
+	create(params, options) {
+		return this.transport.request({
+			method: "POST",
+			path: "/api/v1/calendars",
+			body: params,
+			retryable: false,
+			options
+		});
+	}
+	update(id, params, options) {
+		return this.transport.request({
+			method: "PATCH",
+			path: `/api/v1/calendars/${encodeURIComponent(id)}`,
+			body: params,
+			retryable: false,
+			options
+		});
+	}
+	async delete(id, options) {
+		await this.transport.request({
+			method: "DELETE",
+			path: `/api/v1/calendars/${encodeURIComponent(id)}`,
+			retryable: false,
+			options
+		});
+	}
+	async listRules(id, params, options) {
+		const response = await this.transport.request({
+			method: "GET",
+			path: `/api/v1/calendars/${encodeURIComponent(id)}/rules`,
+			query: pageQuery(params),
+			retryable: true,
+			options
+		});
+		return {
+			items: response.rules,
+			next_page_token: response.next_page_token,
+			total_size: response.total_size
+		};
+	}
+	createRule(id, params, options) {
+		return this.transport.request({
+			method: "POST",
+			path: `/api/v1/calendars/${encodeURIComponent(id)}/rules`,
+			body: params,
+			retryable: false,
+			options
+		});
+	}
+};
+//#endregion
 //#region src/resources/customers.ts
 var CustomersResource = class extends APIResource {
 	/**
@@ -798,6 +930,45 @@ var MembershipsResource = class extends APIResource {
 	}
 };
 //#endregion
+//#region src/resources/plan-entitlement-availabilities.ts
+/**
+* An availability row says when and where one plan entitlement applies: a
+* calendar (null = any date) and a set of registered target codes (empty =
+* anywhere). Rows OR, and a plan entitlement with no rows at all is
+* unrestricted.
+*
+* Rows are created and listed through their plan entitlement
+* (`ophelio.planEntitlements.createAvailability` / `listAvailabilities`); this
+* resource addresses an individual row.
+*/
+var PlanEntitlementAvailabilitiesResource = class extends APIResource {
+	get(id, options) {
+		return this.transport.request({
+			method: "GET",
+			path: `/api/v1/plan-entitlement-availabilities/${encodeURIComponent(id)}`,
+			retryable: true,
+			options
+		});
+	}
+	update(id, params, options) {
+		return this.transport.request({
+			method: "PATCH",
+			path: `/api/v1/plan-entitlement-availabilities/${encodeURIComponent(id)}`,
+			body: params,
+			retryable: false,
+			options
+		});
+	}
+	async delete(id, options) {
+		await this.transport.request({
+			method: "DELETE",
+			path: `/api/v1/plan-entitlement-availabilities/${encodeURIComponent(id)}`,
+			retryable: false,
+			options
+		});
+	}
+};
+//#endregion
 //#region src/resources/plan-entitlements.ts
 var PlanEntitlementsResource = class extends APIResource {
 	get(id, options) {
@@ -826,6 +997,29 @@ var PlanEntitlementsResource = class extends APIResource {
 			options
 		});
 	}
+	async listAvailabilities(id, params, options) {
+		const response = await this.transport.request({
+			method: "GET",
+			path: `/api/v1/plan-entitlements/${encodeURIComponent(id)}/availabilities`,
+			query: pageQuery(params),
+			retryable: true,
+			options
+		});
+		return {
+			items: response.availabilities,
+			next_page_token: response.next_page_token,
+			total_size: response.total_size
+		};
+	}
+	createAvailability(id, params, options) {
+		return this.transport.request({
+			method: "POST",
+			path: `/api/v1/plan-entitlements/${encodeURIComponent(id)}/availabilities`,
+			body: params,
+			retryable: false,
+			options
+		});
+	}
 };
 //#endregion
 //#region src/resources/plan-links.ts
@@ -1060,6 +1254,74 @@ var SalesChannelsResource = class extends APIResource {
 	}
 };
 //#endregion
+//#region src/resources/target-codes.ts
+/**
+* The registered vocabulary of locations a gate can report (`venue_a`,
+* `coffee_shop`). Codes are matched exactly — list them and send values back
+* verbatim rather than constructing or case-folding them.
+*/
+var TargetCodesResource = class extends APIResource {
+	async list(params, options) {
+		const response = await this.transport.request({
+			method: "GET",
+			path: "/api/v1/target-codes",
+			query: pageQuery(params),
+			retryable: true,
+			options
+		});
+		return {
+			items: response.target_codes,
+			next_page_token: response.next_page_token,
+			total_size: response.total_size
+		};
+	}
+	get(id, options) {
+		return this.transport.request({
+			method: "GET",
+			path: `/api/v1/target-codes/${encodeURIComponent(id)}`,
+			retryable: true,
+			options
+		});
+	}
+	/**
+	* `code` is lowercase letters and digits with single underscores between
+	* segments, at least one letter, 2–64 characters. Anything else is refused
+	* with a 400 rather than normalised, so `Venue A` is an error, not
+	* `venue_a`.
+	*/
+	create(params, options) {
+		return this.transport.request({
+			method: "POST",
+			path: "/api/v1/target-codes",
+			body: params,
+			retryable: false,
+			options
+		});
+	}
+	/**
+	* `display_name` and `description` only — `code` is immutable from
+	* creation and sending it is a 400. To correct a typo, create the right
+	* code, repoint whatever uses it, then delete the old one.
+	*/
+	update(id, params, options) {
+		return this.transport.request({
+			method: "PATCH",
+			path: `/api/v1/target-codes/${encodeURIComponent(id)}`,
+			body: params,
+			retryable: false,
+			options
+		});
+	}
+	async delete(id, options) {
+		await this.transport.request({
+			method: "DELETE",
+			path: `/api/v1/target-codes/${encodeURIComponent(id)}`,
+			retryable: false,
+			options
+		});
+	}
+};
+//#endregion
 //#region src/resources/webhook-subscriptions.ts
 var WebhookSubscriptionsResource = class extends APIResource {
 	async list(options) {
@@ -1184,7 +1446,11 @@ var Ophelio = class Ophelio {
 	memberRoles;
 	pricingGroups;
 	salesChannels;
+	targetCodes;
+	calendars;
+	calendarRules;
 	planEntitlements;
+	planEntitlementAvailabilities;
 	planLinks;
 	planPricingGroupMappings;
 	billingOptionSalesChannels;
@@ -1207,7 +1473,11 @@ var Ophelio = class Ophelio {
 		this.memberRoles = new MemberRolesResource(transport);
 		this.pricingGroups = new PricingGroupsResource(transport);
 		this.salesChannels = new SalesChannelsResource(transport);
+		this.targetCodes = new TargetCodesResource(transport);
+		this.calendars = new CalendarsResource(transport);
+		this.calendarRules = new CalendarRulesResource(transport);
 		this.planEntitlements = new PlanEntitlementsResource(transport);
+		this.planEntitlementAvailabilities = new PlanEntitlementAvailabilitiesResource(transport);
 		this.planLinks = new PlanLinksResource(transport);
 		this.planPricingGroupMappings = new PlanPricingGroupMappingsResource(transport);
 		this.billingOptionSalesChannels = new BillingOptionSalesChannelsResource(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ophelio/sdk",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Official JavaScript / TypeScript SDK for the Ophel.io membership & entitlement API.",
   "license": "MIT",
   "author": "Ophel.io",