@nexpress/core 0.3.1 → 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-lACZ9sON.js';
-import './types-BY1UmEiY.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-DKOCKZVG.js";
+} from "./chunk-ANZBCOEH.js";
 import {
   DEFAULT_JOB_LOG_RETENTION_MS,
   countJobLogs,

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-Ca-WUDH5.js';
-import './types-BY1UmEiY.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/{scheduled-VEOGI5EW.js → scheduled-BWJG35Z2.js}

@@ -1,7 +1,7 @@
 import {
   publishScheduledDocuments
-} from "./chunk-HUESWYZJ.js";
-import "./chunk-6IEYOY2L.js";
+} from "./chunk-54KUQF3S.js";
+import "./chunk-ZA3IRJUQ.js";
 import "./chunk-2VZZ7M26.js";
 import "./chunk-P5WGQRSG.js";
 import "./chunk-4ZLMEKFX.js";
@@ -18,4 +18,4 @@ import "./chunk-PZ5AY32C.js";
 export {
   publishScheduledDocuments
 };
-//# sourceMappingURL=scheduled-VEOGI5EW.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,8 +12,8 @@ import {
   renderSitemapIndexXml,
   renderSitemapXml,
   validateSeoSettingsPatch
-} from "./chunk-HVHV3IHF.js";
-import "./chunk-6IEYOY2L.js";
+} from "./chunk-YOFCLTBR.js";
+import "./chunk-ZA3IRJUQ.js";
 import "./chunk-2VZZ7M26.js";
 import "./chunk-P5WGQRSG.js";
 import "./chunk-4ZLMEKFX.js";

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

@@ -197,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;
@@ -1052,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
@@ -1122,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>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexpress/core",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Server-side core for NexPress — collections pipeline, auth, jobs, media, plugins, observability.",
   "license": "MIT",
   "author": "Nexpress",