@ophelio/sdk 0.2.0 → 0.2.2

package/dist/index.mjs

@@ -116,6 +116,15 @@ function sleep(ms) {
 const DEFAULT_BASE_URL = "https://api.ophel.io";
 const DEFAULT_TIMEOUT_MS = 3e4;
 const DEFAULT_MAX_RETRIES = 2;
+/**
+* Resolves the caller-supplied idempotency key to the value sent on the wire.
+* Trims it and falls back to a generated key when it is absent, empty, or
+* whitespace-only — a blank key must never leave an idempotency-keyed mutation
+* retryable but unkeyed, or a retried write could duplicate.
+*/
+function resolveIdempotencyKey(idempotencyKey) {
+	return idempotencyKey?.trim() || crypto.randomUUID();
+}
 var Transport = class {
 	apiKey;
 	baseUrl;
@@ -383,7 +392,7 @@ var EntitlementsResource = class extends APIResource {
 			method: "POST",
 			path: "/api/v1/entitlements/redeem",
 			body: params,
-			idempotencyKey: idempotencyKey ?? crypto.randomUUID(),
+			idempotencyKey: resolveIdempotencyKey(idempotencyKey),
 			retryable: true,
 			options: requestOptions
 		});
@@ -398,7 +407,7 @@ var EntitlementsResource = class extends APIResource {
 			method: "POST",
 			path: "/api/v1/entitlements/usage",
 			body: params,
-			idempotencyKey: idempotencyKey ?? crypto.randomUUID(),
+			idempotencyKey: resolveIdempotencyKey(idempotencyKey),
 			retryable: true,
 			options: requestOptions
 		})).usage;
@@ -525,6 +534,44 @@ var MembersResource = class extends APIResource {
 			options
 		})).entitlements;
 	}
+	/**
+	* Updates a member's details. Accepts `name`, `date_of_birth` and `role`
+	* (a member-role code). To reassign the primary member use `setPrimary`;
+	* to rotate a card use `reissueCard`.
+	*/
+	update(id, params, options) {
+		return this.transport.request({
+			method: "PATCH",
+			path: `/api/v1/members/${encodeURIComponent(id)}`,
+			body: params,
+			retryable: false,
+			options
+		});
+	}
+	/**
+	* Remove a member from its membership. Rejected if it is the last member
+	* or the sole primary — reassign the primary first with `setPrimary`.
+	*/
+	remove(id, options) {
+		return this.transport.request({
+			method: "DELETE",
+			path: `/api/v1/members/${encodeURIComponent(id)}`,
+			retryable: false,
+			options
+		});
+	}
+	/**
+	* Make this member the primary of its membership, demoting the current
+	* primary atomically. A no-op if it is already primary.
+	*/
+	setPrimary(id, options) {
+		return this.transport.request({
+			method: "POST",
+			path: `/api/v1/members/${encodeURIComponent(id)}/set-primary`,
+			retryable: false,
+			options
+		});
+	}
 	/** Issue a fresh card id, invalidating the old card at the gate. */
 	reissueCard(id, params = {}, options) {
 		return this.transport.request({
@@ -561,13 +608,22 @@ var MembershipsResource = class extends APIResource {
 			options
 		});
 	}
-	create(params, options) {
+	/**
+	* Create a membership atomically (record, members, first term, optional
+	* payment). Idempotent: the Idempotency-Key is generated once per call (and
+	* reused across the SDK's internal retries), so a retried create returns the
+	* original membership instead of creating a duplicate. Supply your own key to
+	* dedupe application-level retries across processes.
+	*/
+	create(params, options = {}) {
+		const { idempotencyKey, ...requestOptions } = options;
 		return this.transport.request({
 			method: "POST",
 			path: "/api/v1/memberships",
 			body: params,
-			retryable: false,
-			options
+			idempotencyKey: resolveIdempotencyKey(idempotencyKey),
+			retryable: true,
+			options: requestOptions
 		});
 	}
 	update(id, params, options) {
@@ -614,14 +670,19 @@ var MembershipsResource = class extends APIResource {
 	/**
 	* Report a payment outcome. Ophel.io never processes payments — your
 	* payment provider does; this records the result and drives dunning.
+	* Idempotent: the Idempotency-Key is generated once per call (and reused
+	* across the SDK's internal retries), so a retried report records the
+	* transaction once and does not advance dunning twice.
 	*/
-	createTransaction(id, params, options) {
+	createTransaction(id, params, options = {}) {
+		const { idempotencyKey, ...requestOptions } = options;
 		return this.transport.request({
 			method: "POST",
 			path: `/api/v1/memberships/${encodeURIComponent(id)}/transactions`,
 			body: params,
-			retryable: false,
-			options
+			idempotencyKey: resolveIdempotencyKey(idempotencyKey),
+			retryable: true,
+			options: requestOptions
 		});
 	}
 	async listMembers(id, options) {
@@ -632,17 +693,38 @@ var MembershipsResource = class extends APIResource {
 			options
 		})).members;
 	}
-	/** Open the next term. Rejected (409) while cancelled or cancellation-pending. */
-	renew(id, params, options) {
+	/**
+	* Add a member to an existing membership, up to the plan's max party size.
+	* `role` is a member-role code; an optional `email` links the member to a
+	* customer record. Rejected on cancelled or expired memberships.
+	*/
+	addMember(id, params, options) {
 		return this.transport.request({
 			method: "POST",
-			path: `/api/v1/memberships/${encodeURIComponent(id)}/renew`,
+			path: `/api/v1/memberships/${encodeURIComponent(id)}/members`,
 			body: params,
 			retryable: false,
 			options
 		});
 	}
 	/**
+	* Open the next term. Rejected (409) while cancelled or cancellation-pending.
+	* Idempotent: the Idempotency-Key is generated once per call (and reused
+	* across the SDK's internal retries), so a retried renewal returns the
+	* original result instead of opening a second term.
+	*/
+	renew(id, params, options = {}) {
+		const { idempotencyKey, ...requestOptions } = options;
+		return this.transport.request({
+			method: "POST",
+			path: `/api/v1/memberships/${encodeURIComponent(id)}/renew`,
+			body: params,
+			idempotencyKey: resolveIdempotencyKey(idempotencyKey),
+			retryable: true,
+			options: requestOptions
+		});
+	}
+	/**
 	* Move to a linked higher plan. Applies immediately or schedules at term
 	* end — `scheduled_change` is non-null in the deferred case.
 	*/
@@ -1187,7 +1269,9 @@ const WEBHOOK_EVENT_CODES = [
 	"membership.downgraded",
 	"scheduled_change.failed",
 	"entitlement.used",
+	"member.added",
 	"member.card_issued",
+	"member.updated",
 	"member.removed",
 	"plan.updated"
 ];

package/package.json

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