@openaisdk/billing-sdk-node 1.11.5 → 1.13.2

package/README.md

@@ -72,6 +72,64 @@ const customer = await billing.customers.create(
 );
 ```
 
+### 3.1. Обновить профиль плательщика
+
+Форма в ЛК вендора (имя / компания, email, телефон) сохраняется через `customers.update`. Отдельного поля `company` нет: передайте компанию в `name`. Login-email пользователя — зона вашего identity, не Billing.
+
+- Пропущенное поле не меняется; `null` очищает.
+- `externalType` / `externalId` иммутабельны.
+- `idempotencyKey` опционален (как у cancel): last-write-wins, безопасный retry.
+- Уже финализированные счета не переписываются; следующий invoice возьмёт актуальный контакт в snapshot.
+- `invoice.finalized` — webhook на ваш URL, не письмо на `customer.email`.
+
+```ts
+const updated = await billing.customers.update(
+  customer.id,
+  {
+    name: 'Acme LLC',
+    email: 'billing@acme.example',
+    phone: null,
+  },
+  { idempotencyKey: `customer-update:${customer.id}:v1` }
+);
+
+console.log(updated.name, updated.email, updated.phone);
+```
+
+Пример через curl (sandbox):
+
+```bash
+# GET
+curl -sS "$BILLING_API_URL/v1/customers/cus_123" \
+  -H "Authorization: Bearer $BILLING_API_KEY"
+
+# PATCH
+curl -sS -X PATCH "$BILLING_API_URL/v1/customers/cus_123" \
+  -H "Authorization: Bearer $BILLING_API_KEY" \
+  -H "Content-Type: application/json" \
+  -H "Idempotency-Key: customer-update:cus_123:v1" \
+  -d '{"name":"Acme LLC","email":"billing@acme.example","phone":null}'
+```
+
+Ожидаемый ответ `200`:
+
+```json
+{
+  "id": "cus_123",
+  "object": "customer",
+  "livemode": false,
+  "externalType": "workspace",
+  "externalId": "ws_123",
+  "email": "billing@acme.example",
+  "name": "Acme LLC",
+  "phone": null,
+  "status": "active",
+  "createdAt": "2026-08-10T00:00:00.000Z"
+}
+```
+
+Пустой body `{}` → `400 bad_request`. Невалидный email → `400`. Клиент другого проекта → `404 customer_account_not_found`.
+
 ### 4. Открыть оплату
 
 `checkout.sessions.create` → отправьте человека на `confirmationUrl`. Для create/checkout передавайте `idempotencyKey`. Если у клиента уже есть живая подписка (`active` / `trialing` / `past_due`), create вернёт 409 `active_subscription_exists` — смену тарифа делайте через `subscriptions.previewChange` / `subscriptions.change`. Незавершённую оплату читайте из `access.incompleteCheckout` и продолжайте через `checkout.sessions.resume(id)` (id = pending `sub_...`).
@@ -281,6 +339,12 @@ try {
 
 ## Changelog
 
+### 1.13.1
+
+- Документирован `billing.customers.update` (профиль плательщика: `name` / `email` / `phone`).
+- README: семантика omit/`null`, optional `idempotencyKey`, curl GET/PATCH 200, email vs login, invoice `customer_snapshot` не переписывается.
+- Версия пакета выровнена с `SDK_VERSION`.
+
 ### 1.13.0
 
 - `billing.featureGroups.list()` / `.retrieve(code)` — публичные разделы прайса.

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { toUiProjection } from './diagnostics/index.js';
 import type { CheckResult, CheckStatus, DiagnosticsContext, DiagnosticsOptions, DiagnosticsReport, DiagnosticsUiProjection } from './diagnostics/index.js';
-declare const SDK_VERSION = "1.13.0";
+declare const SDK_VERSION = "1.13.1";
 declare const SDK_PACKAGE_NAME = "@openaisdk/billing-sdk-node";
 declare const DEFAULT_BASE_URL = "https://billing.example.com";
 declare const DEFAULT_TIMEOUT_MS = 30000;

package/dist/index.js

@@ -1,6 +1,6 @@
 import { createHmac, timingSafeEqual } from 'crypto';
 import { createDiagnostics, toUiProjection } from './diagnostics/index.js';
-const SDK_VERSION = '1.13.0';
+const SDK_VERSION = '1.13.1';
 const SDK_PACKAGE_NAME = '@openaisdk/billing-sdk-node';
 const DEFAULT_BASE_URL = 'https://billing.example.com';
 const DEFAULT_TIMEOUT_MS = 30_000;

package/examples/quickstart.ts

@@ -47,9 +47,20 @@ const customer = await billing.customers.create(
   }
 );
 
+const updatedCustomer = await billing.customers.update(
+  customer.id,
+  {
+    name: `${workspaceName} (billing)`,
+    email: workspaceEmail,
+  },
+  {
+    idempotencyKey: `customer-update:${workspaceId}:v1`,
+  }
+);
+
 const checkout = await billing.checkout.sessions.create(
   {
-    customer: customer.id,
+    customer: updatedCustomer.id,
     price: resolvedPriceId,
     successUrl: `${appUrl}/billing/success`,
     cancelUrl: `${appUrl}/billing`,
@@ -89,8 +100,9 @@ console.log(
       priceId: resolvedPriceId,
       featureCount: features.data.length,
       productFeatureCount: productFeatures.data.length,
-      customerId: customer.id,
-      customerLivemode: customer.livemode,
+      customerId: updatedCustomer.id,
+      customerName: updatedCustomer.name,
+      customerLivemode: updatedCustomer.livemode,
       confirmationUrl: checkout.confirmationUrl,
       subscriptionId: checkout.subscription,
       accessStatus: access.status,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openaisdk/billing-sdk-node",
-  "version": "1.11.5",
+  "version": "1.13.2",
   "description": "Handwritten public Node SDK for Mega-Billing Wave 1 API",
   "license": "MIT",
   "author": "Anatoliy Tukov <openaisdk@gmail.com>",
@@ -52,7 +52,7 @@
     "build": "tsc -p tsconfig.json",
     "clean": "rm -rf dist",
     "lint": "eslint .",
-    "test": "pnpm run build && node --test ./test/**/*.test.mjs",
+    "test": "pnpm run build && node --test ./test/*.test.mjs",
     "quickstart": "tsx ./examples/quickstart.ts",
     "webhook-forward": "node ./bin/billing-sdk-webhook-forward.mjs",
     "prepack": "pnpm run test"