@01.software/sdk 0.1.8 → 0.2.0

package/README.md

@@ -108,7 +108,7 @@ const client = createBrowserClient({
 
 Access collections via `client.from(collection)` method.
 
-> **Note:** `BrowserClient.from()` returns a `ReadOnlyQueryBuilder` (only `find`, `findById`, `count`). Write operations (`create`, `update`, `remove`, `updateMany`, `removeMany`) are only available on `ServerClient.from()`.
+> **Note:** `BrowserClient.from()` returns a `ReadOnlyQueryBuilder` (only `find`, `findById`, `count`, `findMetadata`, `findMetadataById`). Write operations (`create`, `update`, `remove`, `updateMany`, `removeMany`) are only available on `ServerClient.from()`.
 
 ```typescript
 // List query - returns PayloadFindResponse
@@ -136,6 +136,16 @@ const deletedDoc = await client.from('products').remove('id')
 // Count
 const { totalDocs } = await client.from('products').count()
 
+// SEO Metadata (fetch + generate in one call, depth: 1 auto-applied)
+const metadata = await client.from('products').findMetadata(
+  { where: { slug: { equals: 'my-product' } } },
+  { siteName: 'My Store' },
+)
+
+const metadataById = await client.from('products').findMetadataById('id', {
+  siteName: 'My Store',
+})
+
 // Bulk operations (server only)
 await client.from('products').updateMany(where, data)
 await client.from('products').removeMany(where)
@@ -178,6 +188,8 @@ interface PayloadMutationResponse<T> {
 | `update()` | `PayloadMutationResponse<T>` - `{ doc, message }` |
 | `remove()` | `T` - deleted document object directly |
 | `count()` | `{ totalDocs: number }` |
+| `findMetadata()` | `Metadata \| null` - Next.js Metadata (null if no match) |
+| `findMetadataById()` | `Metadata` - Next.js Metadata (throws on 404) |
 
 ### React Query Hooks
 
@@ -334,7 +346,7 @@ export async function POST(request: Request) {
   })
 }
 
-// With signature verification
+// With HMAC-SHA256 signature verification (recommended)
 export async function POST(request: Request) {
   return handleWebhook(request, handler, {
     secret: process.env.WEBHOOK_SECRET,
@@ -359,7 +371,7 @@ const handler = createTypedWebhookHandler('orders', async (event) => {
 | Carts    | `carts`, `cart-items`                                                                                                              |
 | Commerce | `discounts`, `shipping-policies`                                                                                                   |
 | Content  | `posts`, `post-categories`, `post-tags`, `post-images`, `documents`, `document-categories`, `document-images`                      |
-| Media    | `playlists`, `playlist-images`, `musics`, `galleries`, `gallery-images`, `media`                                                   |
+| Media    | `playlists`, `playlist-images`, `musics`, `media`                                                                                  |
 | Forms    | `forms`, `form-submissions`                                                                                                        |
 
 ## Utilities

package/dist/{auth-Cxfq94pG.d.ts → auth-BC0CWHt_.d.ts}

@@ -1,5 +1,5 @@
 import { Sort, Where } from 'payload';
-import './payload-types-DcOQUD4x.js';
+import './payload-types-BWJZhklJ.js';
 
 declare class SDKError extends Error {
     readonly code: string;

package/dist/{auth-BnCTXZG0.d.cts → auth-BE80zCjC.d.cts}

@@ -1,5 +1,5 @@
 import { Sort, Where } from 'payload';
-import './payload-types-DcOQUD4x.cjs';
+import './payload-types-BWJZhklJ.cjs';
 
 declare class SDKError extends Error {
     readonly code: string;

package/dist/auth.d.cts

@@ -1,3 +1,3 @@
-export { J as JwtPayload, q as createApiKey, o as createServerToken, p as decodeServerToken, r as parseApiKey, v as verifyServerToken } from './auth-BnCTXZG0.cjs';
+export { J as JwtPayload, q as createApiKey, o as createServerToken, p as decodeServerToken, r as parseApiKey, v as verifyServerToken } from './auth-BE80zCjC.cjs';
 import 'payload';
-import './payload-types-DcOQUD4x.cjs';
+import './payload-types-BWJZhklJ.cjs';

package/dist/auth.d.ts

@@ -1,3 +1,3 @@
-export { J as JwtPayload, q as createApiKey, o as createServerToken, p as decodeServerToken, r as parseApiKey, v as verifyServerToken } from './auth-Cxfq94pG.js';
+export { J as JwtPayload, q as createApiKey, o as createServerToken, p as decodeServerToken, r as parseApiKey, v as verifyServerToken } from './auth-BC0CWHt_.js';
 import 'payload';
-import './payload-types-DcOQUD4x.js';
+import './payload-types-BWJZhklJ.js';

package/dist/index.cjs

@@ -88,6 +88,7 @@ __export(src_exports, {
   CollectionQueryBuilder: () => CollectionQueryBuilder,
   ConfigError: () => ConfigError,
   CustomerAuth: () => CustomerAuth,
+  IMAGE_SIZES: () => IMAGE_SIZES,
   NetworkError: () => NetworkError,
   OrderApi: () => OrderApi,
   ProductApi: () => ProductApi,
@@ -107,6 +108,8 @@ __export(src_exports, {
   decodeServerToken: () => decodeServerToken,
   formatOrderName: () => formatOrderName,
   generateOrderNumber: () => generateOrderNumber,
+  getImageSrcSet: () => getImageSrcSet,
+  getImageUrl: () => getImageUrl,
   getQueryClient: () => getQueryClient,
   handleWebhook: () => handleWebhook,
   isApiError: () => isApiError,
@@ -704,6 +707,37 @@ var ProductApi = class {
   }
 };
 
+// src/utils/types.ts
+var resolveRelation = (ref) => {
+  if (typeof ref === "number" || ref === null || ref === void 0) return null;
+  return ref;
+};
+var objectFor = resolveRelation;
+
+// src/core/metadata/index.ts
+function generateMetadata(doc, options) {
+  var _a, _b, _c, _d;
+  const meta = doc == null ? void 0 : doc.meta;
+  const title = (_b = (_a = meta == null ? void 0 : meta.title) != null ? _a : options == null ? void 0 : options.title) != null ? _b : void 0;
+  const description = (_d = (_c = meta == null ? void 0 : meta.description) != null ? _c : options == null ? void 0 : options.description) != null ? _d : void 0;
+  const image = resolveMetaImage(meta == null ? void 0 : meta.image);
+  return {
+    title,
+    description,
+    openGraph: __spreadValues(__spreadValues(__spreadValues(__spreadValues({}, title && { title }), description && { description }), (options == null ? void 0 : options.siteName) && { siteName: options.siteName }), image && { images: [image] }),
+    twitter: __spreadValues(__spreadValues(__spreadValues({
+      card: image ? "summary_large_image" : "summary"
+    }, title && { title }), description && { description }), image && { images: [image.url] })
+  };
+}
+function resolveMetaImage(ref) {
+  const media = resolveRelation(ref);
+  if (!(media == null ? void 0 : media.url)) return null;
+  return __spreadValues(__spreadValues(__spreadValues({
+    url: media.url
+  }, media.width && { width: media.width }), media.height && { height: media.height }), media.alt && { alt: media.alt });
+}
+
 // src/core/collection/query-builder.ts
 var CollectionQueryBuilder = class {
   constructor(api, collection) {
@@ -775,6 +809,36 @@ var CollectionQueryBuilder = class {
       );
     });
   }
+  /**
+   * Find first matching document and return its Next.js Metadata.
+   * Applies depth: 1 (image populate) and limit: 1 automatically.
+   * @returns Metadata or null if no document matches
+   */
+  findMetadata(options, metadataOptions) {
+    return __async(this, null, function* () {
+      const { docs } = yield this.find(__spreadProps(__spreadValues({}, options), { limit: 1, depth: 1 }));
+      const doc = docs[0];
+      if (!doc) return null;
+      return generateMetadata(
+        doc,
+        metadataOptions
+      );
+    });
+  }
+  /**
+   * Find document by ID and return its Next.js Metadata.
+   * Applies depth: 1 (image populate) automatically.
+   * @returns Metadata (throws on 404)
+   */
+  findMetadataById(id, metadataOptions) {
+    return __async(this, null, function* () {
+      const doc = yield this.findById(id, { depth: 1 });
+      return generateMetadata(
+        doc,
+        metadataOptions
+      );
+    });
+  }
   /**
    * Update multiple documents (bulk update)
    * PATCH /api/{collection}
@@ -1050,6 +1114,7 @@ var COLLECTIONS = [
   "product-categories",
   "product-tags",
   "product-images",
+  "product-collections",
   "brands",
   "brand-logos",
   "orders",
@@ -1079,8 +1144,6 @@ var COLLECTIONS = [
   "playlists",
   "playlist-images",
   "musics",
-  "galleries",
-  "gallery-images",
   "forms",
   "form-submissions",
   "media"
@@ -1777,11 +1840,6 @@ function handleWebhook(request, handler, options) {
   return __async(this, null, function* () {
     try {
       const rawBody = yield request.text();
-      if (!(options == null ? void 0 : options.secret)) {
-        console.warn(
-          "[@01.software/sdk] Webhook signature verification is skipped because no secret was provided. Pass { secret } to handleWebhook() to enable signature verification."
-        );
-      }
       if (options == null ? void 0 : options.secret) {
         const signature = request.headers.get("x-webhook-signature") || "";
         const valid = yield verifySignature(rawBody, options.secret, signature);
@@ -1791,6 +1849,10 @@ function handleWebhook(request, handler, options) {
             { status: 401, headers: { "Content-Type": "application/json" } }
           );
         }
+      } else {
+        console.warn(
+          "[@01.software/sdk] Webhook signature verification is disabled. Set { secret } in handleWebhook() options to enable HMAC-SHA256 verification."
+        );
       }
       const body = JSON.parse(rawBody);
       if (!isValidWebhookEvent(body)) {
@@ -1822,6 +1884,39 @@ function createTypedWebhookHandler(collection, handler) {
   });
 }
 
+// src/utils/image.ts
+var IMAGE_SIZES = [384, 768, 1536];
+function getImageUrl(image, displayWidth, dpr = 1) {
+  var _a;
+  const target = displayWidth * dpr;
+  const sizes = image.sizes;
+  if (sizes) {
+    for (const size of IMAGE_SIZES) {
+      if (size >= target) {
+        const entry = sizes[String(size)];
+        if (entry == null ? void 0 : entry.url) return entry.url;
+      }
+    }
+  }
+  return (_a = image.url) != null ? _a : "";
+}
+function getImageSrcSet(image) {
+  const parts = [];
+  const sizes = image.sizes;
+  if (sizes) {
+    for (const size of IMAGE_SIZES) {
+      const entry = sizes[String(size)];
+      if ((entry == null ? void 0 : entry.url) && entry.width) {
+        parts.push(`${entry.url} ${entry.width}w`);
+      }
+    }
+  }
+  if (image.url && image.width) {
+    parts.push(`${image.url} ${image.width}w`);
+  }
+  return parts.join(", ");
+}
+
 // src/utils/order/generateOrderNumber.ts
 var generateOrderNumber = () => {
   var _a;
@@ -1834,13 +1929,6 @@ var generateOrderNumber = () => {
   return `${year}${month}${day}${random}`;
 };
 
-// src/utils/types.ts
-var resolveRelation = (ref) => {
-  if (typeof ref === "number" || ref === null || ref === void 0) return null;
-  return ref;
-};
-var objectFor = resolveRelation;
-
 // src/utils/order/formatOrderName.ts
 var formatOrderName = (options) => {
   var _a, _b;