@01.software/sdk 0.1.8 → 0.1.9

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,

package/dist/index.cjs

@@ -704,6 +704,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 +806,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}
@@ -1777,11 +1838,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 +1847,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)) {
@@ -1834,13 +1894,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;