@nexpress/core 0.3.0 → 0.3.2

package/dist/jobs.d.ts

@@ -1,4 +1,4 @@
-export { D as DEFAULT_JOB_LOG_RETENTION_MS, L as ListJobLogsOptions, N as NpJobCountOptions, a as NpJobHandler, b as NpJobListOptions, c as NpJobListResult, d as NpJobLogEntry, e as NpJobQueue, f as NpJobState, g as NpJobStateCounts, h as NpJobSummary, i as NpJobsPauseState, j as NpPluginScheduleStats, k as NpReconcileSchedulesResult, l as NpScheduleSummary, m as NpWorkerHealthSummary, n as NpWorkerHeartbeat, P as PAUSE_SYNC_INTERVAL_MS, o as PgBossAdapter, S as SetJobsPauseStateInput, W as WORKER_HEARTBEAT_INTERVAL_MS, p as WORKER_STALE_THRESHOLD_MS, r as countAliveWorkers, s as countJobLogs, t as enqueueJob, u as getAllJobHandlers, v as getCurrentJobId, w as getJobHandler, x as getJobQueue, y as getJobsPauseState, z as getOptionalJobQueue, A as listJobLogs, B as listWorkerHealth, C as markWorkerStopped, E as pruneJobLogsOlderThan, F as purgeStaleWorkers, G as recordHeartbeat, H as recordJobLog, I as registerBuiltinHandlers, J as registerJobHandler, K as runInJobContext, M as setJobQueue, O as setJobsPauseState, Q as startProducer, R as startWorker, T as stopProducer, U as stopWorker } from './index-7_PBSyOq.js';
-import './types-DI3gxsiY.js';
+export { D as DEFAULT_JOB_LOG_RETENTION_MS, L as ListJobLogsOptions, N as NpJobCountOptions, a as NpJobHandler, b as NpJobListOptions, c as NpJobListResult, d as NpJobLogEntry, e as NpJobQueue, f as NpJobState, g as NpJobStateCounts, h as NpJobSummary, i as NpJobsPauseState, j as NpPluginScheduleStats, k as NpReconcileSchedulesResult, l as NpScheduleSummary, m as NpWorkerHealthSummary, n as NpWorkerHeartbeat, P as PAUSE_SYNC_INTERVAL_MS, o as PgBossAdapter, S as SetJobsPauseStateInput, W as WORKER_HEARTBEAT_INTERVAL_MS, p as WORKER_STALE_THRESHOLD_MS, r as countAliveWorkers, s as countJobLogs, t as enqueueJob, u as getAllJobHandlers, v as getCurrentJobId, w as getJobHandler, x as getJobQueue, y as getJobsPauseState, z as getOptionalJobQueue, A as listJobLogs, B as listWorkerHealth, C as markWorkerStopped, E as pruneJobLogsOlderThan, F as purgeStaleWorkers, G as recordHeartbeat, H as recordJobLog, I as registerBuiltinHandlers, J as registerJobHandler, K as runInJobContext, M as setJobQueue, O as setJobsPauseState, Q as startProducer, R as startWorker, T as stopProducer, U as stopWorker } from './index-UZn29S3i.js';
+import './types-D31ppGJw.js';
 import 'pg-boss';
 import './logger-DqGaOU_j.js';

package/dist/jobs.js

@@ -18,7 +18,7 @@ import {
   startWorker,
   stopProducer,
   stopWorker
-} from "./chunk-QSJIKNQJ.js";
+} from "./chunk-ANZBCOEH.js";
 import {
   DEFAULT_JOB_LOG_RETENTION_MS,
   countJobLogs,
@@ -29,13 +29,13 @@ import {
   runInJobContext
 } from "./chunk-QBIJZZ5V.js";
 import "./chunk-LSHHRDVR.js";
-import "./chunk-WV272MPW.js";
 import {
   enqueueJob,
   getJobQueue,
   getOptionalJobQueue,
   setJobQueue
 } from "./chunk-V2UNHGAP.js";
+import "./chunk-WV272MPW.js";
 import "./chunk-OROPGO65.js";
 import "./chunk-NFHS7CFV.js";
 import "./chunk-XANPEOJC.js";

package/dist/media.d.ts

@@ -1,5 +1,5 @@
-export { D as DEFAULT_IMAGE_SIZES, q as DrizzleTransactionLike, b as NpGetMediaUrlOptions, c as NpMediaUploader, d as NpMediaUploaderKindFilter, e as NpMediaVariantName, f as NpProcessedImageResult, r as NpProcessedImageSourceMetadata, g as NpProcessedImageVariant, h as cleanupDeletedMedia, i as deleteMedia, j as extractMediaIds, k as getMediaById, l as getMediaUrl, m as getStorageAdapter, n as listMedia, p as processImage, o as processMediaImage, s as setStorageAdapter, t as syncMediaRefs, u as uploadMedia } from './index-ClcinJ29.js';
-import './types-DI3gxsiY.js';
+export { D as DEFAULT_IMAGE_SIZES, q as DrizzleTransactionLike, b as NpGetMediaUrlOptions, c as NpMediaUploader, d as NpMediaUploaderKindFilter, e as NpMediaVariantName, f as NpProcessedImageResult, r as NpProcessedImageSourceMetadata, g as NpProcessedImageVariant, h as cleanupDeletedMedia, i as deleteMedia, j as extractMediaIds, k as getMediaById, l as getMediaUrl, m as getStorageAdapter, n as listMedia, p as processImage, o as processMediaImage, s as setStorageAdapter, t as syncMediaRefs, u as uploadMedia } from './index-DymnczhP.js';
+import './types-D31ppGJw.js';
 import 'drizzle-orm';
 import 'drizzle-orm/pg-core';
 import 'node:stream/web';

package/dist/media.js

@@ -4,7 +4,7 @@ import {
 } from "./chunk-TETTWT56.js";
 import {
   getMediaUrl
-} from "./chunk-CHQJG4BB.js";
+} from "./chunk-2N53KKIL.js";
 import {
   DEFAULT_IMAGE_SIZES,
   cleanupDeletedMedia,
@@ -16,7 +16,7 @@ import {
   processMediaImage,
   setStorageAdapter,
   uploadMedia
-} from "./chunk-DWG3RZH2.js";
+} from "./chunk-2VZZ7M26.js";
 import "./chunk-V2UNHGAP.js";
 import "./chunk-OROPGO65.js";
 import "./chunk-NFHS7CFV.js";

package/dist/{mentions-NCQR4B72.js → mentions-U4JACYI6.js}

@@ -5,10 +5,10 @@ import {
   extractMentionHandlesFromRichText,
   fanOutMentionNotifications,
   resolveMentionedMembers
-} from "./chunk-HM46WM45.js";
+} from "./chunk-RDTTK27V.js";
 import "./chunk-U4QCCLAW.js";
-import "./chunk-ZCINJSS4.js";
 import "./chunk-SBCVAC2Z.js";
+import "./chunk-ZCINJSS4.js";
 import "./chunk-XANPEOJC.js";
 import "./chunk-X7K5F2UI.js";
 import "./chunk-PZ5AY32C.js";
@@ -20,4 +20,4 @@ export {
   fanOutMentionNotifications,
   resolveMentionedMembers
 };
-//# sourceMappingURL=mentions-NCQR4B72.js.map
+//# sourceMappingURL=mentions-U4JACYI6.js.map

package/dist/{mutes-FJSSU2JP.js → mutes-MNQP6ACF.js}

@@ -4,10 +4,10 @@ import {
   listMutes,
   muteMember,
   unmuteMember
-} from "./chunk-CKT4QZDC.js";
+} from "./chunk-WJJ5MBH5.js";
 import "./chunk-U4QCCLAW.js";
-import "./chunk-ZCINJSS4.js";
 import "./chunk-SBCVAC2Z.js";
+import "./chunk-ZCINJSS4.js";
 import "./chunk-XANPEOJC.js";
 import "./chunk-X7K5F2UI.js";
 import "./chunk-PZ5AY32C.js";
@@ -18,4 +18,4 @@ export {
   muteMember,
   unmuteMember
 };
-//# sourceMappingURL=mutes-FJSSU2JP.js.map
+//# sourceMappingURL=mutes-MNQP6ACF.js.map

package/dist/{scheduled-F77QCDOG.js → scheduled-BWJG35Z2.js}

@@ -1,14 +1,15 @@
 import {
   publishScheduledDocuments
-} from "./chunk-4EPNN4XG.js";
-import "./chunk-HTDDXBMY.js";
+} from "./chunk-54KUQF3S.js";
+import "./chunk-ZA3IRJUQ.js";
+import "./chunk-2VZZ7M26.js";
+import "./chunk-P5WGQRSG.js";
 import "./chunk-4ZLMEKFX.js";
 import "./chunk-U4QCCLAW.js";
-import "./chunk-ZCINJSS4.js";
 import "./chunk-SBCVAC2Z.js";
-import "./chunk-WV272MPW.js";
-import "./chunk-DWG3RZH2.js";
+import "./chunk-ZCINJSS4.js";
 import "./chunk-V2UNHGAP.js";
+import "./chunk-WV272MPW.js";
 import "./chunk-OROPGO65.js";
 import "./chunk-NFHS7CFV.js";
 import "./chunk-XANPEOJC.js";
@@ -17,4 +18,4 @@ import "./chunk-PZ5AY32C.js";
 export {
   publishScheduledDocuments
 };
-//# sourceMappingURL=scheduled-F77QCDOG.js.map
+//# sourceMappingURL=scheduled-BWJG35Z2.js.map

package/dist/seo.d.ts

@@ -150,11 +150,24 @@ interface NpPageMetadataInput {
      */
     ogImage?: string | null;
     /**
-     * Path of the current page (no origin). Used to build the
-     * canonical URL. Pass without query / hash; trailing `/` is
-     * normalized off.
+     * Path of the current page (no origin). Drives the OpenGraph
+     * `url` field (which represents "this resource"). Also serves
+     * as the default for `canonicalPath` when that's not set.
+     * Pass without trailing `/` — trailing slashes are normalized
+     * off — but query strings are preserved so paginated /
+     * filtered routes can identify themselves accurately.
      */
     path?: string;
+    /**
+     * Override the canonical URL path when the page represents
+     * one resource but search engines should treat a different
+     * URL as authoritative. Defaults to `path`. Use when /blog
+     * canonicalises to / on a theme that renders the same content
+     * at both, or when a paginated route should dedupe to its
+     * first page. Leaving this unset means "canonical = self",
+     * which is correct for most pages.
+     */
+    canonicalPath?: string;
     /** OpenGraph type. Default `"website"`; posts use `"article"`. */
     ogType?: "website" | "article" | "profile";
     /**

package/dist/seo.js

@@ -12,15 +12,16 @@ import {
   renderSitemapIndexXml,
   renderSitemapXml,
   validateSeoSettingsPatch
-} from "./chunk-DPRBHEHI.js";
-import "./chunk-HTDDXBMY.js";
+} from "./chunk-YOFCLTBR.js";
+import "./chunk-ZA3IRJUQ.js";
+import "./chunk-2VZZ7M26.js";
+import "./chunk-P5WGQRSG.js";
 import "./chunk-4ZLMEKFX.js";
 import "./chunk-U4QCCLAW.js";
-import "./chunk-ZCINJSS4.js";
 import "./chunk-SBCVAC2Z.js";
-import "./chunk-WV272MPW.js";
-import "./chunk-DWG3RZH2.js";
+import "./chunk-ZCINJSS4.js";
 import "./chunk-V2UNHGAP.js";
+import "./chunk-WV272MPW.js";
 import "./chunk-OROPGO65.js";
 import "./chunk-NFHS7CFV.js";
 import "./chunk-XANPEOJC.js";

package/dist/{settings-JODDWMDB.js → settings-OZWM6L2K.js}

@@ -3,7 +3,7 @@ import {
   getCommunitySettings,
   updateCommunitySettings,
   validateCommunitySettingsPatch
-} from "./chunk-74CGJJDY.js";
+} from "./chunk-RKM4GDWM.js";
 import "./chunk-ZCINJSS4.js";
 import "./chunk-XANPEOJC.js";
 import "./chunk-X7K5F2UI.js";
@@ -14,4 +14,4 @@ export {
   updateCommunitySettings,
   validateCommunitySettingsPatch
 };
-//# sourceMappingURL=settings-JODDWMDB.js.map
+//# sourceMappingURL=settings-OZWM6L2K.js.map

package/dist/settings-OZWM6L2K.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/strings-4EWJYDOG.js

@@ -10,8 +10,8 @@ import {
 } from "./chunk-ELK6AVW5.js";
 import "./chunk-4ZLMEKFX.js";
 import "./chunk-U4QCCLAW.js";
-import "./chunk-ZCINJSS4.js";
 import "./chunk-SBCVAC2Z.js";
+import "./chunk-ZCINJSS4.js";
 import "./chunk-NFHS7CFV.js";
 import "./chunk-XANPEOJC.js";
 import "./chunk-X7K5F2UI.js";

package/dist/{types-DI3gxsiY.d.ts → types-D31ppGJw.d.ts}

@@ -32,7 +32,54 @@ type NpAccessFunction = (args: {
     doc?: Record<string, unknown>;
     data?: Record<string, unknown>;
 }) => boolean | Promise<boolean>;
+/**
+ * Free-form predicate. Server-only — functions don't survive the
+ * server→client boundary in Next.js (the framework's
+ * `toClientCollectionConfig` strips them). For conditions that
+ * need to run in the admin editor's browser-side renderer, use
+ * `NpFieldConditionExpr` (serializable JSON shape) instead.
+ */
 type NpFieldCondition = (data: Record<string, unknown>, siblingData: Record<string, unknown>) => boolean;
+/**
+ * Serializable condition predicate. Evaluated client-side (admin
+ * editor) AND server-side (pipeline validation) from the same
+ * declaration — survives the RSC serialization boundary because
+ * it's plain JSON.
+ *
+ * Examples:
+ *   `{ when: "kind", equals: "doc" }`
+ *   `{ when: "kind", notEquals: "doc" }`
+ *   `{ when: "kind", in: ["doc", "page"] }`
+ *   `{ when: "wpOriginalAuthor", exists: true }`
+ *   `{ all: [{ when: "kind", equals: "doc" }, { when: "publishedAt", exists: true }] }`
+ *   `{ any: [{ when: "kind", equals: "doc" }, { when: "kind", equals: "page" }] }`
+ *
+ * `exists: true` returns true when the value is defined, not null,
+ * not the empty string, and not an empty array. `exists: false`
+ * is the inverse. `equals` / `notEquals` use strict equality.
+ * `in` / `notIn` check membership against an unknown[] list.
+ * `all` / `any` are AND / OR over a list of nested expressions.
+ */
+type NpFieldConditionExpr = {
+    when: string;
+    equals: unknown;
+} | {
+    when: string;
+    notEquals: unknown;
+} | {
+    when: string;
+    in: unknown[];
+} | {
+    when: string;
+    notIn: unknown[];
+} | {
+    when: string;
+    exists: boolean;
+} | {
+    all: NpFieldConditionExpr[];
+} | {
+    any: NpFieldConditionExpr[];
+};
 type NpFieldValidator = (value: unknown, args: {
     data: Record<string, unknown>;
     siblingData: Record<string, unknown>;
@@ -51,7 +98,7 @@ interface NpFieldBase {
         description?: string;
         placeholder?: string;
         readOnly?: boolean;
-        condition?: NpFieldCondition;
+        condition?: NpFieldCondition | NpFieldConditionExpr;
         width?: string;
         /**
          * Optional override for the admin field renderer. The default
@@ -83,6 +130,35 @@ interface NpFieldBase {
          * surfacing a date input in the primary column.
          */
         position?: "main" | "sidebar";
+        /**
+         * Sidebar grouping label. Sidebar fields with the same
+         * `group` render together in one collapsible Card with the
+         * group name as the title. Fields with no group fall into
+         * the default "Publish" Card. Group order in the rendered
+         * sidebar follows first-seen order in the collection's
+         * `fields` array — operators control layout by ordering.
+         *
+         * Examples: `"Publish"`, `"Lead"`, `"Taxonomy"`, `"Author"`,
+         * `"Hierarchy"`, `"SEO"`. The group label is the visible
+         * Card title (not a slug), so it doesn't have to be
+         * machine-friendly.
+         *
+         * Only meaningful when `position: "sidebar"`. Main-column
+         * fields ignore this — they render in field-array order
+         * without grouping.
+         */
+        group?: string;
+        /**
+         * The id of the theme whose `requires.collections.<slug>.fields`
+         * contributed this field. Stamped by `mergeThemeRequirements`;
+         * never set this from operator config. Same convention as
+         * `admin._themeOrigin` at the collection level and per-`kinds`
+         * entry: when an operator switches to a different active
+         * theme, the admin filters out fields whose origin doesn't
+         * match. Operator-declared fields carry no origin and always
+         * pass through.
+         */
+        _themeOrigin?: string;
     };
     validate?: NpFieldValidator;
 }
@@ -121,6 +197,22 @@ interface NpCheckboxField extends NpFieldBase {
 }
 interface NpDateField extends NpFieldBase {
     type: "date";
+    /**
+     * Default value the Drizzle schema generator emits as a SQL
+     * `DEFAULT` clause. Accepted shapes:
+     *
+     *   - `"now"` sentinel → `.defaultNow()` → `DEFAULT now()`
+     *   - A `Date` instance → `.default(new Date("<iso>"))`
+     *   - Any ISO 8601 string → parsed via `new Date(...)` and
+     *     emitted identically to the Date case.
+     *
+     * Anything else is dropped silently at codegen time (mirroring
+     * the defensive shape used for other scalar fields). Required
+     * NOT NULL date columns paired with `defaultValue: "now"` let
+     * an `ALTER TABLE … ADD COLUMN` against a populated table
+     * succeed without a backfill step.
+     */
+    defaultValue?: Date | string;
     pickerOptions?: {
         format?: string;
         includeTime?: boolean;
@@ -379,6 +471,34 @@ interface NpCollectionConfig {
          * before merge) keep this unset and always show.
          */
         _themeOrigin?: string;
+        /**
+         * Framework-set. Stamped by `mergeThemeRequirements` from
+         * `theme.manifest.requires.collections.<slug>.kinds`,
+         * unioned across all registered themes. The admin sidebar
+         * walks this map to render per-kind entries under "Content"
+         * (universal-content-model #748).
+         *
+         * Keyed by the discriminator value declared on the
+         * `kind` field's options. Empty / missing → admin shows a
+         * single collection entry like before.
+         */
+        kinds?: Record<string, NpThemeCollectionKind>;
+        /**
+         * Visual metadata for sidebar field groups. Keyed by the
+         * `admin.group` label used on individual fields. The editor's
+         * `SidebarGroupCard` reads this to render an icon next to
+         * the group title and optionally surface a description.
+         *
+         * Operator-declared collections set this directly. Themes
+         * contribute their own group icons via
+         * `requires.collections.<slug>.groupMeta` (merged through
+         * `mergeThemeRequirements`, unioned across themes with
+         * last-write-wins on per-key props).
+         *
+         * Groups without an entry render without an icon — same
+         * behavior as before this surface existed.
+         */
+        groupMeta?: Record<string, NpAdminGroupMeta>;
     };
     upload?: NpUploadConfig;
 }
@@ -641,6 +761,107 @@ interface NpThemeCollectionRequirement {
      *  slug is registered. Operator-authored collections of the
      *  same slug always take precedence. */
     createIfAbsent?: boolean;
+    /**
+     * Per-kind metadata for the `kind` discriminator field
+     * (universal-content-model #748). Themes contribute one entry
+     * per kind they author content for; the framework's auto-merge
+     * unions entries across registered themes so the admin sidebar
+     * and the public-site router both see one canonical map.
+     *
+     * Keyed by the option value declared on `fields.kind.options`
+     * (e.g. `kinds.doc` matches the option whose `value: "doc"`).
+     * The collection slug remains `posts`; kinds are a presentation
+     * split, not a separate table.
+     *
+     * The `kind` field itself doesn't have to live on this
+     * collection's `fields` for the metadata to apply — themes that
+     * extend a single kind (`fields.kind.options: [{value:"doc"}]`
+     * + `kinds.doc: {...}`) ship both together and the merge unions
+     * them with whatever other themes declare. A `kinds` block on a
+     * collection without a corresponding select field is a no-op
+     * (the admin shows the regular collection list view).
+     */
+    kinds?: Record<string, NpThemeCollectionKind>;
+    /**
+     * Sidebar group metadata the theme contributes. Keyed by the
+     * `admin.group` label the theme uses on its contributed fields
+     * (e.g. theme-magazine contributes `Magazine: { icon: "Newspaper" }`).
+     * Merged into the collection's `admin.groupMeta` via
+     * last-write-wins union — two themes claiming the same group
+     * label get the later theme's icon / description.
+     *
+     * Declaring a group key without contributing fields with the
+     * same `admin.group` is allowed (the entry is unused but
+     * harmless) — useful for overriding a framework default's
+     * icon without adding any new fields.
+     */
+    groupMeta?: Record<string, NpAdminGroupMeta>;
+}
+/**
+ * One kind entry — admin nav + public URL metadata for a single
+ * discriminator value on a `select` field (typically `posts.kind`).
+ *
+ * Field merge: two themes declaring the same kind value get
+ * last-wins on every property. Operators rarely need to redefine
+ * a kind their theme already ships.
+ */
+/**
+ * Per-group sidebar metadata. Resolves at runtime in the admin
+ * edit view; not codegen'd into the DB schema.
+ */
+interface NpAdminGroupMeta {
+    /**
+     * Lucide icon name (no `Icon` suffix) shown next to the
+     * group title in the editor sidebar. Examples: `"Calendar"`,
+     * `"BookOpen"`, `"Briefcase"`. Resolved client-side; unknown
+     * names render no icon (silent fallback, no warning).
+     */
+    icon?: string;
+    /**
+     * One-line description shown beneath the group title. Useful
+     * for operator hints like "Search-result preview + social
+     * card." Truncated by the admin if it's long.
+     */
+    description?: string;
+}
+interface NpThemeCollectionKind {
+    /** Singular human label — "Doc", "Project", "Article". */
+    label: string;
+    /** Plural label for the admin sidebar entry — "Documentation". */
+    labelPlural: string;
+    /** Lucide icon name (no `Icon` suffix) — "BookOpen", "Briefcase". */
+    icon?: string;
+    /**
+     * Public-site URL pattern. `:slug` is the only supported param;
+     * the catch-all router (`apps/web/src/app/(site)/[[...slug]]/page.tsx`)
+     * matches the path, extracts the slug, and queries the host
+     * collection with `where: { kind: "<this-key>", slug: "<match>" }`.
+     *
+     * Omit to fall back to the framework default (`/<collection-slug>/<slug>`,
+     * shared with the kind=null catch-all path). Two kinds declaring
+     * the same urlPattern collide and the first wins; the admin
+     * surfaces this via the requirements diff.
+     */
+    urlPattern?: string;
+    /**
+     * True → admin's per-kind list view surfaces `parent` + `order`
+     * controls and renders rows as a tree. Themes with hierarchical
+     * content (docs, sections) opt in; flat kinds leave it false.
+     */
+    hierarchical?: boolean;
+    /**
+     * Framework-set. Stamped by `mergeThemeRequirements` with the
+     * id of the theme whose `requires.collections.<slug>.kinds`
+     * contributed this entry. The admin sidebar reads it to gate
+     * per-kind nav entries on the active theme — the bundled-themes
+     * prebake unions every built-in's kinds onto the schema, but
+     * only the active theme's kinds deserve sidebar real estate.
+     *
+     * NEVER set this by hand from operator config. The underscore
+     * is intentional — same convention as `admin._themeOrigin` at
+     * the collection level.
+     */
+    _themeOrigin?: string;
 }
 /**
  * One field's requirement. The `type` matches an `NpFieldConfig`
@@ -660,6 +881,48 @@ interface NpThemeFieldRequirement {
      * severity, and a future F.8 may treat it as opt-in patch.
      */
     hard?: boolean;
+    /**
+     * For `select` only — extra options to union into the existing
+     * select field. Two themes can contribute disjoint option sets
+     * (e.g. theme-docs adds `kind="doc"`, theme-portfolio adds
+     * `kind="project"`); the merge dedupes on `value` and last-wins
+     * on `label`. Universal-content-model Phase U.1 (#748).
+     *
+     * Ignored when the merge can't find an existing select with the
+     * same `name`; theme authors that need a brand-new select can't
+     * synthesise one through requirements (`NpThemeFieldRequirement`
+     * doesn't carry enough to construct a valid `NpSelectField`).
+     */
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+    /**
+     * Optional admin hints forwarded onto the synthesised field's
+     * `admin` slot. Themes use these to bucket their contributed
+     * fields into the right sidebar group and hide fields when
+     * irrelevant to the active kind.
+     *
+     * `group` — sidebar Card grouping label
+     *           (e.g. `"Media"`, `"SEO"`).
+     * `condition` — runtime visibility gate. Either a function
+     *               (server-only — stripped at the RSC boundary)
+     *               or a serializable expression (works in both
+     *               environments). Prefer the expression form so
+     *               the admin's client renderer can re-evaluate
+     *               on live form values:
+     *                 `{ when: "kind", equals: "doc" }`
+     *                 `{ when: "kind", notEquals: "doc" }`
+     *                 `{ when: "kind", in: ["doc", "page"] }`
+     *                 `{ when: "wpOriginalAuthor", exists: true }`
+     * `position` — main vs sidebar column. Defaults to the
+     *              framework's `isSidebarField` heuristic.
+     */
+    admin?: {
+        group?: string;
+        condition?: NpFieldCondition | NpFieldConditionExpr;
+        position?: "main" | "sidebar";
+    };
 }
 interface NpRegisteredTheme {
     manifest: NpThemeManifest;
@@ -805,6 +1068,14 @@ interface NpFindWhereSystemTokens {
      * a `locale` field (only i18n-enabled collections do).
      */
     locale?: string;
+    /**
+     * Lifecycle status filter. Every collection in the framework
+     * carries a `status` column (codegen-enforced), so exposing it
+     * here lets a typed `where` clause filter to published rows
+     * without the doc type having to redeclare it. Accepts a
+     * single value or an array (IN match).
+     */
+    status?: NpDocumentStatus | NpDocumentStatus[];
 }
 /**
  * Strip `null` and unwrap arrays so a hasMany field like
@@ -875,6 +1146,27 @@ interface NpFindResult<T = Record<string, unknown>> {
 type NpDocumentStatus = "draft" | "scheduled" | "published" | "archived" | "pending";
 interface NpSaveOptions {
     status?: NpDocumentStatus;
+    /**
+     * Caller-owned Drizzle transaction handle. When provided, all
+     * reads + writes in the save flow run against this transaction
+     * instead of opening a private one — useful for batching many
+     * saves (the seed loop) so a mid-batch failure rolls back the
+     * pending writes as a unit.
+     *
+     * Typed as `unknown` here to avoid a circular import between
+     * `config/types.ts` and `collections/pipeline.ts` (where the
+     * structural type lives). Callers pass the `NpTransaction`
+     * value exported from `@nexpress/core`; the pipeline narrows
+     * with an internal cast at the boundary.
+     *
+     * Pre-write hooks still fire OUTSIDE the tx (they shouldn't see
+     * pending state). Post-commit hooks (`content:afterSave` job,
+     * plugin `content:afterCreate` / `content:afterUpdate`) fire
+     * after the inner persist block but before the caller's outer
+     * tx commits — their side effects can diverge from final DB
+     * state on rollback. Same trade-off as `deleteDocument({ tx })`.
+     */
+    tx?: unknown;
 }
 interface NpSaveResult {
     doc: Record<string, unknown>;
@@ -895,4 +1187,4 @@ interface NpSaveResult {
  */
 declare const ROLE_HIERARCHY: Record<NpUserRole, number>;
 
-export { type NpFieldCondition as A, type NpFieldValidator as B, type NpFindWhere as C, type NpFindWhereSystemTokens as D, type NpGroupField as E, type NpPrincipal as F, type NpI18nConfig as G, type NpImageSize as H, type NpJobType as I, type NpJsonField as J, type NpNumberField as K, type NpPluginContext as L, type NpRadioField as M, type NpRichTextContent as N, type NpRelationshipField as O, type NpResolvedPluginLike as P, type NpRichTextField as Q, type NpRowField as R, type NpSelectField as S, type NpTextField as T, type NpTextareaField as U, type NpThemeCollectionRequirement as V, type NpUploadConfig as W, type NpUploadField as X, ROLE_HIERARCHY as Y, type NpNavItem as a, type NpBlockInstance as b, type NpConfig as c, type NpCollectionConfig as d, type NpAuthUser as e, type NpSaveOptions as f, type NpSaveResult as g, type NpFindOptions as h, type NpFindResult as i, type NpFieldConfig as j, type NpRegisteredTheme as k, type NpThemeFieldRequirement as l, type NpThemeManifest as m, type NpUserRole as n, type NpPluginConfig as o, type NpAccessFunction as p, type NpArrayField as q, type NpBlockConfig as r, type NpBlocksField as s, type NpCheckboxField as t, type NpCollapsibleField as u, type NpCollectionHook as v, type NpDateField as w, type NpDocumentStatus as x, type NpEditorConfig as y, type NpEmailField as z };
+export { ROLE_HIERARCHY as $, type NpEmailField as A, type NpFieldCondition as B, type NpFieldConditionExpr as C, type NpFieldValidator as D, type NpFindWhere as E, type NpFindWhereSystemTokens as F, type NpGroupField as G, type NpPrincipal as H, type NpI18nConfig as I, type NpImageSize as J, type NpJobType as K, type NpJsonField as L, type NpNumberField as M, type NpRichTextContent as N, type NpPluginContext as O, type NpRadioField as P, type NpRelationshipField as Q, type NpResolvedPluginLike as R, type NpRichTextField as S, type NpRowField as T, type NpSelectField as U, type NpTextField as V, type NpTextareaField as W, type NpThemeCollectionKind as X, type NpThemeCollectionRequirement as Y, type NpUploadConfig as Z, type NpUploadField as _, type NpNavItem as a, type NpBlockInstance as b, type NpConfig as c, type NpCollectionConfig as d, type NpAuthUser as e, type NpSaveOptions as f, type NpSaveResult as g, type NpFindOptions as h, type NpFindResult as i, type NpRegisteredTheme as j, type NpThemeFieldRequirement as k, type NpThemeManifest as l, type NpUserRole as m, type NpFieldConfig as n, type NpPluginConfig as o, type NpAccessFunction as p, type NpAdminGroupMeta as q, type NpArrayField as r, type NpBlockConfig as s, type NpBlocksField as t, type NpCheckboxField as u, type NpCollapsibleField as v, type NpCollectionHook as w, type NpDateField as x, type NpDocumentStatus as y, type NpEditorConfig as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexpress/core",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Server-side core for NexPress — collections pipeline, auth, jobs, media, plugins, observability.",
   "license": "MIT",
   "author": "Nexpress",
@@ -48,6 +48,11 @@
       "import": "./dist/db.js",
       "default": "./dist/db.js"
     },
+    "./fields": {
+      "types": "./dist/fields.d.ts",
+      "import": "./dist/fields.js",
+      "default": "./dist/fields.js"
+    },
     "./i18n": {
       "types": "./dist/i18n.d.ts",
       "import": "./dist/i18n.js",