opacacms 0.3.13 → 0.3.15

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Francy Santos (fhorray)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -123,31 +123,32 @@ A **Collection** is a database table + a REST API. Pure magic. ✨
 
 ```typescript
 // collections/posts.ts
-import { Collection, Field } from 'opacacms';
-
-export const posts = Collection.create('posts')
-  .label('Blog Posts')
-  .icon('FileText')
-  .fields([
-    Field.text('title').required().label('Post Title'),
-    Field.slug('slug').from('title').unique(),
-    Field.richText('content').localized(),
-    Field.relationship('author').to('_users').single(),
-    Field.select('status')
-      .options([
-        { label: 'Draft', value: 'draft' },
-        { label: 'Published', value: 'published' },
-      ])
-      .defaultValue('draft'),
-    Field.checkbox('featured').label('Featured Post'),
-  ])
-  .access({
+import { defineCollection, z } from 'opacacms';
+
+export const posts = defineCollection({
+  slug: 'posts',
+  label: 'Blog Posts',
+  admin: {
+    icon: 'FileText',
+    useAsTitle: 'title',
+  },
+  schema: z.object({
+    title: z.text({ label: 'Post Title' }).required(),
+    slug: z.slug({ from: 'title' }).unique(),
+    content: z.richText({ label: 'Content' }).localized(),
+    author: z.relationship('_users', { label: 'Author' }),
+    status: z
+      .select(['draft', 'published'], { label: 'Status' })
+      .default('draft'),
+    featured: z.boolean({ label: 'Featured Post' }),
+  }),
+  access: {
     read: () => true,
     create: ({ user }) => !!user,
     update: ({ user }) => user?.role === 'admin',
     delete: ({ user }) => user?.role === 'admin',
-  })
-  .hooks({
+  },
+  hooks: {
     beforeCreate: async (data) => {
       // Mutate data before insertion
       return { ...data, publishedAt: new Date().toISOString() };
@@ -155,104 +156,90 @@ export const posts = Collection.create('posts')
     afterCreate: async (doc) => {
       console.log('New post created:', doc.id);
     },
-  });
+  },
+});
 ```
 
-### Collection Builder Methods
+### Collection Configuration
 
-| Method               | Description                                                      |
-| -------------------- | ---------------------------------------------------------------- |
-| `.label(name)`       | Sets the display name used in the Admin UI sidebar               |
-| `.icon(name)`        | [Lucide](https://lucide.dev) icon name for the sidebar           |
-| `.fields([...])`     | Defines the data structure for this collection                   |
-| `.access(rules)`     | Collection-level access control                                  |
-| `.hooks(fns)`        | Lifecycle hooks (`beforeCreate`, `afterUpdate`, etc.)            |
-| `.webhooks([...])`   | External webhook notifications                                   |
-| `.admin({...})`      | Advanced Admin UI configuration (`hidden`, `disableAdmin`, etc.) |
-| `.versions(true)`    | Enable document versioning with history                          |
-| `.timestamps({...})` | Customize timestamp field names                                  |
+| Property     | Description                                               |
+| ------------ | --------------------------------------------------------- |
+| `slug`       | The unique identifier for the collection                  |
+| `label`      | Display name used in the Admin UI                         |
+| `admin`      | UI configuration (`icon`, `useAsTitle`, `defaultColumns`) |
+| `schema`     | A `z.object` defining the data structure                  |
+| `access`     | Collection-level access control                           |
+| `hooks`      | Lifecycle hooks (`beforeCreate`, `afterUpdate`, etc.)     |
+| `webhooks`   | External webhook notifications                            |
+| `versions`   | Enable document versioning with history                   |
+| `timestamps` | Customize or disable timestamp fields                     |
 
 ---
 
 ## 🧪 Field Types
 
-We've got everything you need to build powerful schemas:
-
-| Field                  | Usage                                       | Description                                   |
-| ---------------------- | ------------------------------------------- | --------------------------------------------- |
-| `Field.text()`         | `Field.text('title')`                       | Simple string input                           |
-| `Field.number()`       | `Field.number('price')`                     | Numeric input                                 |
-| `Field.richText()`     | `Field.richText('content')`                 | Block-based Lexical editor (Notion style!) 📝 |
-| `Field.relationship()` | `Field.relationship('author').to('_users')` | Links to another collection                   |
-| `Field.file()`         | `Field.file('image')`                       | File/image upload ☁️                          |
-| `Field.blocks()`       | `Field.blocks('layout').blocks([...])`      | Dynamic page builder 🧱                       |
-| `Field.group()`        | `Field.group('meta').fields([...])`         | Nested object group                           |
-| `Field.array()`        | `Field.array('tags').fields([...])`         | Repeatable field group                        |
-| `Field.select()`       | `Field.select('status').options([...])`     | Dropdown picker                               |
-| `Field.checkbox()`     | `Field.checkbox('active')`                  | Boolean toggle                                |
-| `Field.slug()`         | `Field.slug('slug').from('title')`          | Auto-generated URL slug                       |
-| `Field.date()`         | `Field.date('publishedAt')`                 | Date/time picker                              |
-| `Field.virtual()`      | `Field.virtual('fullName').resolve(...)`    | Computed field (not stored)                   |
-| `Field.tabs()`         | `Field.tabs('layout').tabs([...])`          | UI-only grouping for the admin                |
+| Field              | Usage                                                   | Description                                   |
+| ------------------ | ------------------------------------------------------- | --------------------------------------------- |
+| `z.text()`         | `z.text({ label: 'Title' })`                            | Simple string input                           |
+| `z.textarea()`     | `z.textarea({ label: 'Bio' })`                          | Multi-line text area                          |
+| `z.number()`       | `z.number({ label: 'Price' })`                          | Numeric input                                 |
+| `z.richText()`     | `z.richText({ label: 'Content' })`                      | Block-based Lexical editor (Notion style!) 📝 |
+| `z.relationship()` | `z.relationship('_users', { label: 'Author' })`         | Links to another collection                   |
+| `z.file()`         | `z.file({ label: 'Image' })`                            | File/image upload ☁️                          |
+| `z.blocks()`       | `z.blocks([hero, gallery], { label: 'Layout' })`        | Dynamic page builder 🧱                       |
+| `z.group()`        | `z.group({ meta1: z.text(), meta2: z.text() })`         | Nested object group                           |
+| `z.array()`        | `z.array(z.object({ tag: z.text() }))`                  | Repeatable field array                        |
+| `z.select()`       | `z.select(['draft', 'published'], { label: 'Status' })` | Dropdown picker                               |
+| `z.boolean()`      | `z.boolean({ label: 'Active' })`                        | Boolean toggle                                |
+| `z.slug()`         | `z.slug({ from: 'title', label: 'Slug' })`              | Auto-generated URL slug                       |
+| `z.date()`         | `z.date({ label: 'Published At' })`                     | Date/time picker                              |
+| `z.tabs()`         | `z.tabs({ SEO: z.object({...}) })`                      | UI-only grouping for the admin                |
+| `z.join()`         | `z.join('posts', { foreignKey: 'author' })`             | Virtual reversed relationship (read-only)     |
+| `z.password()`     | `z.password({ label: 'Password' })`                     | Secure, hashed input                          |
 
 ### Common Field Methods
 
 Every field type inherits these chainable methods from the base builder:
 
 ```typescript
-Field.text('email')
-  .label('Email Address') // Admin UI label
-  .placeholder('you@example.com') // Input placeholder
-  .required() // Mark as required
+z.text({ label: 'Email Address', description: 'Primary email' })
+  .required() // Native Zod or custom required condition
   .unique() // Unique constraint in the DB
   .localized() // Enable per-locale values (i18n)
-  .defaultValue('hello@world.com') // Default value
-  .validate(z.string().email()) // Custom validation (function or Zod)
-  .access({ readOnly: true }) // Field-level access control
-  .description('Primary email') // Help text below the field
-  .hidden() // Hide from Admin UI
-  .readOnly() // Read-only in Admin UI
-  .admin({ components: { Field: 'my-custom-field' } }); // Custom component
+  .default('hello@world.com') // Native Zod default value
+  .email('Invalid email address') // Native Zod validation
+  .cms({
+    admin: {
+      readOnly: true,
+      hidden: false,
+      components: { Field: 'my-custom-field' },
+    },
+  }); // Advanced CMS and Admin UI options
 ```
 
 ---
 
 ## ✅ Validation
 
-OpacaCMS supports **granular field validation** via the `.validate()` method. You can pass either a **custom function** or a **Zod schema** — they're fully interchangeable.
-
-### Custom Function Validation
-
-Return `true` to pass, or a `string` error message to fail:
-
-```typescript
-Field.text('username').validate((value) => {
-  if (value === 'admin') return "Username 'admin' is reserved";
-  return true;
-});
-```
+OpacaCMS natively supports validation since the entire schema is built using Zod. You can chain standard Zod validation methods directly to your fields.
 
 ### Zod Schema Validation
 
-Pass any `z.ZodTypeAny` schema directly. Errors are automatically mapped:
+Errors are automatically mapped and handled by the API and Admin UI:
 
 ```typescript
 import { z } from 'opacacms';
 
-Field.text('cpf').validate(
-  z.string().regex(/^\d{3}\.\d{3}\.\d{3}-\d{2}$/, 'Invalid CPF format'),
-);
+// Regular expressions
+z.text().regex(/^\d{3}\.\d{3}\.\d{3}-\d{2}$/, 'Invalid CPF format');
 
-Field.text('password').validate(
-  z
-    .string()
-    .min(8, 'Password must be at least 8 characters')
-    .regex(/[A-Z]/, 'Must contain at least one uppercase letter'),
-);
+// String constraints
+z.text()
+  .min(8, 'Password must be at least 8 characters')
+  .regex(/[A-Z]/, 'Must contain at least one uppercase letter');
 
-Field.text('email')
-  .required()
-  .validate(z.string().email('Invalid email address'));
+// Built-in format validators
+z.text().required().email('Invalid email address');
 ```
 
 > **💡 Tip:** Zod validation integrates seamlessly with `.required()`. The built-in requirement check runs first, then your Zod schema validates the value shape.
@@ -264,17 +251,24 @@ Field.text('email')
 Globals are **singleton documents** — perfect for site settings, navigation, footers, and other one-of-a-kind configs.
 
 ```typescript
-import { Global, Field } from 'opacacms';
+import { defineGlobal, z } from 'opacacms';
 
-export const siteSettings = Global.create('site-settings')
-  .label('Site Settings')
-  .icon('Settings')
-  .fields([
-    Field.text('siteName').required(),
-    Field.text('tagline').localized(),
-    Field.file('logo'),
-    Field.group('social').fields([Field.text('twitter'), Field.text('github')]),
-  ]);
+export const siteSettings = defineGlobal({
+  slug: 'site-settings',
+  label: 'Site Settings',
+  admin: {
+    icon: 'Settings',
+  },
+  schema: z.object({
+    siteName: z.text().required().default('My Shiny App'),
+    tagline: z.text().localized(),
+    logo: z.file(),
+    social: z.group({
+      twitter: z.text(),
+      github: z.text(),
+    }),
+  }),
+});
 ```
 
 API: `GET /api/globals/site-settings` and `PUT /api/globals/site-settings`
@@ -288,25 +282,31 @@ Secure your data with simple functions at both **collection** and **field** leve
 ### Collection-Level Access
 
 ```typescript
-.access({
-  read: ({ user }) => !!user,                    // Logged in? You're good.
-  create: ({ user }) => user?.role === 'admin',   // Only admins please!
-  update: ({ data, user }) => data.ownerId === user.id, // Only your own stuff.
-  delete: ({ user }) => user?.role === 'admin',
-  requireApiKey: true,                            // Require API key for programmatic access
-})
+defineCollection({
+  // ...
+  access: {
+    read: ({ user }) => !!user, // Logged in? You're good.
+    create: ({ user }) => user?.role === 'admin', // Only admins please!
+    update: ({ data, user }) => data.ownerId === user.id, // Only your own stuff.
+    delete: ({ user }) => user?.role === 'admin',
+    requireApiKey: true, // Require API key for programmatic access
+  },
+});
 ```
 
 ### Field-Level Access
 
-Control visibility and editability per-field:
+Control visibility and editability per-field using Zod conditional methods and CMS metadata:
 
 ```typescript
-Field.text('internalNotes').access({
-  hidden: ({ user }) => user?.role !== 'admin', // Only admins see this
-  readOnly: ({ operation }) => operation === 'update', // Editable only on create
-  disabled: false,
-});
+z.text({ label: 'Internal Notes' })
+  .condition((data) => data.role === 'admin') // Only show if another field matches
+  .cms({
+    admin: {
+      hidden: true, // Hide from Admin UI
+      readOnly: false,
+    },
+  });
 ```
 
 ### Role-Based Access Control (RBAC)
@@ -334,30 +334,33 @@ access: {
 Hooks let you run side-effects at key points in the document lifecycle. They receive the document data and can mutate it before persistence.
 
 ```typescript
-.hooks({
-  beforeCreate: async (data) => {
-    // Transform or enrich data before saving
-    data.slug = data.title.toLowerCase().replace(/\s+/g, '-');
-    return data;
-  },
-  afterCreate: async (doc) => {
-    // Side-effects after the document is saved
-    await sendWelcomeEmail(doc.email);
-  },
-  beforeUpdate: async (data) => {
-    data.updatedBy = 'system';
-    return data;
-  },
-  afterUpdate: async (doc) => {
-    await invalidateCache(`/posts/${doc.slug}`);
-  },
-  beforeDelete: async (id) => {
-    await archiveDocument(id);
-  },
-  afterDelete: async (id) => {
-    console.log(`Document ${id} deleted`);
+defineCollection({
+  // ...
+  hooks: {
+    beforeCreate: async (data) => {
+      // Transform or enrich data before saving
+      data.slug = data.title.toLowerCase().replace(/\s+/g, '-');
+      return data;
+    },
+    afterCreate: async (doc) => {
+      // Side-effects after the document is saved
+      await sendWelcomeEmail(doc.email);
+    },
+    beforeUpdate: async (data) => {
+      data.updatedBy = 'system';
+      return data;
+    },
+    afterUpdate: async (doc) => {
+      await invalidateCache(`/posts/${doc.slug}`);
+    },
+    beforeDelete: async (id) => {
+      await archiveDocument(id);
+    },
+    afterDelete: async (id) => {
+      console.log(`Document ${id} deleted`);
+    },
   },
-})
+});
 ```
 
 ---
@@ -367,24 +370,25 @@ Hooks let you run side-effects at key points in the document lifecycle. They rec
 Send HTTP notifications to external services when documents change. Webhooks run in the background using `waitUntil` on supported runtimes (Cloudflare Workers, Vercel Edge).
 
 ```typescript
-import { defineCollection } from 'opacacms';
-
 defineCollection({
   slug: 'orders',
   webhooks: [
-  {
-    url: 'https://hooks.slack.com/services/xxx',
-    events: ['afterCreate', 'afterUpdate'],
-    headers: { Authorization: 'Bearer my-token' },
-  },
-  {
-    url: 'https://api.example.com/webhooks/orders',
-    events: ['afterDelete'],
-  },
-]);
+    {
+      type: 'outgoing',
+      url: 'https://hooks.slack.com/services/xxx',
+      events: ['after:create', 'after:update'],
+      headers: { Authorization: 'Bearer my-token' },
+    },
+    {
+      type: 'outgoing',
+      url: 'https://api.example.com/webhooks/orders',
+      events: ['after:delete'],
+    },
+  ],
+});
 ```
 
-Supported events: `afterCreate`, `afterUpdate`, `afterDelete`.
+Supported events: `after:create`, `after:update`, `after:delete`. OpacaCMS also supports `incoming` webhooks.
 
 ---
 
@@ -393,9 +397,11 @@ Supported events: `afterCreate`, `afterUpdate`, `afterDelete`.
 Enable document versioning to keep a full history of changes. Each save creates a snapshot that can be restored later.
 
 ```typescript
-Collection.create('posts')
-  .versions(true) // That's it!
-  .fields([...])
+defineCollection({
+  slug: 'posts',
+  versions: { drafts: true, maxRevisions: 10 },
+  schema: z.object({...})
+});
 ```
 
 ### Version API
@@ -411,13 +417,27 @@ The admin UI provides a visual "Versions" panel where editors can browse and res
 
 ## 🧮 Virtual Fields
 
-Virtual fields are **computed at read-time** and never stored in the database. Perfect for derived values, aggregated data, or API mashups.
+Virtual fields are **computed at read-time** and never stored in the database. Perfect for derived values, aggregated data, or API mashups. Use `z.helpers()` to infer the collection types for type-safe resolving.
 
 ```typescript
-import { Field } from 'opacacms';
+const userShape = z.object({
+  firstName: z.text(),
+  lastName: z.text(),
+});
 
-Field.virtual('fullName').resolve(async ({ data, user, req }) => {
-  return `${data.firstName} ${data.lastName}`;
+const { meta } = z.helpers(userShape);
+
+export const users = defineCollection({
+  slug: 'users',
+  schema: z.object({
+    ...userShape.shape,
+    fullName: meta(z.text(), {
+      isVirtual: true,
+      resolve: async ({ data, user, req }) => {
+        return `${data.firstName} ${data.lastName}`;
+      },
+    }),
+  }),
 });
 ```
 
@@ -494,12 +514,13 @@ logger.info('Custom route hit');
 
 ## 🗄 Database Adapters
 
-OpacaCMS provides first-class adapters for multiple database engines. All adapters implement the same interface, so switching is as simple as changing one line.
+OpacaCMS provides first-class adapters for multiple database engines.
 
 | Adapter       | Import        | Usage                             |
 | ------------- | ------------- | --------------------------------- |
 | SQLite (Bun)  | `opacacms/db` | `createSQLiteAdapter('local.db')` |
 | Cloudflare D1 | `opacacms/db` | `createD1Adapter(env.DB)`         |
+| PostgreSQL    | `opacacms/db` | `createPostgresAdapter(url)`      |
 
 ---
 
@@ -552,8 +573,8 @@ i18n: {
 }
 
 // Field
-Field.text('title').localized()
-Field.richText('content').localized()
+z.text({ label: 'Title' }).localized()
+z.richText({ label: 'Content' }).localized()
 ```
 
 ### Locale Selection
@@ -583,7 +604,7 @@ This is where OpacaCMS shines. You can replace any field UI with your own **Reac
 
 ```tsx
 // MyColorPicker.tsx
-import { defineReactField } from 'opacacms';
+import { defineReactField } from 'opacacms/admin';
 
 const ColorPicker = ({ value, onChange }) => (
   <input
@@ -600,7 +621,7 @@ defineReactField('my-color-picker', ColorPicker);
 
 ```tsx
 // MyVuePicker.vue
-import { defineVueField } from 'opacacms';
+import { defineVueField } from 'opacacms/admin';
 import { createApp } from 'vue';
 import MyVueComponent from './MyVueComponent.vue';
 
@@ -610,9 +631,11 @@ defineVueField('my-vue-picker', MyVueComponent, { createApp });
 ### 3️⃣ Reference in Schema
 
 ```typescript
-Field.text('color').admin({
-  components: {
-    Field: 'my-color-picker',
+z.text({ label: 'Color' }).cms({
+  admin: {
+    components: {
+      Field: 'my-color-picker',
+    },
   },
 });
 ```
@@ -635,11 +658,13 @@ Collections and Fields can be further customized for the Admin UI using the `.ad
 Example:
 
 ```typescript
-export const InternalData = Collection.create('internal_data')
-  .admin({
+export const InternalData = defineCollection({
+  slug: 'internal_data',
+  admin: {
     hidden: true, // Only accessible via direct link
-  })
-  .fields([...]);
+  },
+  schema: z.object({...}),
+});
 ```
 
 ---
@@ -917,8 +942,8 @@ export const myPlugin = () =>
             icon: "Activity",
             path: "/admin/my-plugin",
             render: (serverUrl) => \`
-              <iframe 
-                src="\${serverUrl}/api/plugins/my-plugin/view" 
+              <iframe
+                src="\${serverUrl}/api/plugins/my-plugin/view"
                 style="width:100%; height:calc(100vh - 100px); border:none;"
               ></iframe>
             \`
@@ -929,14 +954,12 @@ export const myPlugin = () =>
 
       // Serve the Isolated HTML View with Hono/HTML
       app.get('/api/plugins/my-plugin/view', (c) => {
-        return c.html(html`
-          <body
-            style="background: #f6f9fc; padding: 40px; font-family: sans-serif;"
-          >
+        return (c.header('Content-Type', 'text/html'), c.body(\`
+          <body style="background: #f6f9fc; padding: 40px; font-family: sans-serif;">
             <h1>Modern Plugin UI</h1>
             <p>Isolated from CMS styles with zero boilerplate.</p>
           </body>
-        `);
+        \`));
       });
     },
 

package/dist/{chunk-8hhzvesq.js → chunk-5b9eqr34.js}

@@ -335,6 +335,7 @@ class D1Adapter extends BaseDatabaseAdapter {
       }
     }
     const totalPages = Math.ceil(total / limit);
+    const hasNextPage = page * limit < total;
     return {
       docs: docs.filter(Boolean),
       totalDocs: total,
@@ -342,11 +343,11 @@ class D1Adapter extends BaseDatabaseAdapter {
       totalPages,
       page,
       pagingCounter: offset + 1,
-      hasNextPage: page * limit < total,
+      hasNextPage,
       hasPrevPage: page > 1 || !!options?.after || !!options?.before,
       prevPage: page > 1 ? page - 1 : null,
       nextPage: page < totalPages ? page + 1 : null,
-      nextCursor: docs.length > 0 ? docs[docs.length - 1][cursorColumn] : null,
+      nextCursor: docs.length > 0 && hasNextPage ? docs[docs.length - 1][cursorColumn] : null,
       prevCursor: docs.length > 0 && (page > 1 || !!options?.after || !!options?.before) ? docs[0][cursorColumn] : null
     };
   }

package/dist/{chunk-1vtdkx5e.js → chunk-dz5bh1bd.js}

@@ -126,6 +126,10 @@ class BetterSQLiteAdapter extends BaseDatabaseAdapter {
           filteredData[col] = flatData[col];
         }
       }
+      if (!filteredData.id) {
+        filteredData.id = crypto.randomUUID();
+        flatData.id = filteredData.id;
+      }
       await tx.insertInto(tableName).values(filteredData).execute();
       for (const [key, values] of Object.entries(hasManyData)) {
         const joinTableName = `${tableName}_${toSnakeCase(key)}_relations`.toLowerCase();
@@ -327,6 +331,7 @@ class BetterSQLiteAdapter extends BaseDatabaseAdapter {
       }
     }
     const totalPages = Math.ceil(total / limit);
+    const hasNextPage = page * limit < total;
     return {
       docs: docs.filter(Boolean),
       totalDocs: total,
@@ -334,11 +339,11 @@ class BetterSQLiteAdapter extends BaseDatabaseAdapter {
       totalPages,
       page,
       pagingCounter: offset + 1,
-      hasNextPage: page * limit < total,
+      hasNextPage,
       hasPrevPage: page > 1 || !!options?.after || !!options?.before,
       prevPage: page > 1 ? page - 1 : null,
       nextPage: page < totalPages ? page + 1 : null,
-      nextCursor: docs.length > 0 ? docs[docs.length - 1][cursorColumn] : null,
+      nextCursor: hasNextPage && docs.length > 0 ? docs[docs.length - 1][cursorColumn] : null,
       prevCursor: docs.length > 0 && (page > 1 || !!options?.after || !!options?.before) ? docs[0][cursorColumn] : null
     };
   }

package/dist/{chunk-gj8w1r1e.js → chunk-nv91gc63.js}

@@ -16,9 +16,14 @@ class OpacaError extends Error {
   }
 }
 function createClient(configOrOptions) {
-  const options = configOrOptions.serverURL ? { baseURL: configOrOptions.serverURL } : configOrOptions;
+  const isConfig = configOrOptions.serverURL || configOrOptions.collections;
+  const options = isConfig ? {
+    baseURL: configOrOptions.serverURL || "http://localhost:3000",
+    token: configOrOptions.token,
+    api: configOrOptions.api
+  } : configOrOptions;
   const baseURL = options.baseURL.replace(/\/$/, "");
-  let engineConfig = null;
+  let engineConfig = options.api || null;
   let metadataCache = null;
   const getHeaders = () => {
     const headers = {
@@ -45,18 +50,20 @@ function createClient(configOrOptions) {
     return res.json();
   };
   const initConfig = async () => {
-    if (engineConfig && metadataCache)
+    if (engineConfig && engineConfig.graphql && metadataCache)
       return;
     try {
       const [setupRes, metadataRes] = await Promise.all([
         fetcher("/api/__admin/setup"),
         fetcher("/api/__admin/collections")
       ]);
-      engineConfig = setupRes.api || { rest: true, graphql: { enabled: false, path: "/graphql" } };
+      engineConfig = setupRes.api || engineConfig || { rest: true, graphql: { enabled: false, path: "/graphql" } };
       metadataCache = metadataRes;
     } catch (e) {
-      engineConfig = { rest: true, graphql: { enabled: false, path: "/graphql" } };
-      metadataCache = { collections: [], globals: [] };
+      const localCols = configOrOptions.collections || [];
+      const localGlobals = configOrOptions.globals || [];
+      engineConfig = engineConfig || { rest: true, graphql: { enabled: false, path: "/graphql" } };
+      metadataCache = { collections: localCols, globals: localGlobals };
     }
   };
   const buildSelectionSet = (fields) => {
@@ -86,7 +93,11 @@ function createClient(configOrOptions) {
       if (!engineConfig?.graphql?.enabled) {
         throw new OpacaError("GraphQL is not enabled on this server.", 400);
       }
-      return fetcher(engineConfig.graphql.path, {
+      let gqlPath = engineConfig.graphql.path || "/graphql";
+      if (!gqlPath.startsWith("/api") && !gqlPath.startsWith("http")) {
+        gqlPath = `/api${gqlPath.startsWith("/") ? "" : "/"}${gqlPath}`;
+      }
+      return fetcher(gqlPath, {
         method: "POST",
         body: JSON.stringify({ query, variables })
       });

package/dist/{chunk-xdmw9vzq.js → chunk-nz6xhtja.js}

@@ -125,6 +125,10 @@ class SQLiteAdapter extends BaseDatabaseAdapter {
           filteredData[col] = flatData[col];
         }
       }
+      if (!filteredData.id) {
+        filteredData.id = crypto.randomUUID();
+        flatData.id = filteredData.id;
+      }
       await tx.insertInto(tableName).values(filteredData).execute();
       for (const [key, values] of Object.entries(hasManyData)) {
         const joinTableName = `${tableName}_${toSnakeCase(key)}_relations`.toLowerCase();
@@ -340,6 +344,7 @@ class SQLiteAdapter extends BaseDatabaseAdapter {
       }
     }
     const totalPages = Math.ceil(total / limit);
+    const hasNextPage = page * limit < total;
     return {
       docs: docs.filter(Boolean),
       totalDocs: total,
@@ -347,11 +352,11 @@ class SQLiteAdapter extends BaseDatabaseAdapter {
       totalPages,
       page,
       pagingCounter: offset + 1,
-      hasNextPage: page * limit < total,
+      hasNextPage,
       hasPrevPage: page > 1 || !!options?.after || !!options?.before,
       prevPage: page > 1 ? page - 1 : null,
       nextPage: page < totalPages ? page + 1 : null,
-      nextCursor: docs.length > 0 ? docs[docs.length - 1][cursorColumn] : null,
+      nextCursor: hasNextPage && docs.length > 0 ? docs[docs.length - 1][cursorColumn] : null,
       prevCursor: docs.length > 0 && (page > 1 || !!options?.after || !!options?.before) ? docs[0][cursorColumn] : null
     };
   }

package/dist/{chunk-0njhbe4a.js → chunk-qsefknd3.js}

@@ -117,6 +117,10 @@ class BunSQLiteAdapter extends BaseDatabaseAdapter {
         filteredData[col] = flatData[col];
       }
     }
+    if (!filteredData.id) {
+      filteredData.id = crypto.randomUUID();
+      flatData.id = filteredData.id;
+    }
     await this.db.insertInto(tableName).values(filteredData).execute();
     for (const [key, values] of Object.entries(hasManyData)) {
       const joinTableName = `${tableName}_${toSnakeCase(key)}_relations`.toLowerCase();
@@ -331,6 +335,7 @@ class BunSQLiteAdapter extends BaseDatabaseAdapter {
       }
     }
     const totalPages = Math.ceil(total / limit);
+    const hasNextPage = page * limit < total;
     return {
       docs: docs.filter(Boolean),
       totalDocs: total,
@@ -338,11 +343,11 @@ class BunSQLiteAdapter extends BaseDatabaseAdapter {
       totalPages,
       page,
       pagingCounter: offset + 1,
-      hasNextPage: page * limit < total,
+      hasNextPage,
       hasPrevPage: page > 1 || !!options?.after || !!options?.before,
       prevPage: page > 1 ? page - 1 : null,
       nextPage: page < totalPages ? page + 1 : null,
-      nextCursor: docs.length > 0 ? docs[docs.length - 1][cursorColumn] : null,
+      nextCursor: hasNextPage && docs.length > 0 ? docs[docs.length - 1][cursorColumn] : null,
       prevCursor: docs.length > 0 && (page > 1 || !!options?.after || !!options?.before) ? docs[0][cursorColumn] : null
     };
   }

package/dist/{chunk-2ec9fsgr.js → chunk-tsmhn78f.js}

@@ -150,6 +150,9 @@ class PostgresAdapter extends BaseDatabaseAdapter {
           delete flatData[key];
         }
       }
+      if (!flatData.id) {
+        flatData.id = crypto.randomUUID();
+      }
       await tx.insertInto(tableName).values(flatData).execute();
       for (const [key, values] of Object.entries(hasManyData)) {
         const joinTableName = `${tableName}_${toSnakeCase(key)}_relations`.toLowerCase();
@@ -360,6 +363,7 @@ class PostgresAdapter extends BaseDatabaseAdapter {
       }
     }
     const totalPages = Math.ceil(total / limit);
+    const hasNextPage = page * limit < total;
     return {
       docs: docs.filter(Boolean),
       totalDocs: total,
@@ -367,11 +371,11 @@ class PostgresAdapter extends BaseDatabaseAdapter {
       totalPages,
       page,
       pagingCounter: offset + 1,
-      hasNextPage: page * limit < total,
+      hasNextPage,
       hasPrevPage: page > 1 || !!options?.after || !!options?.before,
       prevPage: page > 1 ? page - 1 : null,
       nextPage: page < totalPages ? page + 1 : null,
-      nextCursor: docs.length > 0 ? docs[docs.length - 1][cursorColumn] : null,
+      nextCursor: docs.length > 0 && hasNextPage ? docs[docs.length - 1][cursorColumn] : null,
       prevCursor: docs.length > 0 && (page > 1 || !!options?.after || !!options?.before) ? docs[0][cursorColumn] : null
     };
   }

package/dist/client.d.ts

@@ -1,6 +1,7 @@
 export interface OpacaClientOptions {
     baseURL: string;
     token?: string;
+    api?: any;
 }
 export interface OpacaAsset {
     id: string;
@@ -53,6 +54,8 @@ type MapFieldsToType<Fs extends readonly any[]> = {
     [K in Fs[number] as K["required"] extends true ? never : K["name"]]?: MapFieldToType<K>;
 };
 type InferCollectionType<C> = C extends {
+    __type: infer T;
+} ? T : C extends {
     fields: infer Fs;
     timestamps?: infer T;
 } ? (Fs extends readonly any[] ? MapFieldsToType<Fs> : any) & (T extends true | {
@@ -63,6 +66,8 @@ type InferCollectionType<C> = C extends {
     updatedAt: string;
 } : {}) : any;
 type InferGlobalType<G> = G extends {
+    __type: infer T;
+} ? T : G extends {
     fields: infer Fs;
 } ? Fs extends readonly any[] ? MapFieldsToType<Fs> : any : any;
 type InferCollections<T> = T extends {

package/dist/client.js

@@ -1,7 +1,7 @@
 import {
   OpacaError,
   createClient
-} from "./chunk-gj8w1r1e.js";
+} from "./chunk-nv91gc63.js";
 import"./chunk-2vbfc4q8.js";
 import"./chunk-8sqjbsgt.js";
 export {

package/dist/config.d.ts

@@ -23,5 +23,12 @@ export declare function defineConfig<const TCollections extends readonly Buildab
 }>[] = [], TResource extends string = ResourceOf<TCollections, TGlobals>>(config: Omit<OpacaConfig<TResource>, "collections" | "globals"> & {
     collections: TCollections;
     globals?: TGlobals;
-}): OpacaConfig<TResource>;
+}): Omit<OpacaConfig<TResource>, "collections" | "globals"> & {
+    collections: {
+        [K in keyof TCollections]: BuiltResource<TCollections[K]>;
+    };
+    globals: {
+        [K in keyof TGlobals]: BuiltResource<TGlobals[K]>;
+    };
+};
 export {};

package/dist/db/better-sqlite.js

@@ -1,7 +1,7 @@
 import {
   BetterSQLiteAdapter,
   createBetterSQLiteAdapter
-} from "../chunk-1vtdkx5e.js";
+} from "../chunk-dz5bh1bd.js";
 import"../chunk-re459gm9.js";
 import"../chunk-s8mqwnm1.js";
 import"../chunk-q5sb5dcr.js";

package/dist/db/bun-sqlite.js

@@ -1,7 +1,7 @@
 import {
   BunSQLiteAdapter,
   createBunSQLiteAdapter
-} from "../chunk-0njhbe4a.js";
+} from "../chunk-qsefknd3.js";
 import"../chunk-re459gm9.js";
 import"../chunk-s8mqwnm1.js";
 import"../chunk-q5sb5dcr.js";

package/dist/db/d1.js

@@ -1,7 +1,7 @@
 import {
   D1Adapter,
   createD1Adapter
-} from "../chunk-8hhzvesq.js";
+} from "../chunk-5b9eqr34.js";
 import"../chunk-re459gm9.js";
 import"../chunk-s8mqwnm1.js";
 import"../chunk-q5sb5dcr.js";

package/dist/db/index.js

@@ -1,23 +1,23 @@
 import {
   D1Adapter,
   createD1Adapter
-} from "../chunk-8hhzvesq.js";
+} from "../chunk-5b9eqr34.js";
 import {
   PostgresAdapter,
   createPostgresAdapter
-} from "../chunk-2ec9fsgr.js";
+} from "../chunk-tsmhn78f.js";
 import {
   SQLiteAdapter,
   createSQLiteAdapter
-} from "../chunk-xdmw9vzq.js";
+} from "../chunk-nz6xhtja.js";
 import {
   BunSQLiteAdapter,
   createBunSQLiteAdapter
-} from "../chunk-0njhbe4a.js";
+} from "../chunk-qsefknd3.js";
 import {
   BetterSQLiteAdapter,
   createBetterSQLiteAdapter
-} from "../chunk-1vtdkx5e.js";
+} from "../chunk-dz5bh1bd.js";
 import"../chunk-re459gm9.js";
 import {
   BaseDatabaseAdapter

package/dist/db/postgres.js

@@ -1,7 +1,7 @@
 import {
   PostgresAdapter,
   createPostgresAdapter
-} from "../chunk-2ec9fsgr.js";
+} from "../chunk-tsmhn78f.js";
 import"../chunk-re459gm9.js";
 import"../chunk-s8mqwnm1.js";
 import"../chunk-q5sb5dcr.js";

package/dist/db/sqlite.js

@@ -1,7 +1,7 @@
 import {
   SQLiteAdapter,
   createSQLiteAdapter
-} from "../chunk-xdmw9vzq.js";
+} from "../chunk-nz6xhtja.js";
 import"../chunk-re459gm9.js";
 import"../chunk-s8mqwnm1.js";
 import"../chunk-q5sb5dcr.js";

package/dist/index.d.ts

@@ -4,4 +4,4 @@ export * from "./config";
 export * from "./config-utils";
 export * from "./schema";
 export * from "./types";
-export type { AdminConfig, CollectionHooks, FieldType, } from "./validation";
+export type { AdminConfig, } from "./validation";

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   OpacaError,
   createClient
-} from "./chunk-gj8w1r1e.js";
+} from "./chunk-nv91gc63.js";
 import {
   defineCollection,
   defineGlobal

package/dist/schema/collection.d.ts

@@ -1,8 +1,9 @@
 import type { Faker } from "@faker-js/faker";
-import type { AccessConfig, CollectionHooks, LucideIcons } from "@/types";
+import type { AccessConfig } from "../types/access";
+import type { CollectionHooks, LucideIcons } from "@/types";
 import { type ZodObject, type ZodRawShape, type infer as zInfer } from "./zod";
-export interface CollectionConfig<T = any> {
-    slug: string;
+export interface CollectionConfig<T = any, S extends string = string> {
+    slug: S;
     label?: string;
     admin?: {
         useAsTitle?: string;
@@ -20,7 +21,7 @@ export interface CollectionConfig<T = any> {
         createdAt?: string;
         updatedAt?: string;
     };
-    access?: AccessConfig;
+    access?: AccessConfig<T>;
     hooks?: CollectionHooks<T>;
     versions?: {
         drafts?: boolean;
@@ -58,19 +59,19 @@ export interface CollectionConfig<T = any> {
      */
     seed?: (faker: Faker) => Partial<T> | Promise<Partial<T>>;
 }
-export interface DefineCollectionArgs<T extends ZodRawShape> extends CollectionConfig<zInfer<ZodObject<T>>> {
+export interface DefineCollectionArgs<T extends ZodRawShape, S extends string> extends CollectionConfig<zInfer<ZodObject<T>>, S> {
     schema: ZodObject<T>;
 }
 /**
  * Replaces the legacy Collection.create() Builder API.
  * Wraps a Zod Schema and attaches collection-level metadata to it.
  */
-export declare function defineCollection<T extends ZodRawShape>(config: DefineCollectionArgs<T>): {
+export declare function defineCollection<T extends ZodRawShape, S extends string>(config: DefineCollectionArgs<T, S>): {
     schema: ZodObject<T, import("better-auth").$strip>;
     fields: any[];
     seed: ((faker: Faker) => Partial<import("better-auth").$InferObjectOutput<T, {}>> | Promise<Partial<import("better-auth").$InferObjectOutput<T, {}>>>) | undefined;
     __type: zInfer<ZodObject<T, import("better-auth").$strip>>;
-    slug: string;
+    slug: S;
     label?: string;
     admin?: {
         useAsTitle?: string;
@@ -88,7 +89,7 @@ export declare function defineCollection<T extends ZodRawShape>(config: DefineCo
         createdAt?: string;
         updatedAt?: string;
     };
-    access?: AccessConfig;
+    access?: AccessConfig<import("better-auth").$InferObjectOutput<T, {}>> | undefined;
     hooks?: CollectionHooks<import("better-auth").$InferObjectOutput<T, {}>> | undefined;
     versions?: {
         drafts?: boolean;

package/dist/schema/global.d.ts

@@ -1,17 +1,15 @@
 import type { Faker } from "@faker-js/faker";
+import type { AccessConfig } from "../types/access";
 import { type ZodObject, type ZodRawShape, type infer as zInfer } from "./zod";
-export interface GlobalConfig {
-    slug: string;
+export interface GlobalConfig<T = any, S extends string = string> {
+    slug: S;
     label?: string;
     admin?: {
         hidden?: boolean;
         group?: string;
         icon?: string;
     };
-    access?: {
-        read?: (context: any) => boolean | Promise<boolean>;
-        update?: (context: any) => boolean | Promise<boolean>;
-    };
+    access?: AccessConfig<T>;
     /**
      * Seed function for the global.
      * @param faker faker instance
@@ -19,26 +17,23 @@ export interface GlobalConfig {
      */
     seed?: (faker: Faker) => any | Promise<any>;
 }
-export interface DefineGlobalArgs<T extends ZodRawShape> extends GlobalConfig {
+export interface DefineGlobalArgs<T extends ZodRawShape, S extends string> extends GlobalConfig<zInfer<ZodObject<T>>, S> {
     schema: ZodObject<T>;
 }
 /**
  * Zod-based replacement for the legacy GlobalBuilder.
  */
-export declare function defineGlobal<T extends ZodRawShape>(config: DefineGlobalArgs<T>): {
+export declare function defineGlobal<T extends ZodRawShape, S extends string>(config: DefineGlobalArgs<T, S>): {
     schema: ZodObject<T, import("better-auth").$strip>;
     fields: any[];
     seed: ((faker: Faker) => any | Promise<any>) | undefined;
     __type: zInfer<ZodObject<T, import("better-auth").$strip>>;
-    slug: string;
+    slug: S;
     label?: string;
     admin?: {
         hidden?: boolean;
         group?: string;
         icon?: string;
     };
-    access?: {
-        read?: (context: any) => boolean | Promise<boolean>;
-        update?: (context: any) => boolean | Promise<boolean>;
-    };
+    access?: AccessConfig<import("better-auth").$InferObjectOutput<T, {}>> | undefined;
 };

package/dist/types/access.d.ts

@@ -0,0 +1,30 @@
+import type { Context } from "hono";
+export interface AccessArgs<T = any> {
+    req: Context;
+    user: any;
+    session: any;
+    apiKey: any;
+    /** The document being created/updated or the search query */
+    data?: T;
+    /** The ID of the document being read/updated/deleted */
+    id?: string;
+    operation: "read" | "create" | "update" | "delete";
+}
+export interface AccessConfig<T = any> {
+    read?: boolean | ((args: AccessArgs<T>) => boolean | Promise<boolean>);
+    create?: boolean | ((args: AccessArgs<T>) => boolean | Promise<boolean>);
+    update?: boolean | ((args: AccessArgs<T>) => boolean | Promise<boolean>);
+    delete?: boolean | ((args: AccessArgs<T>) => boolean | Promise<boolean>);
+    requireApiKey?: boolean;
+}
+export interface FieldAccessArgs extends AccessArgs {
+    field: string;
+}
+export interface FieldAccessConfig {
+    /** If true, the field is removed from API and UI. */
+    hidden?: boolean | ((args: AccessArgs) => boolean | Promise<boolean>);
+    /** If true, the data is shown but cannot be edited. */
+    readOnly?: boolean | ((args: AccessArgs) => boolean | Promise<boolean>);
+    /** If true, the input is visually disabled. */
+    disabled?: boolean | ((args: AccessArgs) => boolean | Promise<boolean>);
+}

package/dist/types.d.ts

@@ -4,6 +4,8 @@ import type { Context } from "hono";
 import type { icons } from "lucide-react";
 import type { z } from "zod";
 import type { AdminConfig, FieldType } from "./validation";
+import type { AccessArgs, AccessConfig, FieldAccessArgs, FieldAccessConfig } from "./types/access";
+export type { AccessArgs, AccessConfig, FieldAccessArgs, FieldAccessConfig };
 export type { FieldType };
 export type Session = BetterAuthSession;
 export type User = Prettify<BetterAuthUser & {
@@ -273,15 +275,6 @@ export interface ApiKey {
     permissions?: Record<string, string[]> | null;
     referenceId: string;
 }
-export interface AccessArgs {
-    req: Context;
-    user: User | null;
-    session: Session | null;
-    apiKey?: ApiKey | null;
-    data?: any;
-    id?: string;
-    operation: "read" | "create" | "update" | "delete";
-}
 export interface CollectionHookArgs<T = any> {
     req: Context;
     user: User | null;
@@ -293,21 +286,6 @@ export interface CollectionHookArgs<T = any> {
     id?: string;
     operation: "create" | "update" | "delete";
 }
-export interface FieldAccessConfig {
-    /** If true, the field is removed from API and UI. */
-    hidden?: boolean | ((args: AccessArgs) => boolean | Promise<boolean>);
-    /** If true, the data is shown but cannot be edited. */
-    readOnly?: boolean | ((args: AccessArgs) => boolean | Promise<boolean>);
-    /** If true, the input is visually disabled. */
-    disabled?: boolean | ((args: AccessArgs) => boolean | Promise<boolean>);
-}
-export interface AccessConfig {
-    read?: boolean | ((args: AccessArgs) => boolean | Promise<boolean>);
-    create?: boolean | ((args: AccessArgs) => boolean | Promise<boolean>);
-    update?: boolean | ((args: AccessArgs) => boolean | Promise<boolean>);
-    delete?: boolean | ((args: AccessArgs) => boolean | Promise<boolean>);
-    requireApiKey?: boolean;
-}
 export interface CollectionHooks<T = any> {
     beforeCreate?: (args: CollectionHookArgs<T>) => T | Promise<T> | void;
     afterCreate?: (args: CollectionHookArgs<T>) => void | Promise<void>;
@@ -371,7 +349,7 @@ export interface Collection<T = any> {
     /** Lifecycle hooks for custom logic before/after database operations. */
     hooks?: CollectionHooks<T>;
     /** Access control configuration for the collection. */
-    access?: AccessConfig;
+    access?: AccessConfig<T>;
     /** Versioning and draft support configuration. */
     versions?: {
         /** Enable draft/published states for records. */
@@ -426,10 +404,10 @@ export interface Collection<T = any> {
     hidden?: boolean;
     seed?: (faker: Faker) => Partial<T> | Promise<Partial<T>>;
 }
-export interface Global {
+export interface Global<T = any> {
     slug: string;
     fields: Field[];
-    access?: AccessConfig;
+    access?: AccessConfig<T>;
     label?: string;
     icon?: LucideIcons;
     timestamps?: boolean | {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opacacms",
-  "version": "0.3.13",
+  "version": "0.3.15",
   "license": "MIT",
   "description": "OpacaCMS: A lightweight, type-safe, and developer-first Headless CMS for the edge and beyond.",
   "keywords": [
@@ -231,6 +231,7 @@
     "zod-to-json-schema": "^3.25.1"
   },
   "files": [
-    "dist"
+    "dist",
+    "LICENSE"
   ]
 }