opacacms 0.2.1 → 0.3.1

package/dist/db/kysely/plugins/tree-resolver.d.ts

@@ -0,0 +1,39 @@
+import type { KyselyPlugin, PluginTransformQueryArgs, PluginTransformResultArgs, QueryResult, RootOperationNode } from "kysely";
+/**
+ * Configuration for the TreeResolverPlugin.
+ */
+export interface TreeResolverPluginConfig {
+    /** The column used to identify the parent (e.g. 'parent_id'). */
+    parentColumn?: string;
+    /** The children property name in the resulting JSON (e.g. 'children'). */
+    childrenProperty?: string;
+}
+/**
+ * Kysely plugin for handling hierarchical data structures (Adjacency List).
+ *
+ * Many CMS collections (like Categories, Menus, or Comments) have a tree structure.
+ * Fetching and formatting these hierarchies in pure SQL can be complex.
+ *
+ * This plugin:
+ * 1. Can inject Recursive CTEs (WITH RECURSIVE) for deep tree fetching.
+ * 2. Automatically transforms flat database rows into a nested JSON tree.
+ *
+ * @example
+ * ```ts
+ * const db = new Kysely<Database>({
+ *   dialect,
+ *   plugins: [new TreeResolverPlugin({ parentColumn: 'parent_id', childrenProperty: 'subcategories' })]
+ * });
+ *
+ * const categories = await db.selectFrom('categories').selectAll().execute();
+ * // categories will be nested: [{ id: 1, name: 'Root', subcategories: [{ id: 2, name: 'Child' }] }]
+ * ```
+ */
+export declare class TreeResolverPlugin implements KyselyPlugin {
+    private parentColumn;
+    private childrenProperty;
+    constructor(config: TreeResolverPluginConfig);
+    transformQuery(args: PluginTransformQueryArgs): RootOperationNode;
+    transformResult(args: PluginTransformResultArgs): Promise<QueryResult<any>>;
+    private buildTree;
+}

package/dist/db/kysely/plugins/virtual-field-resolver.d.ts

@@ -0,0 +1,54 @@
+import type { KyselyPlugin, PluginTransformQueryArgs, PluginTransformResultArgs, QueryResult, RootOperationNode } from "kysely";
+import type { ApiKey, Collection, Global, Session, User } from "../../../types";
+/**
+ * Configuration for the VirtualFieldResolverPlugin.
+ */
+export interface VirtualFieldResolverPluginConfig {
+    /** The list of CMS collections. */
+    collections: Collection[];
+    /** The list of CMS globals. */
+    globals?: Global[];
+    /** The current request context (Hono context or similar). */
+    req?: any;
+    /** The current authenticated user. */
+    user?: User;
+    /** The current session. */
+    session?: Session;
+    /** The API key used for the request, if any. */
+    apiKey?: ApiKey;
+}
+/**
+ * Kysely plugin that automatically executes resolver functions for virtual fields.
+ *
+ * Virtual fields are properties that don't exist in the database but are computed
+ * on-the-fly when a document is retrieved.
+ *
+ * This plugin:
+ * 1. Identifies virtual fields from the CMS schema.
+ * 2. After a query is executed, iterates through the result rows.
+ * 3. Calls the `resolve()` function for each virtual field in parallel.
+ * 4. Appends the resolved values to the result objects.
+ *
+ * @example
+ * ```ts
+ * // Field definition in schema:
+ * z.text().cms({
+ *   virtual: true,
+ *   resolve: ({ data }) => `${data.firstName} ${data.lastName}`
+ * })
+ *
+ * // Plugin usage:
+ * const db = new Kysely<Database>({
+ *   dialect,
+ *   plugins: [new VirtualFieldResolverPlugin({ collections, user, session })]
+ * });
+ * ```
+ */
+export declare class VirtualFieldResolverPlugin implements KyselyPlugin {
+    private resolvers;
+    private config;
+    constructor(config: VirtualFieldResolverPluginConfig);
+    private parseConfig;
+    transformQuery(args: PluginTransformQueryArgs): RootOperationNode;
+    transformResult(args: PluginTransformResultArgs): Promise<QueryResult<any>>;
+}

package/dist/db/kysely/plugins/zod-coercion.d.ts

@@ -0,0 +1,34 @@
+import type { KyselyPlugin, PluginTransformQueryArgs, PluginTransformResultArgs, QueryResult, RootOperationNode } from "kysely";
+import type { ZodSchema } from "zod";
+/**
+ * Configuration for the ZodCoercionPlugin.
+ */
+export interface ZodCoercionPluginConfig {
+    /** Map of table names to their corresponding Zod schemas. */
+    schemas: Record<string, ZodSchema>;
+}
+/**
+ * Kysely plugin that provides strict result validation and type coercion using Zod.
+ *
+ * Databases (especially SQLite) often return data in formats that don't match
+ * the application's types (e.g., booleans as 0/1, or complex objects as strings).
+ *
+ * This plugin:
+ * 1. Takes a map of Zod schemas for each table.
+ * 2. After a query is executed, it runs each row through the matching Zod schema.
+ * 3. Automatically coerces types (like string-to-object or number-to-boolean).
+ *
+ * @example
+ * ```ts
+ * const db = new Kysely<Database>({
+ *   dialect,
+ *   plugins: [new ZodCoercionPlugin({ schemas: { posts: postSchema } })]
+ * });
+ * ```
+ */
+export declare class ZodCoercionPlugin implements KyselyPlugin {
+    private schemas;
+    constructor(config: ZodCoercionPluginConfig);
+    transformQuery(args: PluginTransformQueryArgs): RootOperationNode;
+    transformResult(args: PluginTransformResultArgs): Promise<QueryResult<any>>;
+}

package/dist/db/kysely/snapshot/snapshot-manager.d.ts

@@ -0,0 +1,18 @@
+import type { Collection, Global } from "../../../types";
+export interface ColumnSnapshot {
+    name: string;
+    type: string;
+    required: boolean;
+    unique: boolean;
+    defaultValue?: any;
+}
+export interface TableSnapshot {
+    name: string;
+    columns: Record<string, ColumnSnapshot>;
+}
+export interface SchemaSnapshot {
+    tables: Record<string, TableSnapshot>;
+}
+export declare function createSchemaSnapshot(collections: Collection[], globals: Global[], dialect: "postgres" | "sqlite" | "d1"): SchemaSnapshot;
+export declare function saveSnapshot(migrationDir: string, snapshotName: string, snapshot: SchemaSnapshot): void;
+export declare function loadLastSnapshot(migrationDir: string): SchemaSnapshot | null;

package/dist/db/postgres.d.ts

@@ -1,7 +1,7 @@
-import { Kysely } from "kysely";
+import { type Kysely } from "kysely";
 import type postgres from "postgres";
-import type { Collection, FindOptions, Global, PaginatedResult } from "../types";
 import { BaseDatabaseAdapter } from "../db/adapter";
+import type { Collection, FindOptions, Global, PaginatedResult } from "../types";
 export interface PostgresConfig {
     url?: string;
     host?: string;

package/dist/db/postgres.js

@@ -1,13 +1,14 @@
 import {
   PostgresAdapter,
   createPostgresAdapter
-} from "../chunk-tfnaf41w.js";
-import"../chunk-dykn5hr6.js";
+} from "../chunk-5422w4eq.js";
+import"../chunk-j8js1y0h.js";
 import"../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 {
   createPostgresAdapter,
   PostgresAdapter

package/dist/db/sqlite.d.ts

@@ -1,6 +1,6 @@
-import { Kysely } from "kysely";
-import type { Collection, FindOptions, Global, PaginatedResult } from "../types";
+import { type Kysely } from "kysely";
 import { BaseDatabaseAdapter } from "../db/adapter";
+import type { Collection, FindOptions, Global, PaginatedResult } from "../types";
 export declare class SQLiteAdapter extends BaseDatabaseAdapter {
     private path;
     name: string;
@@ -21,7 +21,6 @@ export declare class SQLiteAdapter extends BaseDatabaseAdapter {
     connect(): Promise<void>;
     disconnect(): Promise<void>;
     unsafe(query: string, params?: any[]): Promise<unknown>;
-    private coerceData;
     count(collection: string, query?: Record<string, unknown>): Promise<number>;
     create<T extends object>(collection: string, data: Partial<T>): Promise<T>;
     findOne<T extends object>(collection: string, query: Record<string, unknown>, tx?: any): Promise<T | null>;

package/dist/db/sqlite.js

@@ -1,13 +1,14 @@
 import {
   SQLiteAdapter,
   createSQLiteAdapter
-} from "../chunk-6d1vdfwa.js";
-import"../chunk-dykn5hr6.js";
+} from "../chunk-e0g6gn7n.js";
+import"../chunk-j8js1y0h.js";
 import"../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 {
   createSQLiteAdapter,
   SQLiteAdapter

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 export * from "./auth";
 export * from "./client";
+export * from "./client/RichText";
+export * from "./client/rich-text-utils";
 export * from "./config";
 export * from "./config-utils";
+export * from "./schema";
 export * from "./types";
 export type { AdminConfig, CollectionHooks, FieldType, } from "./validation";

package/dist/index.js

@@ -1,21 +1,175 @@
 import {
   OpacaError,
   createClient
-} from "./chunk-d3ffeqp9.js";
+} from "./chunk-g9bxb6h0.js";
+import {
+  defineCollection,
+  defineGlobal
+} from "./chunk-n1twhqmf.js";
 import {
   defineConfig
-} from "./chunk-7y1nbmw6.js";
+} from "./chunk-1bd7fz7n.js";
 import {
   createAuth,
   sanitizeConfig
-} from "./chunk-b3kr8w41.js";
-import"./chunk-v9z61v3g.js";
-import"./chunk-t0zg026p.js";
-import"./chunk-8sqjbsgt.js";
+} from "./chunk-m24yqkeq.js";
+import"./chunk-5b8r0v8c.js";
+import {
+  $ZodArray,
+  $ZodBoolean,
+  $ZodDate,
+  $ZodDefault,
+  $ZodDiscriminatedUnion,
+  $ZodEnum,
+  $ZodNullable,
+  $ZodNumber,
+  $ZodObject,
+  $ZodOptional,
+  $ZodString,
+  z,
+  zodToOpacaFields
+} from "./chunk-m5ems3hh.js";
+import"./chunk-jq1drsen.js";
+import"./chunk-6qs0g65f.js";
+import"./chunk-6bywt602.js";
+// src/client/RichText.tsx
+import { CodeNode } from "@lexical/code";
+import { AutoLinkNode, LinkNode } from "@lexical/link";
+import { ListItemNode, ListNode } from "@lexical/list";
+import { LexicalComposer } from "@lexical/react/LexicalComposer";
+import { ContentEditable } from "@lexical/react/LexicalContentEditable";
+import { LexicalErrorBoundary } from "@lexical/react/LexicalErrorBoundary";
+import { HistoryPlugin } from "@lexical/react/LexicalHistoryPlugin";
+import { LinkPlugin } from "@lexical/react/LexicalLinkPlugin";
+import { ListPlugin } from "@lexical/react/LexicalListPlugin";
+import { RichTextPlugin } from "@lexical/react/LexicalRichTextPlugin";
+import { HeadingNode, QuoteNode } from "@lexical/rich-text";
+import { useMemo } from "react";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+var theme = {
+  ltr: "ltr",
+  rtl: "rtl",
+  placeholder: "opaca-rich-text-placeholder",
+  paragraph: "opaca-rich-text-p",
+  quote: "opaca-rich-text-quote",
+  heading: {
+    h1: "opaca-rich-text-h1",
+    h2: "opaca-rich-text-h2",
+    h3: "opaca-rich-text-h3"
+  },
+  list: {
+    ol: "opaca-rich-text-ol",
+    ul: "opaca-rich-text-ul",
+    listitem: "opaca-rich-text-li"
+  },
+  link: "opaca-rich-text-link",
+  text: {
+    bold: "opaca-rich-text-bold",
+    italic: "opaca-rich-text-italic",
+    underline: "opaca-rich-text-underline",
+    strikethrough: "opaca-rich-text-strikethrough",
+    code: "opaca-rich-text-code"
+  }
+};
+function RichText({ content, className }) {
+  const initialConfig = useMemo(() => {
+    let editorState = content;
+    if (typeof content === "string" && content.startsWith("{")) {
+      try {
+        editorState = content;
+      } catch (e) {
+        editorState = undefined;
+      }
+    } else if (typeof content === "object" && content !== null) {
+      editorState = JSON.stringify(content);
+    }
+    return {
+      namespace: "OpacaRichTextRenderer",
+      theme,
+      editable: false,
+      nodes: [HeadingNode, ListNode, ListItemNode, QuoteNode, CodeNode, LinkNode, AutoLinkNode],
+      onError: (error) => {
+        console.error("RichText Renderer Error:", error);
+      },
+      editorState
+    };
+  }, [content]);
+  if (!content)
+    return null;
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: `opaca-rich-text-renderer ${className || ""}`,
+    children: /* @__PURE__ */ jsxDEV(LexicalComposer, {
+      initialConfig,
+      children: [
+        /* @__PURE__ */ jsxDEV(RichTextPlugin, {
+          contentEditable: /* @__PURE__ */ jsxDEV(ContentEditable, {
+            className: "opaca-rich-text-content"
+          }, undefined, false, undefined, this),
+          placeholder: null,
+          ErrorBoundary: LexicalErrorBoundary
+        }, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV(ListPlugin, {}, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV(LinkPlugin, {}, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV(HistoryPlugin, {}, undefined, false, undefined, this)
+      ]
+    }, undefined, true, undefined, this)
+  }, undefined, false, undefined, this);
+}
+// src/client/rich-text-utils.ts
+function getRichTextText(content) {
+  if (!content)
+    return "";
+  if (typeof content === "string") {
+    if (content.startsWith("{") && content.includes('"root"')) {
+      try {
+        return getRichTextText(JSON.parse(content));
+      } catch {
+        return content;
+      }
+    }
+    return content;
+  }
+  if (content.root) {
+    return extractLexicalNodes(content.root.children);
+  }
+  if (Array.isArray(content)) {
+    return extractLexicalNodes(content);
+  }
+  return "";
+}
+function extractLexicalNodes(nodes) {
+  if (!nodes || !Array.isArray(nodes))
+    return "";
+  return nodes.map((node) => {
+    if (node.text)
+      return node.text;
+    if (node.children)
+      return extractLexicalNodes(node.children);
+    return "";
+  }).join(" ").replace(/\s+/g, " ").trim();
+}
 export {
+  zodToOpacaFields,
+  z,
   sanitizeConfig,
+  getRichTextText,
+  defineGlobal,
   defineConfig,
+  defineCollection,
   createClient,
   createAuth,
-  OpacaError
+  RichText,
+  OpacaError,
+  $ZodString,
+  $ZodOptional,
+  $ZodObject,
+  $ZodNumber,
+  $ZodNullable,
+  $ZodEnum,
+  $ZodDiscriminatedUnion,
+  $ZodDefault,
+  $ZodDate,
+  $ZodBoolean,
+  $ZodArray
 };

package/dist/runtimes/bun.js

@@ -1,14 +1,17 @@
 import {
   loadPluginSettings
-} from "../chunk-51z3x7kq.js";
+} from "../chunk-a3qae86h.js";
 import {
   createAPIRouter
-} from "../chunk-2es275xs.js";
-import"../chunk-b3kr8w41.js";
+} from "../chunk-941zxavt.js";
+import"../chunk-m24yqkeq.js";
+import"../chunk-5b8r0v8c.js";
+import"../chunk-m5ems3hh.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";
 
 // src/runtimes/bun.ts
 import { Hono } from "hono";

package/dist/runtimes/cloudflare-workers.d.ts

@@ -7,4 +7,6 @@ import type { OpacaConfig } from "../types";
  * @param configOrFactory - Either the OpacaCMS configuration object or a function that returns it.
  * @returns An object with a standard `fetch` method signature.
  */
-export declare function createCloudflareWorkersHandler(configOrFactory: OpacaConfig | ((env: any, request: Request) => OpacaConfig | Promise<OpacaConfig>)): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+export declare function createCloudflareWorkersHandler(configOrFactory: OpacaConfig | ((env: any, request: Request) => OpacaConfig | Promise<OpacaConfig>), options?: {
+    enableAdmin?: boolean;
+}): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;

package/dist/runtimes/cloudflare-workers.js

@@ -1,27 +1,56 @@
 import {
   createAPIRouter
-} from "../chunk-2es275xs.js";
-import"../chunk-b3kr8w41.js";
+} from "../chunk-941zxavt.js";
+import"../chunk-m24yqkeq.js";
+import"../chunk-5b8r0v8c.js";
+import"../chunk-m5ems3hh.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";
 
 // src/runtimes/cloudflare-workers.ts
 import { Hono } from "hono";
 var cachedApp;
-function createCloudflareWorkersHandler(configOrFactory) {
+function createCloudflareWorkersHandler(configOrFactory, options) {
   const app = new Hono;
   app.use("/api/*", async (c, next) => {
     if (cachedApp)
       return cachedApp.fetch(c.req.raw, c.env, c.executionCtx);
     const config = typeof configOrFactory === "function" ? await configOrFactory(c.env, c.req.raw) : configOrFactory;
-    const apiRouter = createAPIRouter(config);
+    const apiRouter = createAPIRouter(config, {}, c.env);
     const innerApp = new Hono;
     innerApp.route("/", apiRouter);
     cachedApp = innerApp;
     return cachedApp.fetch(c.req.raw, c.env, c.executionCtx);
   });
+  if (options?.enableAdmin) {
+    app.get("/admin*", (c) => {
+      return c.html(`
+        <!DOCTYPE html>
+        <html lang="en">
+        <head>
+          <meta charset="UTF-8">
+          <meta name="viewport" content="width=device-width, initial-scale=1.0">
+          <title>OpacaCMS Admin WebComponent</title>
+          <style>
+            body { margin: 0; font-family: sans-serif; }
+          </style>
+          <link rel="stylesheet" href="/admin.css">
+        </head>
+        <body>
+          <opaca-admin
+            server-url="${new URL(c.req.url).origin}"
+          ></opaca-admin>
+
+          <!-- Using local bundle served via Wrangler Assets -->
+          <script type="module" src="/webcomponent.js"></script>
+        </body>
+        </html>
+      `);
+    });
+  }
   return app;
 }
 export {

package/dist/runtimes/next.js

@@ -1,11 +1,14 @@
 import {
   createAPIRouter
-} from "../chunk-2es275xs.js";
-import"../chunk-b3kr8w41.js";
+} from "../chunk-941zxavt.js";
+import"../chunk-m24yqkeq.js";
+import"../chunk-5b8r0v8c.js";
+import"../chunk-m5ems3hh.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";
 
 // src/runtimes/next.ts
 import { handle } from "hono/vercel";

package/dist/runtimes/node.js

@@ -1,14 +1,17 @@
 import {
   loadPluginSettings
-} from "../chunk-51z3x7kq.js";
+} from "../chunk-a3qae86h.js";
 import {
   createAPIRouter
-} from "../chunk-2es275xs.js";
-import"../chunk-b3kr8w41.js";
+} from "../chunk-941zxavt.js";
+import"../chunk-m24yqkeq.js";
+import"../chunk-5b8r0v8c.js";
+import"../chunk-m5ems3hh.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";
 
 // src/runtimes/node.ts
 import { serve } from "@hono/node-server";