@nixxie-cms/core 1.0.3 → 2.0.0

package/dist/declarations/src/helpers.d.ts

@@ -1,4 +1,5 @@
-import type { BaseListTypeInfo, BaseNixxieTypeInfo, ListConfig, NixxieConfigPre, NixxieConfig, ListHooks, ActionArgsConfig, Action, DeclaredAction } from "./types/index.js";
+import type { ListFeaturesConfig } from "./list-features.js";
+import type { BaseCollectionTypeInfo, BaseNixxieTypeInfo, CollectionConfig, NixxieConfigPre, NixxieConfig, CollectionHooks, CollectionAccessControl, ActionArgsConfig, Action, DeclaredAction } from "./types/index.js";
 export declare const validators: {
     /** Validates a string is a well-formed email address */
     readonly email: {
@@ -45,23 +46,41 @@ export declare const validators: {
         readonly isRequired: true;
     };
 };
-export type ListMixin<ListTypeInfo extends BaseListTypeInfo = BaseListTypeInfo> = {
+export declare const accessPresets: {
+    /** Everyone can do everything (equivalent to `allowAll`). */
+    public: CollectionAccessControl<any>;
+    /** Any signed-in user can read & write; anonymous requests are denied. */
+    authenticated: CollectionAccessControl<any>;
+    /** Anyone can read; only signed-in users can create/update/delete. */
+    publicReadAuthenticatedWrite: CollectionAccessControl<any>;
+    /** Anyone can read; nothing can be written through the API. */
+    readOnly: CollectionAccessControl<any>;
+    /**
+     * Rows are scoped to their owner. Signed-in users may create items, and may
+     * only read/update/delete rows whose `<field>` relationship points at the
+     * current session's `itemId`.
+     *
+     * @param field the relationship field linking a row to its owning user (default `'user'`)
+     */
+    owner: (field?: string) => CollectionAccessControl<any>;
+};
+export type CollectionMixin<CollectionTypeInfo extends BaseCollectionTypeInfo = BaseCollectionTypeInfo> = {
     /** Fields added by this mixin — user fields take precedence on key conflicts */
     fields?: Record<string, any>;
     /** Hooks merged with existing list hooks */
-    hooks?: Partial<ListHooks<ListTypeInfo>>;
+    hooks?: Partial<CollectionHooks<CollectionTypeInfo>>;
 };
 /**
  * Adds `createdAt` and `updatedAt` timestamp fields.
  * Both are hidden on create forms and read-only in item views.
  */
-export declare function withTimestamps(): ListMixin;
+export declare function withTimestamps(): CollectionMixin;
 /**
  * Adds a `deletedAt` field for soft-delete support.
  * Items are not physically deleted — set `deletedAt` to the current time instead.
  * Note: you must manually filter `deletedAt: null` in your queries/access control.
  */
-export declare function withSoftDelete(): ListMixin;
+export declare function withSoftDelete(): CollectionMixin;
 /**
  * Adds `createdBy` and `updatedBy` relationship fields that automatically
  * track which user performed each write operation.
@@ -70,7 +89,217 @@ export declare function withSoftDelete(): ListMixin;
  *
  * @param userListKey - The list key for your user model (default: 'User')
  */
-export declare function withAudit(userListKey?: string): ListMixin;
+export declare function withAudit(userListKey?: string): CollectionMixin;
+/**
+ * Adds a URL-friendly `slug` field that is auto-generated from another field
+ * (e.g. `title`) when left blank, and normalised when provided.
+ *
+ * Solves a perennial papercut: there's no built-in slug field, so everyone
+ * re-implements the same `resolveInput` hook by hand.
+ *
+ * @example
+ * defineCollection({ mixins: [withSlug({ from: 'title' })], fields: { title: text() } })
+ */
+export declare function withSlug(opts?: {
+    from: string;
+    field?: string;
+    isIndexed?: 'unique' | true;
+}): CollectionMixin;
+/**
+ * Adds a draft → published → archived workflow: a `status` select plus a
+ * `publishedAt` timestamp that is stamped automatically the first time an item
+ * transitions to `published`.
+ *
+ * Publishing is otherwise left entirely to the developer; this bakes in the
+ * common content lifecycle so a blog/news/docs list works out of the box.
+ */
+export declare function withPublishing(opts?: {
+    defaultStatus?: 'draft' | 'published' | 'archived';
+}): CollectionMixin;
+/**
+ * Adds standard SEO metadata fields, grouped together in the Admin UI.
+ * Drop-in for any content list that needs search/social previews.
+ */
+export declare function withSEO(): CollectionMixin;
+/**
+ * Adds an integer `order` field for manual sorting/drag-ordering of items.
+ */
+export declare function withSortable(opts?: {
+    field?: string;
+}): CollectionMixin;
+/**
+ * Adds self-referential `parent` / `children` relationships for tree-shaped content
+ * (categories, menus, pages), with cycle prevention: an item can never be moved under
+ * one of its own descendants.
+ *
+ * @param listKey - The key of the collection this mixin is applied to (needed for the
+ *   self-referencing relationship and ancestor checks).
+ *
+ * @example
+ * defineCollection({ mixins: [withTreeStructure('Category')], fields: { name: text() } })
+ */
+export declare function withTreeStructure(listKey: string, opts?: {
+    parentField?: string;
+    childrenField?: string;
+}): CollectionMixin;
+/**
+ * Multi-tenancy: adds a required `tenant` relationship that is auto-assigned from the
+ * session on create. Combine with `tenantAccessFilter()` in the collection's
+ * `access.filter` rules to scope every query/update/delete to the session's tenant.
+ *
+ * @example
+ * defineCollection({
+ *   mixins: [withTenant({ ref: 'Tenant' })],
+ *   access: {
+ *     filter: {
+ *       query: tenantAccessFilter(),
+ *       update: tenantAccessFilter(),
+ *       delete: tenantAccessFilter(),
+ *     },
+ *   },
+ *   fields: { ... },
+ * })
+ */
+export declare function withTenant(opts?: {
+    /** Collection that holds tenants. @default 'Tenant' */
+    ref?: string;
+    /** Field key for the tenant relationship. @default 'tenant' */
+    field?: string;
+    /** Extract the tenant id from the session. @default session.data?.tenant?.id ?? session.tenantId */
+    getTenantId?: (session: any) => string | undefined;
+    /** Allow items without a tenant (e.g. global records). @default false */
+    optional?: boolean;
+}): CollectionMixin;
+/**
+ * Access-control filter companion to `withTenant()`: limits matched items to the
+ * session's tenant. Returns `false` (no access) when the session has no tenant.
+ */
+export declare function tenantAccessFilter(opts?: {
+    field?: string;
+    getTenantId?: (session: any) => string | undefined;
+}): ({ session }: {
+    session?: any;
+}) => false | {
+    [x: string]: {
+        id: {
+            equals: string;
+        };
+    };
+};
+/**
+ * Adds `publishAt` / `unpublishAt` timestamps for scheduled publishing. Composes with
+ * `withPublishing()` (which provides the `status` field). The schedule is enacted by
+ * `applyScheduledPublishing()` — run it from a cron job:
+ *
+ * @example
+ * jobs: createJobs({ jobs: [{
+ *   name: 'scheduled-publishing',
+ *   schedule: '* * * * *',
+ *   handler: async () => { await applyScheduledPublishing(getContext(), 'Post') },
+ * }]})
+ */
+export declare function withScheduledPublishing(): CollectionMixin;
+/**
+ * Enact `withScheduledPublishing()` schedules for one collection: publishes drafts whose
+ * `publishAt` has passed and archives published items whose `unpublishAt` has passed.
+ * Designed to be called from a cron job (see `withScheduledPublishing`).
+ */
+export declare function applyScheduledPublishing(context: any, listKey: string, opts?: {
+    statusField?: string;
+    draftValue?: string;
+    publishedValue?: string;
+    archivedValue?: string;
+}): Promise<{
+    published: number;
+    archived: number;
+}>;
+/**
+ * i18n: adds a `locale` select plus a shared `translationKey` that groups an item with
+ * its translations (auto-generated on create when blank). Query an item's variants with
+ * `{ translationKey: { equals }, locale: { not: ... } }` — and once compound uniqueness
+ * is configured, pair (`translationKey`, `locale`) should be unique.
+ *
+ * @example
+ * defineCollection({ mixins: [withLocale({ locales: ['en', 'ur', 'ar'] })], fields: { ... } })
+ */
+export declare function withLocale(opts: {
+    locales: readonly string[];
+    defaultLocale?: string;
+    /** Field key for the grouping id. @default 'translationKey' */
+    groupField?: string;
+}): CollectionMixin;
+/**
+ * Editorial approval: adds an approval status + a `pendingChanges` buffer where proposed
+ * edits wait for review instead of going live. Drive it with `submitForApproval()`,
+ * `approveChanges()` and `rejectChanges()` from custom mutations or the Admin UI.
+ */
+export declare function withApproval(): CollectionMixin;
+/** Park proposed changes on an item for review (see `withApproval`). */
+export declare function submitForApproval(context: any, args: {
+    listKey: string;
+    itemId: string;
+    changes: Record<string, unknown>;
+}): Promise<void>;
+/**
+ * Apply an item's `pendingChanges` (running normal hooks/validation) and mark it
+ * approved. The buffered changes must be a valid update input for the collection.
+ */
+export declare function approveChanges(context: any, args: {
+    listKey: string;
+    itemId: string;
+}): Promise<void>;
+/** Discard an item's `pendingChanges` and mark it rejected. */
+export declare function rejectChanges(context: any, args: {
+    listKey: string;
+    itemId: string;
+}): Promise<void>;
+/**
+ * Adds an `expiresAt` timestamp for content with a shelf life. Pair with
+ * `purgeExpired()` in a cron job to physically remove (or just count) expired items.
+ */
+export declare function withExpiry(opts?: {
+    field?: string;
+}): CollectionMixin;
+/**
+ * Delete every item whose expiry has passed (runs normal delete hooks). Returns the
+ * number deleted. Designed for a cron job; see `withExpiry`.
+ */
+export declare function purgeExpired(context: any, listKey: string, opts?: {
+    field?: string;
+}): Promise<number>;
+/**
+ * Adds a read-only `viewCount` integer. Increment it with `recordView()` — a direct,
+ * race-safe Prisma increment that bypasses hooks (a view is not an editorial change).
+ */
+export declare function withViewCount(opts?: {
+    field?: string;
+}): CollectionMixin;
+/** Increment an item's view counter (see `withViewCount`). */
+export declare function recordView(context: any, listKey: string, itemId: string, opts?: {
+    field?: string;
+}): Promise<void>;
+/**
+ * Companion to cascade rules: sweep records whose to-one relationship points at
+ * nothing (e.g. rows that pre-date a cascade rule, or were orphaned by `setNull`).
+ * Runs normal delete hooks (so cascade rules fire too). Designed for a cron job.
+ *
+ * @example
+ * jobs: createJobs({ jobs: [{
+ *   name: 'orphan-cleanup',
+ *   schedule: '0 4 * * *',
+ *   handler: async () => { await cleanupOrphans(getContext(), { collection: 'Comment', field: 'post' }) },
+ * }]})
+ */
+export declare function cleanupOrphans(context: any, options: {
+    /** Collection to sweep. */
+    collection: string;
+    /** To-one relationship field that must be connected for the record to be kept. */
+    field: string;
+    /** 'delete' removes orphans; 'softDelete' stamps `softDeleteField`. @default 'delete' */
+    action?: 'delete' | 'softDelete';
+    /** @default 'deletedAt' */
+    softDeleteField?: string;
+}): Promise<number>;
 /**
  * Factory for building reusable field group mixins.
  *
@@ -81,19 +310,26 @@ export declare function withAudit(userListKey?: string): ListMixin;
  *   postcode: text({ validation: validators.regex(/^\d{4}$/, 'Must be a 4-digit postcode') }),
  * })
  */
-export declare function createMixin(fields: Record<string, any>, hooks?: Partial<ListHooks<any>>): ListMixin;
-type DefineListConfig<ListTypeInfo extends BaseListTypeInfo> = ListConfig<ListTypeInfo> & {
+export declare function createMixin(fields: Record<string, any>, hooks?: Partial<CollectionHooks<any>>): CollectionMixin;
+type DefineListConfig<CollectionTypeInfo extends BaseCollectionTypeInfo> = Omit<CollectionConfig<CollectionTypeInfo>, 'access'> & {
+    /**
+     * Controls what data can be read and changed. Optional here — unlike
+     * the lower-level `list()`, `defineCollection` defaults to `accessPresets.public`
+     * so a minimal list is genuinely one line. Set an explicit preset or access
+     * object the moment you need real rules.
+     */
+    access?: CollectionConfig<CollectionTypeInfo>['access'];
     /**
      * Mixins to apply to this list. Mixin fields are merged before user fields,
      * so user fields always take precedence on key conflicts.
      */
-    mixins?: ListMixin[];
-};
+    mixins?: CollectionMixin[];
+} & ListFeaturesConfig;
 /**
  * Defines a list with optional mixins for reusable field groups and hooks.
  *
  * @example
- * export const Post = defineList({
+ * export const Post = defineCollection({
  *   mixins: [withTimestamps()],
  *   fields: {
  *     title: text({ validation: validators.required }),
@@ -101,7 +337,7 @@ type DefineListConfig<ListTypeInfo extends BaseListTypeInfo> = ListConfig<ListTy
  *   },
  * })
  */
-export declare function defineList<ListTypeInfo extends BaseListTypeInfo>(config: DefineListConfig<ListTypeInfo>): ListConfig<ListTypeInfo>;
+export declare function defineCollection<CollectionTypeInfo extends BaseCollectionTypeInfo>(config: DefineListConfig<CollectionTypeInfo>): CollectionConfig<CollectionTypeInfo>;
 /**
  * Defines the Nixxie configuration. This is a typed alias for `config()` that
  * provides the same functionality with a more declarative name.
@@ -116,6 +352,6 @@ export declare function defineConfig<TypeInfo extends BaseNixxieTypeInfo>(nixxie
 /**
  * Defines a list action. Typed alias for `action()`.
  */
-export declare function defineAction<ListTypeInfo extends BaseListTypeInfo, Args extends ActionArgsConfig<ListTypeInfo> | undefined = undefined>(actionConfig: Action<ListTypeInfo, Args>): DeclaredAction<ListTypeInfo>;
+export declare function defineAction<CollectionTypeInfo extends BaseCollectionTypeInfo, Args extends ActionArgsConfig<CollectionTypeInfo> | undefined = undefined>(actionConfig: Action<CollectionTypeInfo, Args>): DeclaredAction<CollectionTypeInfo>;
 export {};
 //# sourceMappingURL=helpers.d.ts.map

package/dist/declarations/src/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"../../../src","sources":["helpers.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EAEV,eAAe,EACf,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,MAAM,EACN,cAAc,EACf,yBAAe;AAMhB,eAAO,MAAM,UAAU;IACrB,wDAAwD;;;;;;;IAQxD,yDAAyD;;;;;;;IAQzD,uDAAuD;8BACtC,MAAM;;;;;IAIvB,sDAAsD;8BACrC,MAAM;;;;;IAIvB,gEAAgE;2BAClD,MAAM,OAAO,MAAM;;;;;;IAIjC,yDAAyD;4BAC1C,MAAM,gBAAgB,MAAM;;;;;;IAO3C,gCAAgC;;;;CAExB,CAAA;AAMV,MAAM,MAAM,SAAS,CAAC,YAAY,SAAS,gBAAgB,GAAG,gBAAgB,IAAI;IAChF,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC5B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAA;CACzC,CAAA;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,SAAS,CAsB1C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,SAAS,CAa1C;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,WAAW,SAAS,GAAG,SAAS,CAuCzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,KAAK,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAC9B,SAAS,CAEX;AAMD,KAAK,gBAAgB,CAAC,YAAY,SAAS,gBAAgB,IAAI,UAAU,CAAC,YAAY,CAAC,GAAG;IACxF;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,EAAE,CAAA;CACrB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,YAAY,SAAS,gBAAgB,EAC9D,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,GACrC,UAAU,CAAC,YAAY,CAAC,CAqB1B;AA4ED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,QAAQ,SAAS,kBAAkB,EAC9D,YAAY,EAAE,eAAe,CAAC,QAAQ,CAAC,GACtC,YAAY,CAAC,QAAQ,CAAC,CAExB;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,YAAY,SAAS,gBAAgB,EACrC,IAAI,SAAS,gBAAgB,CAAC,YAAY,CAAC,GAAG,SAAS,GAAG,SAAS,EACnE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG,cAAc,CAAC,YAAY,CAAC,CAExE"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"../../../src","sources":["helpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,2BAAuB;AAQzD,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAEhB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,uBAAuB,EACvB,gBAAgB,EAChB,MAAM,EACN,cAAc,EACf,yBAAe;AAMhB,eAAO,MAAM,UAAU;IACrB,wDAAwD;;;;;;;IAQxD,yDAAyD;;;;;;;IAQzD,uDAAuD;8BACtC,MAAM;;;;;IAIvB,sDAAsD;8BACrC,MAAM;;;;;IAIvB,gEAAgE;2BAClD,MAAM,OAAO,MAAM;;;;;;IAIjC,yDAAyD;4BAC1C,MAAM,gBAAgB,MAAM;;;;;;IAO3C,gCAAgC;;;;CAExB,CAAA;AAcV,eAAO,MAAM,aAAa,EAAE;IAC1B,6DAA6D;IAC7D,MAAM,EAAE,uBAAuB,CAAC,GAAG,CAAC,CAAA;IACpC,0EAA0E;IAC1E,aAAa,EAAE,uBAAuB,CAAC,GAAG,CAAC,CAAA;IAC3C,sEAAsE;IACtE,4BAA4B,EAAE,uBAAuB,CAAC,GAAG,CAAC,CAAA;IAC1D,+DAA+D;IAC/D,QAAQ,EAAE,uBAAuB,CAAC,GAAG,CAAC,CAAA;IACtC;;;;;;OAMG;IACH,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,uBAAuB,CAAC,GAAG,CAAC,CAAA;CA8CxD,CAAA;AAMD,MAAM,MAAM,eAAe,CAAC,kBAAkB,SAAS,sBAAsB,GAAG,sBAAsB,IAAI;IACxG,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC5B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC,CAAA;CACrD,CAAA;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,eAAe,CAsBhD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,eAAe,CAahD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,WAAW,SAAS,GAAG,eAAe,CAuC/D;AAgBD;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CACtB,IAAI,GAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;CAAsB,GACtF,eAAe,CA0BjB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,IAAI,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,UAAU,CAAA;CAAO,GAChE,eAAe,CAkCjB;AAED;;;GAGG;AACH,wBAAgB,OAAO,IAAI,eAAe,CAczC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,eAAe,CAU3E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GAC1D,eAAe,CA+CjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CACxB,IAAI,GAAE;IACJ,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oGAAoG;IACpG,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,MAAM,GAAG,SAAS,CAAA;IAClD,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAA;CACd,GACL,eAAe,CA+BjB;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,GAAE;IACJ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,MAAM,GAAG,SAAS,CAAA;CAC9C,IAIE,aAAa;IAAE,OAAO,CAAC,EAAE,GAAG,CAAA;CAAE;;;;;;EAKvC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,IAAI,eAAe,CAWzD;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IACJ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;CAClB,GACL,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA6BlD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,GAAG,eAAe,CA6BlB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,eAAe,CA6B9C;AAED,wEAAwE;AACxE,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,GAAG,EACZ,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC1E,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,GAAG,EACZ,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,+DAA+D;AAC/D,wBAAsB,aAAa,CACjC,OAAO,EAAE,GAAG,EACZ,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,eAAe,CASzE;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5B,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,eAAe,CAa5E;AAED,8DAA8D;AAC9D,wBAAsB,UAAU,CAC9B,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5B,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE;IACP,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAA;IACb,yFAAyF;IACzF,MAAM,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAA;IAChC,2BAA2B;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,GACA,OAAO,CAAC,MAAM,CAAC,CAyBjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,KAAK,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,GACpC,eAAe,CAEjB;AAMD,KAAK,gBAAgB,CAAC,kBAAkB,SAAS,sBAAsB,IAAI,IAAI,CAC7E,gBAAgB,CAAC,kBAAkB,CAAC,EACpC,QAAQ,CACT,GAAG;IACF;;;;;OAKG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,CAAA;IACvD;;;OAGG;IACH,MAAM,CAAC,EAAE,eAAe,EAAE,CAAA;CAC3B,GAAG,kBAAkB,CAAA;AAEtB;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,kBAAkB,SAAS,sBAAsB,EAChF,MAAM,EAAE,gBAAgB,CAAC,kBAAkB,CAAC,GAC3C,gBAAgB,CAAC,kBAAkB,CAAC,CAoDtC;AA6ED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,QAAQ,SAAS,kBAAkB,EAC9D,YAAY,EAAE,eAAe,CAAC,QAAQ,CAAC,GACtC,YAAY,CAAC,QAAQ,CAAC,CAExB;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,kBAAkB,SAAS,sBAAsB,EACjD,IAAI,SAAS,gBAAgB,CAAC,kBAAkB,CAAC,GAAG,SAAS,GAAG,SAAS,EACzE,YAAY,EAAE,MAAM,CAAC,kBAAkB,EAAE,IAAI,CAAC,GAAG,cAAc,CAAC,kBAAkB,CAAC,CAEpF"}

package/dist/declarations/src/index.d.ts

@@ -1,7 +1,12 @@
-export { list, config, group, action } from "./schema.js";
-export type { ListConfig, BaseFields } from "./types/index.js";
+export { collection, fieldGroup, createAction } from "./schema.js";
+export { validateEnv } from "./lib/env.js";
+export { previewDelete } from "./lib/core/cascade.js";
+export type { CascadePreview, CascadePreviewNode } from "./lib/core/cascade.js";
+export type { CascadeRule, CascadeAction } from "./types/config/lists.js";
+export type { CollectionConfig, BaseFields, NixxiePlugin, NixxieEnvSpec, NixxieEnvVarSpec, } from "./types/index.js";
 export type * from "./types/context.js";
-export { defineList, defineConfig, defineAction, withTimestamps, withSoftDelete, withAudit, createMixin, validators, } from "./helpers.js";
-export type { ListMixin } from "./helpers.js";
+export { defineCollection, defineConfig, defineAction, withTimestamps, withSoftDelete, withAudit, withSlug, withPublishing, withSEO, withSortable, withTreeStructure, withTenant, tenantAccessFilter, withScheduledPublishing, applyScheduledPublishing, withLocale, withApproval, submitForApproval, approveChanges, rejectChanges, withExpiry, purgeExpired, withViewCount, recordView, cleanupOrphans, createMixin, accessPresets, validators, } from "./helpers.js";
+export type { CollectionMixin } from "./helpers.js";
+export type { ListFeaturesConfig, ComputedConfig, ConstraintsConfig, DefaultFilterConfig, StateMachineConfig, PoliciesConfig, PolicyRule, EventsConfig, SearchableConfig, VersionedConfig, } from "./list-features.js";
 export * from "./types/schema/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/declarations/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"../../../src","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAgB;AACtD,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,yBAAe;AAIrD,wCAAoC;AACpC,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,SAAS,EACT,WAAW,EACX,UAAU,GACX,qBAAiB;AAClB,YAAY,EAAE,SAAS,EAAE,qBAAiB;AAO1C,wCAA8B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"../../../src","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,oBAAgB;AAC/D,OAAO,EAAE,WAAW,EAAE,qBAAiB;AACvC,OAAO,EAAE,aAAa,EAAE,8BAA0B;AAClD,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,8BAA0B;AAC5E,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,gCAA4B;AACtE,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,aAAa,EACb,gBAAgB,GACjB,yBAAe;AAIhB,wCAAoC;AACpC,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,SAAS,EACT,QAAQ,EACR,cAAc,EACd,OAAO,EACP,YAAY,EACZ,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,UAAU,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,cAAc,EACd,WAAW,EACX,aAAa,EACb,UAAU,GACX,qBAAiB;AAClB,YAAY,EAAE,eAAe,EAAE,qBAAiB;AAChD,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,2BAAuB;AAOxB,wCAA8B"}

package/dist/declarations/src/internal-unstable/admin-ui/pages/ListPage/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"../../../../../../../src/internal-unstable/admin-ui/pages/ListPage","sources":["index.tsx"],"names":[],"mappings":"AAqDA,OAAO,KAAK,EAAyB,SAAS,EAAY,mCAAyB;AAKnF,KAAK,aAAa,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AACxC,MAAM,MAAM,MAAM,GAAG;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,CAAA;CACjB,CAAA;AAmMD,eAAO,MAAM,WAAW,GAAI,OAAO,aAAa,kDAAkC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"../../../../../../../src/internal-unstable/admin-ui/pages/ListPage","sources":["index.tsx"],"names":[],"mappings":"AAqDA,OAAO,KAAK,EAAyB,SAAS,EAAkB,mCAAyB;AAKzF,KAAK,aAAa,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AACxC,MAAM,MAAM,MAAM,GAAG;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,CAAA;CACjB,CAAA;AAmMD,eAAO,MAAM,WAAW,GAAI,OAAO,aAAa,kDAAkC,CAAA"}

package/dist/declarations/src/lib/admin-meta.d.ts

@@ -1,5 +1,5 @@
-import type { BaseFieldTypeInfo, BaseItem, BaseListTypeInfo, ConditionalFilter, ConditionalFilterCase, NixxieConfig, NixxieContext, ListSortDescriptor, MaybeBooleanItemFunctionWithFilter, MaybeItemActionFunctionWithFilter, MaybeItemFieldFunction, MaybeItemFieldFunctionWithFilter, MaybePromise } from "../types/index.js";
-import type { ActionMeta, FieldMeta, ListMeta } from "../types/admin-meta.js";
+import type { BaseFieldTypeInfo, BaseItem, BaseCollectionTypeInfo, ConditionalFilter, ConditionalFilterCase, NixxieConfig, NixxieContext, CollectionSortDescriptor, MaybeBooleanItemFunctionWithFilter, MaybeItemActionFunctionWithFilter, MaybeItemFieldFunction, MaybeItemFieldFunctionWithFilter, MaybePromise } from "../types/index.js";
+import type { ActionMeta, FieldMeta, CollectionMeta } from "../types/admin-meta.js";
 import type { GraphQLNames, JSONValue } from "../types/utils.js";
 import type { InitialisedList } from "./core/initialise-lists.js";
 type EmptyResolver<Return> = (args: {}, context: NixxieContext) => MaybePromise<Return>;
@@ -9,13 +9,13 @@ type FieldMetaSource_ = {
     isOrderable: EmptyResolver<boolean>;
     isFilterable: EmptyResolver<boolean>;
     createView: {
-        fieldMode: EmptyResolver<ConditionalFilter<'edit' | 'hidden', 'hidden', BaseListTypeInfo>>;
-        isRequired: EmptyResolver<ConditionalFilterCase<BaseListTypeInfo>>;
+        fieldMode: EmptyResolver<ConditionalFilter<'edit' | 'hidden', 'hidden', BaseCollectionTypeInfo>>;
+        isRequired: EmptyResolver<ConditionalFilterCase<BaseCollectionTypeInfo>>;
     };
     itemView: {
-        fieldMode: MaybeItemFieldFunctionWithFilter<'edit' | 'read' | 'hidden', 'read' | 'hidden', BaseListTypeInfo, BaseFieldTypeInfo>;
-        fieldPosition: MaybeItemFieldFunction<'form' | 'sidebar', BaseListTypeInfo, BaseFieldTypeInfo>;
-        isRequired: MaybeBooleanItemFunctionWithFilter<BaseListTypeInfo, BaseFieldTypeInfo>;
+        fieldMode: MaybeItemFieldFunctionWithFilter<'edit' | 'read' | 'hidden', 'read' | 'hidden', BaseCollectionTypeInfo, BaseFieldTypeInfo>;
+        fieldPosition: MaybeItemFieldFunction<'form' | 'sidebar', BaseCollectionTypeInfo, BaseFieldTypeInfo>;
+        isRequired: MaybeBooleanItemFunctionWithFilter<BaseCollectionTypeInfo, BaseFieldTypeInfo>;
     };
     listView: {
         fieldMode: EmptyResolver<'read' | 'hidden'>;
@@ -27,10 +27,10 @@ export type FieldMetaSource = FieldMetaSource_ & Omit<FieldMeta, keyof FieldMeta
 type ActionMetaSource_ = {
     listKey: string;
     itemView: Omit<ActionMeta['itemView'], 'actionMode'> & {
-        actionMode: MaybeItemActionFunctionWithFilter<'enabled' | 'disabled' | 'hidden', 'disabled' | 'hidden', BaseListTypeInfo>;
+        actionMode: MaybeItemActionFunctionWithFilter<'enabled' | 'disabled' | 'hidden', 'disabled' | 'hidden', BaseCollectionTypeInfo>;
     };
     listView: {
-        actionMode: EmptyResolver<ConditionalFilter<'enabled' | 'disabled' | 'hidden', 'disabled' | 'hidden', BaseListTypeInfo>>;
+        actionMode: EmptyResolver<ConditionalFilter<'enabled' | 'disabled' | 'hidden', 'disabled' | 'hidden', BaseCollectionTypeInfo>>;
     };
     item: BaseItem | null;
 };
@@ -51,14 +51,14 @@ type ListMetaSource_ = {
     initialColumns: string[];
     initialFilter: EmptyResolver<JSONValue>;
     initialSearchFields: string[];
-    initialSort: ListSortDescriptor<string> | null;
+    initialSort: CollectionSortDescriptor<string> | null;
     isSingleton: boolean;
     hideNavigation: EmptyResolver<boolean>;
     hideCreate: EmptyResolver<boolean>;
     hideDelete: EmptyResolver<boolean>;
     item: BaseItem | null;
 };
-export type ListMetaSource = ListMetaSource_ & Omit<ListMeta, keyof ListMetaSource_>;
+export type ListMetaSource = ListMetaSource_ & Omit<CollectionMeta, keyof ListMetaSource_>;
 export type AdminMetaSource = {
     lists: ListMetaSource[];
     listsByKey: Record<string, ListMetaSource>;

package/dist/declarations/src/lib/admin-meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"admin-meta.d.ts","sourceRoot":"../../../../src/lib","sources":["admin-meta.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"admin-meta.d.ts","sourceRoot":"../../../../src/lib","sources":["admin-meta.ts"],"names":[],"mappings":"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"}

package/dist/declarations/src/lib/core/access-control.d.ts

@@ -1,4 +1,4 @@
-import type { ActionAccessControlFunction, BaseItem, BaseListTypeInfo, CreateListItemAccessControl, DeleteListItemAccessControl, FieldAccessControl, FieldAccessControlFunction, FieldCreateItemAccessArgs, FieldReadItemAccessArgs, FieldUpdateItemAccessArgs, NixxieContext, ListAccessControl, ListFilterAccessControl, ListOperationAccessControl, UpdateListItemAccessControl } from "../../types/index.js";
+import type { ActionAccessControlFunction, BaseItem, BaseCollectionTypeInfo, CreateCollectionItemAccessControl, DeleteCollectionItemAccessControl, FieldAccessControl, FieldAccessControlFunction, FieldCreateItemAccessArgs, FieldReadItemAccessArgs, FieldUpdateItemAccessArgs, NixxieContext, CollectionAccessControl, CollectionFilterAccessControl, CollectionOperationAccessControl, UpdateCollectionItemAccessControl } from "../../types/index.js";
 import type { InitialisedAction, InitialisedList } from "./initialise-lists.js";
 import { type InputFilter, type UniqueInputFilter } from "./where-inputs.js";
 export declare function cannotForItem(operation: string, list: InitialisedList): string;
@@ -10,30 +10,30 @@ export declare function getAccessFilters(list: InitialisedList, context: NixxieC
 export declare function enforceListLevelAccessControl(context: NixxieContext, operation: 'create' | 'update' | 'delete', list: InitialisedList, inputData: Record<string, unknown>, item: BaseItem | undefined): Promise<void>;
 export declare function enforceFieldLevelAccessControl(context: NixxieContext, operation: 'create' | 'update', list: InitialisedList, inputData: Record<string, unknown>, item: BaseItem | undefined): Promise<void>;
 export type ResolvedFieldAccessControl = {
-    read: FieldAccessControlFunction<FieldReadItemAccessArgs<BaseListTypeInfo>>;
-    create: FieldAccessControlFunction<FieldCreateItemAccessArgs<BaseListTypeInfo>>;
-    update: FieldAccessControlFunction<FieldUpdateItemAccessArgs<BaseListTypeInfo>>;
+    read: FieldAccessControlFunction<FieldReadItemAccessArgs<BaseCollectionTypeInfo>>;
+    create: FieldAccessControlFunction<FieldCreateItemAccessArgs<BaseCollectionTypeInfo>>;
+    update: FieldAccessControlFunction<FieldUpdateItemAccessArgs<BaseCollectionTypeInfo>>;
 };
-export declare function parseFieldAccessControl(access: FieldAccessControl<BaseListTypeInfo> | undefined): ResolvedFieldAccessControl;
-export type ResolvedActionAccessControl = ActionAccessControlFunction<BaseListTypeInfo>;
-export type ResolvedListAccessControl = {
+export declare function parseFieldAccessControl(access: FieldAccessControl<BaseCollectionTypeInfo> | undefined): ResolvedFieldAccessControl;
+export type ResolvedActionAccessControl = ActionAccessControlFunction<BaseCollectionTypeInfo>;
+export type ResolvedCollectionAccessControl = {
     operation: {
-        query: ListOperationAccessControl<'query', BaseListTypeInfo>;
-        create: ListOperationAccessControl<'create', BaseListTypeInfo>;
-        update: ListOperationAccessControl<'update', BaseListTypeInfo>;
-        delete: ListOperationAccessControl<'delete', BaseListTypeInfo>;
+        query: CollectionOperationAccessControl<'query', BaseCollectionTypeInfo>;
+        create: CollectionOperationAccessControl<'create', BaseCollectionTypeInfo>;
+        update: CollectionOperationAccessControl<'update', BaseCollectionTypeInfo>;
+        delete: CollectionOperationAccessControl<'delete', BaseCollectionTypeInfo>;
     };
     filter: {
-        query: ListFilterAccessControl<'query', BaseListTypeInfo>;
-        update: ListFilterAccessControl<'update', BaseListTypeInfo>;
-        delete: ListFilterAccessControl<'delete', BaseListTypeInfo>;
+        query: CollectionFilterAccessControl<'query', BaseCollectionTypeInfo>;
+        update: CollectionFilterAccessControl<'update', BaseCollectionTypeInfo>;
+        delete: CollectionFilterAccessControl<'delete', BaseCollectionTypeInfo>;
     };
     item: {
-        create: CreateListItemAccessControl<BaseListTypeInfo>;
-        update: UpdateListItemAccessControl<BaseListTypeInfo>;
-        delete: DeleteListItemAccessControl<BaseListTypeInfo>;
+        create: CreateCollectionItemAccessControl<BaseCollectionTypeInfo>;
+        update: UpdateCollectionItemAccessControl<BaseCollectionTypeInfo>;
+        delete: DeleteCollectionItemAccessControl<BaseCollectionTypeInfo>;
     };
 };
-export declare function parseListAccessControl(access: ListAccessControl<BaseListTypeInfo>): ResolvedListAccessControl;
+export declare function parseListAccessControl(access: CollectionAccessControl<BaseCollectionTypeInfo>): ResolvedCollectionAccessControl;
 export declare function checkUniqueItemExists(uniqueInput: UniqueInputFilter, foreignList: InitialisedList, context: NixxieContext, operation: string): Promise<import("../../types/prisma.js").UniquePrismaFilter>;
 //# sourceMappingURL=access-control.d.ts.map

package/dist/declarations/src/lib/core/access-control.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"access-control.d.ts","sourceRoot":"../../../../../src/lib/core","sources":["access-control.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"access-control.d.ts","sourceRoot":"../../../../../src/lib/core","sources":["access-control.ts"],"names":[],"mappings":"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"}

package/dist/declarations/src/lib/core/cascade.d.ts

@@ -0,0 +1,47 @@
+import type { NixxieContext } from "../../types/index.js";
+import type { CascadeAction } from "../../types/config/lists.js";
+import type { InitialisedList } from "./initialise-lists.js";
+/**
+ * Check `restrict` rules for an item about to be deleted. Runs before any cascade work,
+ * so a refused delete leaves the database untouched. Records that are already part of
+ * the in-flight cascade (visited) don't count — they are being deleted too.
+ */
+export declare function enforceCascadeRestrictions(list: InitialisedList, context: NixxieContext, item: {
+    id: unknown;
+    [key: string]: unknown;
+}): Promise<void>;
+/**
+ * Enact the non-restrict cascade rules for an item that is about to be deleted.
+ * Called from the delete pipeline after hooks, immediately before the database delete.
+ */
+export declare function runCascade(list: InitialisedList, context: NixxieContext, item: {
+    id: unknown;
+    [key: string]: unknown;
+}): Promise<void>;
+export type CascadePreviewNode = {
+    collection: string;
+    id: string;
+    /** The item's label-field value, when readable. */
+    label?: string;
+    /** What would happen to this record. */
+    action: CascadeAction;
+    children: CascadePreviewNode[];
+};
+export type CascadePreview = {
+    root: CascadePreviewNode;
+    /** Per collection, how many records each action would touch (excluding the root). */
+    totals: Record<string, Partial<Record<CascadeAction, number>>>;
+    /** True when the walk stopped early at the safety cap — totals are then lower bounds. */
+    truncated: boolean;
+};
+/**
+ * Compute — without changing anything — the full tree of records a delete would touch,
+ * following cascade rules recursively. Surface this in delete confirmations:
+ * "This will delete 1 Post, 47 Comments and disconnect 3 Drafts."
+ *
+ * @example
+ * const preview = await previewDelete(context, 'Post', postId)
+ * console.log(preview.totals) // { Comment: { delete: 47 }, Draft: { setNull: 3 } }
+ */
+export declare function previewDelete(context: NixxieContext, listKey: string, itemId: string): Promise<CascadePreview>;
+//# sourceMappingURL=cascade.d.ts.map

package/dist/declarations/src/lib/core/cascade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade.d.ts","sourceRoot":"../../../../../src/lib/core","sources":["cascade.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,6BAAmB;AAChD,OAAO,KAAK,EAAE,aAAa,EAAe,oCAAgC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,8BAA0B;AAsBzD;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAC5C,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAC5C,OAAO,CAAC,IAAI,CAAC,CA2Df;AAID,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wCAAwC;IACxC,MAAM,EAAE,aAAa,CAAA;IACrB,QAAQ,EAAE,kBAAkB,EAAE,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,kBAAkB,CAAA;IACxB,qFAAqF;IACrF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IAC9D,yFAAyF;IACzF,SAAS,EAAE,OAAO,CAAA;CACnB,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CA6DzB"}