@01.software/sdk 0.1.8 → 0.1.9

package/dist/index.d.cts

@@ -6,6 +6,8 @@ import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
 import { P as PublicCollection, C as CollectionType } from './webhook-E1YlE_k1.cjs';
 export { b as COLLECTIONS, a as Collection, c as WebhookEvent, d as WebhookHandler, W as WebhookOperation, e as WebhookOptions, f as createTypedWebhookHandler, h as handleWebhook, i as isValidWebhookEvent } from './webhook-E1YlE_k1.cjs';
+import { Metadata } from 'next';
+import { GenerateMetadataOptions } from './metadata.cjs';
 export { RichTextContent, RichTextContentProps, RichTextData } from './components.cjs';
 import 'payload';
 import 'react';
@@ -251,7 +253,7 @@ declare class CollectionClient extends HttpClient {
  * Read-only subset of CollectionQueryBuilder.
  * BrowserClient.from() returns this type to prevent write operations at compile time.
  */
-type ReadOnlyQueryBuilder<T extends PublicCollection> = Pick<CollectionQueryBuilder<T>, 'find' | 'findById' | 'count'>;
+type ReadOnlyQueryBuilder<T extends PublicCollection> = Pick<CollectionQueryBuilder<T>, 'find' | 'findById' | 'count' | 'findMetadata' | 'findMetadataById'>;
 declare class CollectionQueryBuilder<T extends PublicCollection> {
     private api;
     private collection;
@@ -288,6 +290,18 @@ declare class CollectionQueryBuilder<T extends PublicCollection> {
     count(options?: ApiQueryOptions): Promise<{
         totalDocs: number;
     }>;
+    /**
+     * 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?: ApiQueryOptions, metadataOptions?: GenerateMetadataOptions): Promise<Metadata | null>;
+    /**
+     * Find document by ID and return its Next.js Metadata.
+     * Applies depth: 1 (image populate) automatically.
+     * @returns Metadata (throws on 404)
+     */
+    findMetadataById(id: number | string, metadataOptions?: GenerateMetadataOptions): Promise<Metadata>;
     /**
      * Update multiple documents (bulk update)
      * PATCH /api/{collection}

package/dist/index.d.ts

@@ -6,6 +6,8 @@ import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
 import { P as PublicCollection, C as CollectionType } from './webhook-xdgxEN8s.js';
 export { b as COLLECTIONS, a as Collection, c as WebhookEvent, d as WebhookHandler, W as WebhookOperation, e as WebhookOptions, f as createTypedWebhookHandler, h as handleWebhook, i as isValidWebhookEvent } from './webhook-xdgxEN8s.js';
+import { Metadata } from 'next';
+import { GenerateMetadataOptions } from './metadata.js';
 export { RichTextContent, RichTextContentProps, RichTextData } from './components.js';
 import 'payload';
 import 'react';
@@ -251,7 +253,7 @@ declare class CollectionClient extends HttpClient {
  * Read-only subset of CollectionQueryBuilder.
  * BrowserClient.from() returns this type to prevent write operations at compile time.
  */
-type ReadOnlyQueryBuilder<T extends PublicCollection> = Pick<CollectionQueryBuilder<T>, 'find' | 'findById' | 'count'>;
+type ReadOnlyQueryBuilder<T extends PublicCollection> = Pick<CollectionQueryBuilder<T>, 'find' | 'findById' | 'count' | 'findMetadata' | 'findMetadataById'>;
 declare class CollectionQueryBuilder<T extends PublicCollection> {
     private api;
     private collection;
@@ -288,6 +290,18 @@ declare class CollectionQueryBuilder<T extends PublicCollection> {
     count(options?: ApiQueryOptions): Promise<{
         totalDocs: number;
     }>;
+    /**
+     * 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?: ApiQueryOptions, metadataOptions?: GenerateMetadataOptions): Promise<Metadata | null>;
+    /**
+     * Find document by ID and return its Next.js Metadata.
+     * Applies depth: 1 (image populate) automatically.
+     * @returns Metadata (throws on 404)
+     */
+    findMetadataById(id: number | string, metadataOptions?: GenerateMetadataOptions): Promise<Metadata>;
     /**
      * Update multiple documents (bulk update)
      * PATCH /api/{collection}

package/dist/index.js

@@ -631,6 +631,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) {
@@ -702,6 +733,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}
@@ -1710,11 +1771,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);
@@ -1724,6 +1780,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)) {
@@ -1767,13 +1827,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;