@minipim/sdk 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,15 @@
+                    GNU AFFERO GENERAL PUBLIC LICENSE
+                       Version 3, 19 November 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+This project is licensed under the GNU Affero General Public License v3.0.
+The full text of the license is available at:
+  https://www.gnu.org/licenses/agpl-3.0.txt
+
+Copyright (c) 2026 Epic Design Labs
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see <https://www.gnu.org/licenses/>.

package/README.md

@@ -8,7 +8,9 @@ Typed TypeScript client for the [MiniPim](https://github.com/Epic-Design-Labs/mi
 pnpm add @minipim/sdk
 ```
 
-Requires Node 18+ (for native `fetch`) or a fetch polyfill.
+Requires Node 18+ (for native `fetch`) or a fetch polyfill. **ESM-only** (`"type": "module"`) — no CommonJS build; use `import`, not `require`. The root entry imports no `node:` modules, so `createMinipimClient` and the attribute/pagination helpers are safe in Edge runtimes.
+
+`baseUrl` is the **origin** (`https://api.minipim.com`); every endpoint path already includes `/v1/...`, so you pass `pim.GET('/v1/products')`, not a pre-joined URL.
 
 ## Quick start
 
@@ -74,7 +76,8 @@ import { verifyMinipimWebhook } from '@minipim/sdk/webhook';
 export async function POST(req: Request) {
   const raw = await req.text();
   const sig = req.headers.get('x-minipim-signature-256') ?? '';
-  const ok = await verifyMinipimWebhook({
+  // Node verifier is synchronous — no await.
+  const ok = verifyMinipimWebhook({
     rawBody: raw,
     signature: sig,
     secret: process.env.MINIPIM_WEBHOOK_SECRET!,
@@ -92,36 +95,74 @@ export async function POST(req: Request) {
 ### Edge / Cloudflare Workers / Vercel Edge
 
 ```ts
-import { verifyMinipimWebhookEdge } from '@minipim/sdk/webhook';
+import { verifyMinipimWebhookEdge } from '@minipim/sdk/webhook-edge';
 
 const ok = await verifyMinipimWebhookEdge({ rawBody, signature, secret });
+if (!ok) return new Response('invalid signature', { status: 401 });
 ```
 
 Both functions:
 - Constant-time comparison (safe against timing attacks).
 - Return `false` on malformed signatures (don't throw).
-- Same interface; the only difference is which crypto API they use under the hood.
+
+**Node verifier is synchronous; Edge verifier is async.** The Node one (`@minipim/sdk/webhook`) returns `boolean` — use it directly in `if (!verifyMinipimWebhook(...))`. The Edge one (`@minipim/sdk/webhook-edge`) returns `Promise<boolean>` — you must `await` it. They live on separate entry points so the Node `node:crypto` import never lands in an Edge bundle.
 
 ## Pagination
 
-Every list endpoint returns `{ data, limit, offset, hasMore, total? }`. Iterate via `hasMore`:
+Don't hand-roll the `hasMore` loop — the SDK ships `paginate`, a generic async iterator over any list endpoint:
 
 ```ts
-async function* allProducts() {
-  let offset = 0;
-  for (;;) {
-    const { data, error } = await pim.GET('/v1/products', {
-      params: { query: { limit: 200, offset } },
-    });
-    if (error) throw new Error(error.error.message);
-    for (const p of data.data) yield p;
-    if (!data.hasMore) return;
-    offset += 200;
-  }
+import { paginate, collectAll } from '@minipim/sdk';
+import type { components } from '@minipim/sdk';
+
+type Product = components['schemas']['ProductSelect'];
+
+// stream
+for await (const p of paginate<Product>(pim, '/v1/products', { query: { status: 'active' } })) {
+  await ingest(p);
 }
+
+// or collect everything
+const all = await collectAll<Product>(pim, '/v1/products');
 ```
 
-Pass `withTotal: true` if you need `data.total` — adds one `COUNT(*)` query, so leave it off on hot reads.
+`paginate` manages `limit`/`offset`, honors the server's `hasMore`, and defaults to the 200-row max page size (override with `pageSize`). Pass `withTotal: true` in `query` if you need `total` — it adds one `COUNT(*)`, so leave it off on hot reads.
+
+## Attribute helpers
+
+Attribute values are `unknown` and keyed by `(locale, channel)`. List responses return the raw `{ code: [{ locale, channel, value }] }` shape (only product *detail* with `?locale=&channel=` returns a flat `resolvedAttributes`). The SDK ships the flatten + coercion helpers so you don't reimplement them:
+
+```ts
+import {
+  flattenAttributes, getAttribute, asMoney, asMeasurement, formatMoney,
+} from '@minipim/sdk';
+
+// resolve one code for a (locale, channel), with server-matching fallback
+const desc = getAttribute(product.attributes, 'description', { locale: 'en_US', channel: 'headless-main' });
+
+// flatten the whole bag (client-side equivalent of resolvedAttributes, for lists)
+const flat = flattenAttributes(product.attributes, { locale: 'en_US', channel: 'headless-main' });
+
+// coerce money / measurement shapes
+const price = asMoney(getAttribute(product.attributes, 'price'));      // { amount_cents, currency } | null
+if (price) console.log(formatMoney(price));                            // "$18.99"
+const weight = asMeasurement(getAttribute(product.attributes, 'weight')); // { amount, unit } | null
+```
+
+Also available at the `@minipim/sdk/attributes` subpath.
+
+## Error handling
+
+`res.error` is a per-path union that's awkward to narrow. Use the shared guard:
+
+```ts
+import { isMinipimError, getErrorMessage } from '@minipim/sdk';
+
+const { data, error } = await pim.GET('/v1/products/{id}', { params: { path: { id } } });
+if (error) {
+  throw new Error(getErrorMessage(error, 'fetch failed'));   // pulls error.error.message
+}
+```
 
 ## Reconciliation after downtime
 

package/dist/attributes.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Attribute helpers. MiniPim stores attribute values keyed by
+ * `(locale, channel)` — list responses always return the raw
+ * `{ code: [{ locale, channel, value }] }` shape (only product *detail*
+ * with `?locale=&channel=` returns a flat `resolvedAttributes`). So every
+ * consumer ends up writing the same flatten + money/measurement coercions.
+ * These are those helpers, typed.
+ */
+export interface AttributeValueRecord {
+    locale: string | null;
+    channel: string | null;
+    value: unknown;
+}
+export type AttributesPayload = Record<string, AttributeValueRecord[]>;
+export interface Money {
+    amount_cents: number;
+    currency: string;
+}
+export interface Measurement {
+    amount: number;
+    unit: string;
+}
+export interface ResolveOptions {
+    locale?: string | null;
+    channel?: string | null;
+}
+/**
+ * Resolve a single attribute code to its value for a (locale, channel).
+ * Fallback order mirrors the server: exact `(locale, channel)` →
+ * `(locale, null)` → `(null, channel)` → `(null, null)`. Returns
+ * `undefined` when nothing matches.
+ */
+export declare function getAttribute(attributes: AttributesPayload, code: string, opts?: ResolveOptions): unknown;
+/**
+ * Flatten an entire attribute payload to a `{ code: value }` map for a
+ * (locale, channel) — the client-side equivalent of the server's
+ * `resolvedAttributes`, for use on list responses where the server doesn't
+ * flatten. Codes with no matching value are omitted.
+ */
+export declare function flattenAttributes(attributes: AttributesPayload, opts?: ResolveOptions): Record<string, unknown>;
+/** Narrow an attribute value to Money, or null if it isn't money-shaped. */
+export declare function asMoney(value: unknown): Money | null;
+/** Narrow an attribute value to Measurement, or null if it isn't measurement-shaped. */
+export declare function asMeasurement(value: unknown): Measurement | null;
+/** Format integer-cents Money as a localized currency string. */
+export declare function formatMoney(money: Money, locale?: string): string;
+//# sourceMappingURL=attributes.d.ts.map

package/dist/attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../src/attributes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC;AAEvE,MAAM,WAAW,KAAK;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,iBAAiB,EAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,cAAmB,GACxB,OAAO,CAgBT;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,iBAAiB,EAC7B,IAAI,GAAE,cAAmB,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB;AAED,4EAA4E;AAC5E,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,GAAG,IAAI,CAUpD;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAUhE;AAED,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,SAAU,GAAG,MAAM,CAKlE"}

package/dist/attributes.js

@@ -0,0 +1,76 @@
+/**
+ * Attribute helpers. MiniPim stores attribute values keyed by
+ * `(locale, channel)` — list responses always return the raw
+ * `{ code: [{ locale, channel, value }] }` shape (only product *detail*
+ * with `?locale=&channel=` returns a flat `resolvedAttributes`). So every
+ * consumer ends up writing the same flatten + money/measurement coercions.
+ * These are those helpers, typed.
+ */
+/**
+ * Resolve a single attribute code to its value for a (locale, channel).
+ * Fallback order mirrors the server: exact `(locale, channel)` →
+ * `(locale, null)` → `(null, channel)` → `(null, null)`. Returns
+ * `undefined` when nothing matches.
+ */
+export function getAttribute(attributes, code, opts = {}) {
+    const records = attributes[code];
+    if (!records || records.length === 0)
+        return undefined;
+    const locale = opts.locale ?? null;
+    const channel = opts.channel ?? null;
+    const layers = [
+        [locale, channel],
+        [locale, null],
+        [null, channel],
+        [null, null],
+    ];
+    for (const [l, c] of layers) {
+        const hit = records.find((r) => r.locale === l && r.channel === c);
+        if (hit)
+            return hit.value;
+    }
+    return undefined;
+}
+/**
+ * Flatten an entire attribute payload to a `{ code: value }` map for a
+ * (locale, channel) — the client-side equivalent of the server's
+ * `resolvedAttributes`, for use on list responses where the server doesn't
+ * flatten. Codes with no matching value are omitted.
+ */
+export function flattenAttributes(attributes, opts = {}) {
+    const out = {};
+    for (const code of Object.keys(attributes)) {
+        const v = getAttribute(attributes, code, opts);
+        if (v !== undefined)
+            out[code] = v;
+    }
+    return out;
+}
+/** Narrow an attribute value to Money, or null if it isn't money-shaped. */
+export function asMoney(value) {
+    if (value &&
+        typeof value === 'object' &&
+        typeof value.amount_cents === 'number' &&
+        typeof value.currency === 'string') {
+        return value;
+    }
+    return null;
+}
+/** Narrow an attribute value to Measurement, or null if it isn't measurement-shaped. */
+export function asMeasurement(value) {
+    if (value &&
+        typeof value === 'object' &&
+        typeof value.amount === 'number' &&
+        typeof value.unit === 'string') {
+        return value;
+    }
+    return null;
+}
+/** Format integer-cents Money as a localized currency string. */
+export function formatMoney(money, locale = 'en-US') {
+    return new Intl.NumberFormat(locale, {
+        style: 'currency',
+        currency: money.currency,
+    }).format(money.amount_cents / 100);
+}
+//# sourceMappingURL=attributes.js.map

package/dist/attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.js","sourceRoot":"","sources":["../src/attributes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAyBH;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,UAA6B,EAC7B,IAAY,EACZ,OAAuB,EAAE;IAEzB,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;IACrC,MAAM,MAAM,GAA0C;QACpD,CAAC,MAAM,EAAE,OAAO,CAAC;QACjB,CAAC,MAAM,EAAE,IAAI,CAAC;QACd,CAAC,IAAI,EAAE,OAAO,CAAC;QACf,CAAC,IAAI,EAAE,IAAI,CAAC;KACb,CAAC;IACF,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC;QACnE,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC,KAAK,CAAC;IAC5B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAA6B,EAC7B,OAAuB,EAAE;IAEzB,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,YAAY,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,SAAS;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,IACE,KAAK;QACL,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAQ,KAAe,CAAC,YAAY,KAAK,QAAQ;QACjD,OAAQ,KAAe,CAAC,QAAQ,KAAK,QAAQ,EAC7C,CAAC;QACD,OAAO,KAAc,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IACE,KAAK;QACL,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAQ,KAAqB,CAAC,MAAM,KAAK,QAAQ;QACjD,OAAQ,KAAqB,CAAC,IAAI,KAAK,QAAQ,EAC/C,CAAC;QACD,OAAO,KAAoB,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,MAAM,GAAG,OAAO;IACxD,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE;QACnC,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC;AACtC,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Error envelope + type guard. Every MiniPim 4xx/5xx returns
+ * `{ error: { code, message, details? } }`. openapi-fetch types `res.error`
+ * as a union across a path's declared error responses, which is awkward to
+ * narrow to `.error.message`. This guard collapses that to a single shape.
+ */
+export interface MinipimError {
+    error: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}
+/** True when `value` is a MiniPim `{ error: { code, message } }` envelope. */
+export declare function isMinipimError(value: unknown): value is MinipimError;
+/**
+ * Pull a human-readable message out of an openapi-fetch `error` value,
+ * whatever its declared union shape. Falls back to `fallback`.
+ *
+ * @example
+ * ```ts
+ * const { data, error } = await pim.GET('/v1/products');
+ * if (error) throw new Error(getErrorMessage(error, 'request failed'));
+ * ```
+ */
+export declare function getErrorMessage(error: unknown, fallback?: string): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CASpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAmB,GAAG,MAAM,CAEnF"}

package/dist/errors.js

@@ -0,0 +1,30 @@
+/**
+ * Error envelope + type guard. Every MiniPim 4xx/5xx returns
+ * `{ error: { code, message, details? } }`. openapi-fetch types `res.error`
+ * as a union across a path's declared error responses, which is awkward to
+ * narrow to `.error.message`. This guard collapses that to a single shape.
+ */
+/** True when `value` is a MiniPim `{ error: { code, message } }` envelope. */
+export function isMinipimError(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const e = value.error;
+    return (!!e &&
+        typeof e === 'object' &&
+        typeof e.code === 'string' &&
+        typeof e.message === 'string');
+}
+/**
+ * Pull a human-readable message out of an openapi-fetch `error` value,
+ * whatever its declared union shape. Falls back to `fallback`.
+ *
+ * @example
+ * ```ts
+ * const { data, error } = await pim.GET('/v1/products');
+ * if (error) throw new Error(getErrorMessage(error, 'request failed'));
+ * ```
+ */
+export function getErrorMessage(error, fallback = 'request failed') {
+    return isMinipimError(error) ? error.error.message : fallback;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,8EAA8E;AAC9E,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAI,KAA6B,CAAC,KAAK,CAAC;IAC/C,OAAO,CACL,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,QAAQ;QACrB,OAAQ,CAAwB,CAAC,IAAI,KAAK,QAAQ;QAClD,OAAQ,CAA2B,CAAC,OAAO,KAAK,QAAQ,CACzD,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc,EAAE,QAAQ,GAAG,gBAAgB;IACzE,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;AAChE,CAAC"}

package/dist/index.d.ts

@@ -1,11 +1,17 @@
 /**
  * @minipim/sdk — typed TypeScript client for the MiniPim API.
  *
- * See https://github.com/Epic-Design-Labs/minipim/blob/main/packages/sdk/README.md
- * for examples; the canonical narrative integration guide lives at
- * https://github.com/Epic-Design-Labs/minipim/blob/main/docs/DEVELOPERS.md.
+ * Edge-safe: this entry point imports no `node:` modules. The Node webhook
+ * verifier lives at `@minipim/sdk/webhook` (imports node:crypto); the Edge
+ * verifier at `@minipim/sdk/webhook-edge`. Keeping them off the root means
+ * `createMinipimClient` can be imported in Edge runtimes without pulling
+ * node:crypto into the bundle.
+ *
+ * See packages/sdk/README.md for examples.
  */
 export { createMinipimClient, type CreateMinipimClientOptions, type MinipimClient, } from './client.js';
-export { verifyMinipimWebhook, verifyMinipimWebhookEdge, type VerifyWebhookOptions, } from './webhook.js';
+export { paginate, collectAll, type PaginateOptions, } from './paginate.js';
+export { isMinipimError, getErrorMessage, type MinipimError, } from './errors.js';
+export { getAttribute, flattenAttributes, asMoney, asMeasurement, formatMoney, type AttributeValueRecord, type AttributesPayload, type Money, type Measurement, type ResolveOptions, } from './attributes.js';
 export type { paths, components, operations } from './openapi.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;;;;;;GAMG;AACH,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,cAAc,CAAC;AAItB,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,QAAQ,EACR,UAAU,EACV,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,cAAc,EACd,eAAe,EACf,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,OAAO,EACP,aAAa,EACb,WAAW,EACX,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,KAAK,EACV,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AAOzB,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,10 +1,16 @@
 /**
  * @minipim/sdk — typed TypeScript client for the MiniPim API.
  *
- * See https://github.com/Epic-Design-Labs/minipim/blob/main/packages/sdk/README.md
- * for examples; the canonical narrative integration guide lives at
- * https://github.com/Epic-Design-Labs/minipim/blob/main/docs/DEVELOPERS.md.
+ * Edge-safe: this entry point imports no `node:` modules. The Node webhook
+ * verifier lives at `@minipim/sdk/webhook` (imports node:crypto); the Edge
+ * verifier at `@minipim/sdk/webhook-edge`. Keeping them off the root means
+ * `createMinipimClient` can be imported in Edge runtimes without pulling
+ * node:crypto into the bundle.
+ *
+ * See packages/sdk/README.md for examples.
  */
 export { createMinipimClient, } from './client.js';
-export { verifyMinipimWebhook, verifyMinipimWebhookEdge, } from './webhook.js';
+export { paginate, collectAll, } from './paginate.js';
+export { isMinipimError, getErrorMessage, } from './errors.js';
+export { getAttribute, flattenAttributes, asMoney, asMeasurement, formatMoney, } from './attributes.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,mBAAmB,GAGpB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,oBAAoB,EACpB,wBAAwB,GAEzB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,mBAAmB,GAGpB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,QAAQ,EACR,UAAU,GAEX,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,cAAc,EACd,eAAe,GAEhB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,OAAO,EACP,aAAa,EACb,WAAW,GAMZ,MAAM,iBAAiB,CAAC"}

package/dist/openapi.d.ts

@@ -3223,10 +3223,16 @@ export interface paths {
          *     To get a single category's full ancestor path, walk `parentId` upwards
          *     client-side, or hit `GET /v1/categories/{id}` which returns the same row
          *     shape with the resolved path included in `path`.
+         *
+         *     Returns the full tree by default. `?limit=` / `?offset=` are supported
+         *     for large taxonomies (ordered by `position`); omit them to get everything.
          */
         get: {
             parameters: {
-                query?: never;
+                query?: {
+                    limit?: number;
+                    offset?: number;
+                };
                 header?: never;
                 path?: never;
                 cookie?: never;