@minipim/sdk 0.2.0 → 0.3.1

package/dist/openapi.d.ts

@@ -2,7 +2,7 @@
  * This file was auto-generated by openapi-typescript.
  * Do not make direct changes to the file.
  */
-export interface paths {
+interface paths {
     "/healthz": {
         parameters: {
             query?: never;
@@ -29,6 +29,7 @@ export interface paths {
                         "application/json": {
                             status: string;
                             service: string;
+                            version: string;
                         };
                     };
                 };
@@ -80,6 +81,57 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/changelog": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Release changelog
+         * @description Structured release notes, newest first. The `version` of the first entry is the deployed version (also reported by /healthz).
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            version: string;
+                            entries: {
+                                version: string;
+                                date: string;
+                                title: string;
+                                highlights: {
+                                    /** @enum {string} */
+                                    type: "feature" | "fix" | "perf" | "docs";
+                                    text: string;
+                                }[];
+                            }[];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/organizations": {
         parameters: {
             query?: never;
@@ -1174,9 +1226,10 @@ export interface paths {
                     familyId?: string;
                     categoryId?: string;
                     brand?: string;
+                    tag?: string | string[];
                     connectorId?: string;
                     updatedSince?: string;
-                    sortBy?: "name" | "slug" | "status" | "updatedAt" | "createdAt";
+                    sortBy?: "name" | "slug" | "status" | "updatedAt" | "createdAt" | "relevance";
                     sortDir?: "asc" | "desc";
                     limit?: number;
                     offset?: number;
@@ -1215,6 +1268,7 @@ export interface paths {
                                 attributes: (string | number | boolean | ("null" | null)) | unknown[] | {
                                     [key: string]: unknown;
                                 };
+                                tags: string[];
                                 /** Format: uuid */
                                 createdBy: string | null;
                                 /** Format: uuid */
@@ -1263,6 +1317,8 @@ export interface paths {
                                 value?: unknown;
                             }[];
                         };
+                        /** @default [] */
+                        tags?: string[];
                     };
                 };
             };
@@ -1291,6 +1347,7 @@ export interface paths {
                             attributes: (string | number | boolean | ("null" | null)) | unknown[] | {
                                 [key: string]: unknown;
                             };
+                            tags: string[];
                             /** Format: uuid */
                             createdBy: string | null;
                             /** Format: uuid */
@@ -1340,9 +1397,10 @@ export interface paths {
                     familyId?: string;
                     categoryId?: string;
                     brand?: string;
+                    tag?: string | string[];
                     connectorId?: string;
                     updatedSince?: string;
-                    sortBy?: "name" | "slug" | "status" | "updatedAt" | "createdAt";
+                    sortBy?: "name" | "slug" | "status" | "updatedAt" | "createdAt" | "relevance";
                     sortDir?: "asc" | "desc";
                     locale?: string;
                     channel?: string;
@@ -1383,6 +1441,10 @@ export interface paths {
                                 value: string;
                                 count: number;
                             }[];
+                            tags: {
+                                value: string;
+                                count: number;
+                            }[];
                             connectors: {
                                 /** Format: uuid */
                                 connectorId: string;
@@ -1403,6 +1465,48 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/products/tags": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List all product tags in use, with counts
+         * @description Every distinct tag currently on at least one product, ordered by usage. Tags are free-form, normalized to lowercase slugs on write (`Featured` → `featured`). Filter products by tag with `GET /v1/products?tag=<tag>` (repeatable; multiple tags AND together).
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            value: string;
+                            count: number;
+                        }[];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/products/{id}": {
         parameters: {
             query?: never;
@@ -1499,6 +1603,7 @@ export interface paths {
                             attributes: (string | number | boolean | ("null" | null)) | unknown[] | {
                                 [key: string]: unknown;
                             };
+                            tags: string[];
                             /** Format: uuid */
                             createdBy: string | null;
                             /** Format: uuid */
@@ -1619,6 +1724,7 @@ export interface paths {
                                 value?: unknown;
                             }[];
                         };
+                        tags?: string[];
                     };
                 };
             };
@@ -1647,6 +1753,7 @@ export interface paths {
                             attributes: (string | number | boolean | ("null" | null)) | unknown[] | {
                                 [key: string]: unknown;
                             };
+                            tags: string[];
                             /** Format: uuid */
                             createdBy: string | null;
                             /** Format: uuid */
@@ -1725,6 +1832,9 @@ export interface paths {
                                 missing: {
                                     code: string;
                                     locale: string | null;
+                                    label?: string;
+                                    variantsMissing?: number;
+                                    variantsTotal?: number;
                                 }[];
                             }[];
                         };
@@ -2089,6 +2199,61 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/products/bulk-set-tags": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Bulk-modify tags across products
+         * @description `mode=add` unions the listed tags into each product, `mode=remove` strips them, `mode=replace` overwrites the full list. Tags are normalized (slugified + deduped) exactly like single-product writes.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        productIds: string[];
+                        /** @enum {string} */
+                        mode: "add" | "remove" | "replace";
+                        tags: string[];
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            results: {
+                                /** Format: uuid */
+                                productId: string;
+                                ok: boolean;
+                                error?: string;
+                            }[];
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/products/{id}/variants": {
         parameters: {
             query?: never;
@@ -2139,6 +2304,36 @@ export interface paths {
                         }[];
                     };
                 };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                code: string;
+                                message: string;
+                                details?: unknown;
+                            };
+                        };
+                    };
+                };
+                /** @description Default Response */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                code: string;
+                                message: string;
+                                details?: unknown;
+                            };
+                        };
+                    };
+                };
             };
         };
         put?: never;
@@ -5854,7 +6049,7 @@ export interface paths {
         put?: never;
         /**
          * Trigger a sync (pull / push / both)
-         * @description Synchronous in v1 — runs in-request and returns after completion. Larger syncs will move to a background worker; the call site stays the same (returns a sync record id immediately, status fills in async).
+         * @description Asynchronous: returns the sync record immediately with status `running`; the work continues in the background. Poll `GET /v1/connectors/{id}/syncs` for the terminal status (`completed`/`partial`/`failed`) and stats. Pulls download media binaries and routinely take minutes — running in-request exceeded proxy timeouts, which severed responses mid-sync and invited retry double-pulls. Caveat: a server restart mid-sync leaves the row `running` forever; a BullMQ worker will make this durable later.
          */
         post: {
             parameters: {
@@ -6365,6 +6560,146 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/connectors/{id}/deliveries": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Recent outbound webhook deliveries for a connector
+         * @description Last 50 delivery attempts (event name, HTTP status, ok, error) for push connectors that POST events to a destination (e.g. headless). Answers "did any events actually arrive?" without grepping receiver logs.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** Format: uuid */
+                            id: string;
+                            eventName: string;
+                            status: number | null;
+                            ok: boolean;
+                            error: string | null;
+                            /** Format: date-time */
+                            createdAt: string;
+                        }[];
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                code: string;
+                                message: string;
+                                details?: unknown;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/connectors/{id}/webhooks/test": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Send a signed test event to the connector destination
+         * @description Delivers a synthetic `webhook.test` event (HMAC-signed like any real delivery) so integrators can verify endpoint wiring without mutating catalog data. Returns the delivery outcome and logs it like any other.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            ok: boolean;
+                            status: number | null;
+                            error?: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                code: string;
+                                message: string;
+                                details?: unknown;
+                            };
+                        };
+                    };
+                };
+                /** @description Default Response */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                code: string;
+                                message: string;
+                                details?: unknown;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/connectors/{id}/webhooks/enable": {
         parameters: {
             query?: never;
@@ -6854,8 +7189,8 @@ export interface paths {
         trace?: never;
     };
 }
-export type webhooks = Record<string, never>;
-export interface components {
+type webhooks = Record<string, never>;
+interface components {
     schemas: never;
     responses: never;
     parameters: never;
@@ -6863,6 +7198,7 @@ export interface components {
     headers: never;
     pathItems: never;
 }
-export type $defs = Record<string, never>;
-export type operations = Record<string, never>;
-//# sourceMappingURL=openapi.d.ts.map
+type $defs = Record<string, never>;
+type operations = Record<string, never>;
+
+export type { $defs, components, operations, paths, webhooks };

package/dist/openapi.js

@@ -1,6 +0,0 @@
-/**
- * This file was auto-generated by openapi-typescript.
- * Do not make direct changes to the file.
- */
-export {};
-//# sourceMappingURL=openapi.js.map

package/dist/webhook-edge.cjs

@@ -0,0 +1,68 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/webhook-edge.ts
+var webhook_edge_exports = {};
+__export(webhook_edge_exports, {
+  verifyMinipimWebhookEdge: () => verifyMinipimWebhookEdge
+});
+module.exports = __toCommonJS(webhook_edge_exports);
+
+// src/webhook-shared.ts
+function decodeHex(s) {
+  if (s.length % 2 !== 0) return new Uint8Array(0);
+  const out = new Uint8Array(s.length / 2);
+  for (let i = 0; i < out.length; i++) {
+    const byte = parseInt(s.slice(i * 2, i * 2 + 2), 16);
+    if (Number.isNaN(byte)) return new Uint8Array(0);
+    out[i] = byte;
+  }
+  return out;
+}
+function stripPrefix(sig) {
+  return sig.startsWith("sha256=") ? sig.slice(7) : sig;
+}
+function timingSafeEqualBytes(a, b) {
+  if (a.length !== b.length) return false;
+  let diff = 0;
+  for (let i = 0; i < a.length; i++) diff |= (a[i] ?? 0) ^ (b[i] ?? 0);
+  return diff === 0;
+}
+
+// src/webhook-edge.ts
+async function verifyMinipimWebhookEdge(opts) {
+  const enc = new TextEncoder();
+  const keyData = enc.encode(opts.secret);
+  const bodyData = typeof opts.rawBody === "string" ? enc.encode(opts.rawBody) : new Uint8Array(opts.rawBody);
+  const key = await crypto.subtle.importKey(
+    "raw",
+    keyData,
+    { name: "HMAC", hash: "SHA-256" },
+    false,
+    ["sign"]
+  );
+  const sigBuf = await crypto.subtle.sign("HMAC", key, bodyData);
+  const expected = new Uint8Array(sigBuf);
+  const got = decodeHex(stripPrefix(opts.signature));
+  return timingSafeEqualBytes(expected, got);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  verifyMinipimWebhookEdge
+});

package/dist/webhook-edge.d.cts

@@ -0,0 +1,26 @@
+import { V as VerifyWebhookOptions } from './webhook-shared-CjMkFYVb.cjs';
+
+/**
+ * Edge / browser webhook signature verification, via WebCrypto. Use in
+ * Cloudflare Workers, Vercel Edge Runtime, Deno, or browsers. Async because
+ * `crypto.subtle` is async. For Node use `@minipim/sdk/webhook` (synchronous).
+ *
+ * This entry point imports no `node:` modules, so it's safe in any Edge
+ * bundle.
+ */
+
+/**
+ * Verify a MiniPim webhook signature in an Edge/WebCrypto runtime. Same
+ * contract as the Node `verifyMinipimWebhook` but async.
+ *
+ * @example
+ * ```ts
+ * import { verifyMinipimWebhookEdge } from '@minipim/sdk/webhook-edge';
+ *
+ * const ok = await verifyMinipimWebhookEdge({ rawBody, signature, secret });
+ * if (!ok) return new Response('invalid signature', { status: 401 });
+ * ```
+ */
+declare function verifyMinipimWebhookEdge(opts: VerifyWebhookOptions): Promise<boolean>;
+
+export { VerifyWebhookOptions, verifyMinipimWebhookEdge };

package/dist/webhook-edge.d.ts

@@ -1,3 +1,5 @@
+import { V as VerifyWebhookOptions } from './webhook-shared-CjMkFYVb.js';
+
 /**
  * Edge / browser webhook signature verification, via WebCrypto. Use in
  * Cloudflare Workers, Vercel Edge Runtime, Deno, or browsers. Async because
@@ -6,8 +8,7 @@
  * This entry point imports no `node:` modules, so it's safe in any Edge
  * bundle.
  */
-import { type VerifyWebhookOptions } from './webhook-shared.js';
-export type { VerifyWebhookOptions } from './webhook-shared.js';
+
 /**
  * Verify a MiniPim webhook signature in an Edge/WebCrypto runtime. Same
  * contract as the Node `verifyMinipimWebhook` but async.
@@ -20,5 +21,6 @@ export type { VerifyWebhookOptions } from './webhook-shared.js';
  * if (!ok) return new Response('invalid signature', { status: 401 });
  * ```
  */
-export declare function verifyMinipimWebhookEdge(opts: VerifyWebhookOptions): Promise<boolean>;
-//# sourceMappingURL=webhook-edge.d.ts.map
+declare function verifyMinipimWebhookEdge(opts: VerifyWebhookOptions): Promise<boolean>;
+
+export { VerifyWebhookOptions, verifyMinipimWebhookEdge };

package/dist/webhook-edge.js

@@ -1,32 +1,41 @@
-/**
- * Edge / browser webhook signature verification, via WebCrypto. Use in
- * Cloudflare Workers, Vercel Edge Runtime, Deno, or browsers. Async because
- * `crypto.subtle` is async. For Node use `@minipim/sdk/webhook` (synchronous).
- *
- * This entry point imports no `node:` modules, so it's safe in any Edge
- * bundle.
- */
-import { decodeHex, stripPrefix, timingSafeEqualBytes, } from './webhook-shared.js';
-/**
- * Verify a MiniPim webhook signature in an Edge/WebCrypto runtime. Same
- * contract as the Node `verifyMinipimWebhook` but async.
- *
- * @example
- * ```ts
- * import { verifyMinipimWebhookEdge } from '@minipim/sdk/webhook-edge';
- *
- * const ok = await verifyMinipimWebhookEdge({ rawBody, signature, secret });
- * if (!ok) return new Response('invalid signature', { status: 401 });
- * ```
- */
-export async function verifyMinipimWebhookEdge(opts) {
-    const enc = new TextEncoder();
-    const keyData = enc.encode(opts.secret);
-    const bodyData = typeof opts.rawBody === 'string' ? enc.encode(opts.rawBody) : new Uint8Array(opts.rawBody);
-    const key = await crypto.subtle.importKey('raw', keyData, { name: 'HMAC', hash: 'SHA-256' }, false, ['sign']);
-    const sigBuf = await crypto.subtle.sign('HMAC', key, bodyData);
-    const expected = new Uint8Array(sigBuf);
-    const got = decodeHex(stripPrefix(opts.signature));
-    return timingSafeEqualBytes(expected, got);
+// src/webhook-shared.ts
+function decodeHex(s) {
+  if (s.length % 2 !== 0) return new Uint8Array(0);
+  const out = new Uint8Array(s.length / 2);
+  for (let i = 0; i < out.length; i++) {
+    const byte = parseInt(s.slice(i * 2, i * 2 + 2), 16);
+    if (Number.isNaN(byte)) return new Uint8Array(0);
+    out[i] = byte;
+  }
+  return out;
 }
-//# sourceMappingURL=webhook-edge.js.map
+function stripPrefix(sig) {
+  return sig.startsWith("sha256=") ? sig.slice(7) : sig;
+}
+function timingSafeEqualBytes(a, b) {
+  if (a.length !== b.length) return false;
+  let diff = 0;
+  for (let i = 0; i < a.length; i++) diff |= (a[i] ?? 0) ^ (b[i] ?? 0);
+  return diff === 0;
+}
+
+// src/webhook-edge.ts
+async function verifyMinipimWebhookEdge(opts) {
+  const enc = new TextEncoder();
+  const keyData = enc.encode(opts.secret);
+  const bodyData = typeof opts.rawBody === "string" ? enc.encode(opts.rawBody) : new Uint8Array(opts.rawBody);
+  const key = await crypto.subtle.importKey(
+    "raw",
+    keyData,
+    { name: "HMAC", hash: "SHA-256" },
+    false,
+    ["sign"]
+  );
+  const sigBuf = await crypto.subtle.sign("HMAC", key, bodyData);
+  const expected = new Uint8Array(sigBuf);
+  const got = decodeHex(stripPrefix(opts.signature));
+  return timingSafeEqualBytes(expected, got);
+}
+export {
+  verifyMinipimWebhookEdge
+};