opacacms 0.2.0 → 0.3.0

package/dist/server/handlers.d.ts

@@ -1,5 +1,5 @@
 import type { Context } from "hono";
-import type { Collection, Global, OpacaConfig } from "../types";
+import type { Collection, Global, OpacaConfig, WebhookConfig } from "../types";
 /**
  * Hydrates a document with virtual fields and nested fields.
  * @param doc document to hydrate
@@ -20,12 +20,10 @@ export declare function parsePopulate(populate: string | any): Record<string, an
 export declare const populateDoc: (db: any, fields: any[], doc: any, populate: Record<string, any>, config: OpacaConfig) => Promise<any>;
 /**
  * Creates handlers for a collection
- * @param config opaca config
- * @param collection collection config
- * @param getAuth auth function
- * @returns collection handlers
+ * Creates a standard set of CRUD handlers for a given collection.
+ * These handlers manage database operations, access control, versioning, and webhooks.
  */
-export declare function createHandlers(config: OpacaConfig, collection: Collection, getAuth?: () => any): {
+export declare function createHandlers(collection: Collection, config: OpacaConfig): {
     find(c: Context): Promise<(Response & import("hono").TypedResponse<{
         message: string;
     }, 403, "json">) | (Response & import("hono").TypedResponse<{
@@ -40,6 +38,8 @@ export declare function createHandlers(config: OpacaConfig, collection: Collecti
         hasNextPage: boolean;
         prevPage: number | null;
         nextPage: number | null;
+        nextCursor?: string | null | undefined;
+        prevCursor?: string | null | undefined;
     }, import("hono/utils/http-status").ContentfulStatusCode, "json">)>;
     findOne(c: Context): Promise<Response & import("hono").TypedResponse<any, import("hono/utils/http-status").ContentfulStatusCode, "json">>;
     create(c: Context): Promise<(Response & import("hono").TypedResponse<{
@@ -60,7 +60,9 @@ export declare function createHandlers(config: OpacaConfig, collection: Collecti
     }, import("hono/utils/http-status").ContentfulStatusCode, "json">>;
     findVersions(c: Context): Promise<(Response & import("hono").TypedResponse<{
         message: string;
-    }, 403, "json">) | (Response & import("hono").TypedResponse<never, import("hono/utils/http-status").ContentfulStatusCode, "json">) | (Response & import("hono").TypedResponse<{
+    }, 403, "json">) | (Response & import("hono").TypedResponse<{
+        docs: any;
+    }, import("hono/utils/http-status").ContentfulStatusCode, "json">) | (Response & import("hono").TypedResponse<{
         message: string;
         error: any;
     }, 500, "json">)>;
@@ -73,6 +75,22 @@ export declare function createHandlers(config: OpacaConfig, collection: Collecti
         error: any;
     }, 500, "json">)>;
 };
+/**
+ * Creates a handler for an incoming webhook configuration.
+ * Manages signature verification, payload mapping, and automatic record upserts.
+ */
+export declare function createIncomingWebhookHandler(webhookConfig: Extract<WebhookConfig, {
+    type: "incoming";
+}>, collection: Collection, config: OpacaConfig): (c: Context) => Promise<(Response & import("hono").TypedResponse<{
+    message: string;
+}, 401, "json">) | (Response & import("hono").TypedResponse<{
+    success: true;
+    operation: "create" | "update";
+    id: any;
+}, import("hono/utils/http-status").ContentfulStatusCode, "json">) | (Response & import("hono").TypedResponse<{
+    message: string;
+    error: any;
+}, 500, "json">)>;
 /**
  * Creates handlers for global collections
  * @param config opaca config

package/dist/server/middlewares/auth.d.ts

@@ -1,6 +1,6 @@
-import type { Session, User } from "../../types";
 import type { MiddlewareHandler } from "hono";
 import type { Auth } from "../../auth";
+import type { Session, User } from "../../types";
 export type AuthContextVariables = {
     user: User | null;
     session: Session | null;

package/dist/server/plugins-loader.d.ts

@@ -1,6 +1,6 @@
 import type { OpacaConfig } from "@/types";
 /**
- * Loads all plugin settings from the `_opaca_plugin_settings` collection.
+ * Loads all plugin settings from the `_plugin_settings` collection.
  * Returns a Record where keys are plugin names and values are their configurations.
  */
 export declare function loadPluginSettings(config: OpacaConfig): Promise<Record<string, any>>;

package/dist/server/router.d.ts

@@ -1,7 +1,7 @@
 import { Hono } from "hono";
-import type { OpacaConfig } from "../types";
 import { type ApiContextVariables } from "../server/setup-middlewares";
+import type { OpacaConfig } from "../types";
 export type { ApiContextVariables } from "../server/setup-middlewares";
-export declare function createAPIRouter(config: OpacaConfig, settings?: Record<string, any>): Hono<{
+export declare function createAPIRouter(config: OpacaConfig, settings?: Record<string, any>, env?: any): Hono<{
     Variables: ApiContextVariables;
 }>;

package/dist/server/routers/admin.d.ts

@@ -1,7 +1,7 @@
 import { Hono } from "hono";
 import type { Auth } from "../../auth";
-import type { OpacaConfig } from "../../types";
 import type { ApiContextVariables } from "../../server/router";
+import type { OpacaConfig } from "../../types";
 export declare function createAdminRouter(config: OpacaConfig, settings: Record<string, any>, state: {
     auth: Auth | undefined;
 }): Hono<{

package/dist/server/routers/auth.d.ts

@@ -1,7 +1,7 @@
 import { Hono } from "hono";
 import type { Auth } from "../../auth";
-import type { OpacaConfig } from "../../types";
 import type { ApiContextVariables } from "../../server/router";
+import type { OpacaConfig } from "../../types";
 export declare function createAuthRouter(config: OpacaConfig, state: {
     auth: Auth | undefined;
 }): Hono<{

package/dist/server/routers/collections.d.ts

@@ -1,12 +1,15 @@
 import { Hono } from "hono";
 import type { Auth } from "../../auth";
-import type { OpacaConfig } from "../../types";
 import type { ApiContextVariables } from "../../server/router";
+import type { OpacaConfig } from "../../types";
 export declare function mountCollectionRoutes(router: Hono<{
     Variables: ApiContextVariables;
 }>, config: OpacaConfig, state: {
     auth: Auth | undefined;
 }): void;
+export declare function mountIncomingWebhookRoutes(router: Hono<{
+    Variables: ApiContextVariables;
+}>, config: OpacaConfig): void;
 export declare function mountGlobalRoutes(router: Hono<{
     Variables: ApiContextVariables;
 }>, config: OpacaConfig, state: {

package/dist/server/routers/plugins.d.ts

@@ -11,8 +11,8 @@ import type { ApiContextVariables } from "../setup-middlewares";
  */
 export declare function mountPluginRoutes(config: OpacaConfig, settings: Record<string, any>, logger: typeof import("../../utils/logger").logger, router: Hono<{
     Variables: ApiContextVariables;
-}>): void;
+}>, env?: any): void;
 /**
  * Fires the onInitComplete hook for all plugins.
  */
-export declare function firePluginInitComplete(config: OpacaConfig, settings: Record<string, any>, logger: typeof import("../../utils/logger").logger): void;
+export declare function firePluginInitComplete(config: OpacaConfig, settings: Record<string, any>, logger: typeof import("../../utils/logger").logger, env?: any): void;

package/dist/server/setup-middlewares.d.ts

@@ -1,8 +1,8 @@
 import type { Hono } from "hono";
 import type { Auth } from "../auth";
-import type { OpacaConfig } from "../types";
 import { type AuthContextVariables } from "../server/middlewares/auth";
 import { type OpacaContextVariables } from "../server/middlewares/context";
+import type { OpacaConfig } from "../types";
 export type ApiContextVariables = OpacaContextVariables & AuthContextVariables;
 export declare function setupMiddlewares(router: Hono<{
     Variables: ApiContextVariables;

package/dist/server/system-router.d.ts

@@ -1,6 +1,6 @@
 import { Hono } from "hono";
-import type { OpacaConfig } from "../types";
 import type { ApiContextVariables } from "../server/router";
+import type { OpacaConfig } from "../types";
 export declare function createSystemRouter(config: OpacaConfig): Hono<{
     Variables: ApiContextVariables;
 }, import("hono/types").BlankSchema, "/">;

package/dist/server.js

@@ -3,26 +3,31 @@ import {
   createAdminHandlers,
   createGlobalHandlers,
   createHandlers,
+  createIncomingWebhookHandler,
   hydrateDoc,
   parsePopulate,
   populateDoc
-} from "./chunk-kc4jfnv7.js";
+} from "./chunk-z3ffn2b7.js";
 import {
   defineConfig
-} from "./chunk-7y1nbmw6.js";
-import"./chunk-b3kr8w41.js";
+} from "./chunk-1bd7fz7n.js";
+import"./chunk-m24yqkeq.js";
+import"./chunk-5b8r0v8c.js";
+import"./chunk-m5ems3hh.js";
 import {
   BaseDatabaseAdapter
 } from "./chunk-s8mqwnm1.js";
+import"./chunk-q5sb5dcr.js";
 import"./chunk-qxt9vge8.js";
-import"./chunk-v9z61v3g.js";
-import"./chunk-t0zg026p.js";
-import"./chunk-8sqjbsgt.js";
+import"./chunk-jq1drsen.js";
+import"./chunk-6qs0g65f.js";
+import"./chunk-6bywt602.js";
 export {
   populateDoc,
   parsePopulate,
   hydrateDoc,
   defineConfig,
+  createIncomingWebhookHandler,
   createHandlers,
   createGlobalHandlers,
   createAdminHandlers,

package/dist/storage/adapters/cloudflare-r2.d.ts

@@ -1,6 +1,15 @@
-import type { R2Bucket } from "@cloudflare/workers-types";
 import type { StorageAdapter, StorageAdapterConfig } from "../types";
+/**
+ * A compatible interface for R2Bucket that avoids version mismatches
+ * between different @cloudflare/workers-types versions.
+ */
+export interface OpacaR2Bucket {
+    put(key: string, value: any, options?: any): Promise<any>;
+    get(key: string, options?: any): Promise<any>;
+    delete(key: string): Promise<any>;
+    head(key: string): Promise<any>;
+}
 export interface R2AdapterConfig extends StorageAdapterConfig {
-    bucketBinding: R2Bucket;
+    bucketBinding: OpacaR2Bucket;
 }
 export declare function createR2Storage(config: R2AdapterConfig): StorageAdapter;

package/dist/storage/index.js

@@ -1,6 +1,6 @@
 import {
   __require
-} from "../chunk-8sqjbsgt.js";
+} from "../chunk-6bywt602.js";
 
 // src/storage/errors.ts
 class StorageError extends Error {
@@ -146,8 +146,8 @@ function createLocalAdapter(config) {
         if (!fullPath.startsWith(path.resolve(config.uploadDir))) {
           throw new StorageError("local", "upload", "Path traversal attempt detected.");
         }
-        if (file.buffer && typeof Bun !== "undefined") {
-          await Bun.write(fullPath, file.buffer);
+        if (file.buffer && typeof globalThis.Bun !== "undefined") {
+          await globalThis.Bun.write(fullPath, file.buffer);
         } else if (file.buffer) {
           await fs.writeFile(fullPath, file.buffer);
         } else if (file.stream) {
@@ -201,8 +201,8 @@ function createLocalAdapter(config) {
     },
     async download(filename) {
       const fullPath = getFullPath(path.basename(filename));
-      if (typeof Bun !== "undefined") {
-        return Bun.file(fullPath).stream();
+      if (typeof globalThis.Bun !== "undefined") {
+        return globalThis.Bun.file(fullPath).stream();
       }
       const nodeStream = __require("node:fs").createReadStream(fullPath);
       return new ReadableStream({
@@ -219,21 +219,25 @@ function createLocalAdapter(config) {
   };
 }
 // src/storage/adapters/s3.ts
-import {
-  DeleteObjectCommand,
-  GetObjectCommand,
-  HeadObjectCommand,
-  PutObjectCommand,
-  S3Client
-} from "@aws-sdk/client-s3";
-import { getSignedUrl } from "@aws-sdk/s3-request-presigner";
 function createS3Adapter(config) {
-  const s3Client = new S3Client({
-    region: config.region,
-    endpoint: config.endpoint,
-    credentials: config.credentials,
-    forcePathStyle: config.forcePathStyle
-  });
+  let _s3Client = null;
+  let _sdk = null;
+  const getSdk = async () => {
+    if (_sdk)
+      return _sdk;
+    const [clientS3, presigner] = await Promise.all([
+      import("@aws-sdk/client-s3"),
+      import("@aws-sdk/s3-request-presigner")
+    ]);
+    _sdk = { ...clientS3, ...presigner };
+    _s3Client = new _sdk.S3Client({
+      region: config.region,
+      endpoint: config.endpoint,
+      credentials: config.credentials,
+      forcePathStyle: config.forcePathStyle
+    });
+    return _sdk;
+  };
   const getFullKey = (filename) => {
     if (config.prefix) {
       const p = config.prefix.replace(/\/$/, "");
@@ -252,6 +256,7 @@ function createS3Adapter(config) {
     name: "s3",
     async upload(file, options) {
       try {
+        const sdk = await getSdk();
         if (options?.allowedmime_types && !options.allowedmime_types.includes(file.mime_type)) {
           throw new Invalidmime_typeError("s3", options.allowedmime_types, file.mime_type);
         }
@@ -267,7 +272,7 @@ function createS3Adapter(config) {
         }
         const key = getFullKey(finalFilename);
         const body = file.buffer || file.stream;
-        const command = new PutObjectCommand({
+        const command = new sdk.PutObjectCommand({
           Bucket: config.bucket,
           Key: key,
           Body: body,
@@ -275,7 +280,7 @@ function createS3Adapter(config) {
           ContentLength: file.filesize,
           ACL: config.acl || "private"
         });
-        await s3Client.send(command);
+        await _s3Client.send(command);
         return {
           filename: finalFilename,
           mime_type: file.mime_type,
@@ -290,22 +295,24 @@ function createS3Adapter(config) {
     },
     async delete(filename) {
       try {
-        const command = new DeleteObjectCommand({
+        const sdk = await getSdk();
+        const command = new sdk.DeleteObjectCommand({
           Bucket: config.bucket,
           Key: getFullKey(filename)
         });
-        await s3Client.send(command);
+        await _s3Client.send(command);
       } catch (error) {
         throw new StorageError("s3", "delete", `Failed to delete ${filename} from S3 bucket ${config.bucket}`, error);
       }
     },
     async exists(filename) {
       try {
-        const command = new HeadObjectCommand({
+        const sdk = await getSdk();
+        const command = new sdk.HeadObjectCommand({
           Bucket: config.bucket,
           Key: getFullKey(filename)
         });
-        await s3Client.send(command);
+        await _s3Client.send(command);
         return true;
       } catch (error) {
         if (error.name === "NotFound" || error.$metadata?.httpStatusCode === 404)
@@ -315,24 +322,26 @@ function createS3Adapter(config) {
     },
     async generatePresignedUrl(filename, operation, expiresInSeconds = 3600) {
       try {
+        const sdk = await getSdk();
         let command;
         if (operation === "write") {
-          command = new PutObjectCommand({ Bucket: config.bucket, Key: getFullKey(filename) });
+          command = new sdk.PutObjectCommand({ Bucket: config.bucket, Key: getFullKey(filename) });
         } else {
-          command = new GetObjectCommand({ Bucket: config.bucket, Key: getFullKey(filename) });
+          command = new sdk.GetObjectCommand({ Bucket: config.bucket, Key: getFullKey(filename) });
         }
-        return await getSignedUrl(s3Client, command, { expiresIn: expiresInSeconds });
+        return await sdk.getSignedUrl(_s3Client, command, { expiresIn: expiresInSeconds });
       } catch (error) {
         throw new StorageError("s3", "presign", `Failed to generate presigned URL for ${filename}`, error);
       }
     },
     async download(filename) {
       try {
-        const command = new GetObjectCommand({
+        const sdk = await getSdk();
+        const command = new sdk.GetObjectCommand({
           Bucket: config.bucket,
           Key: getFullKey(filename)
         });
-        const response = await s3Client.send(command);
+        const response = await _s3Client.send(command);
         if (!response.Body) {
           throw new StorageError("s3", "download", `File not found: ${filename}`);
         }