velocious 1.0.577 → 1.0.579

package/build/src/database/record/auditing.d.ts

@@ -1,6 +1,3 @@
-/**
- * Global audit event bus matching ActiveRecordAuditable::Events.
- */
 export type AuditEventsType = {
     /**
      * - Fire all callbacks for a model type + action.
@@ -15,13 +12,7 @@ export type AuditEventsType = {
      */
     reset: () => void;
 };
-/**
- * AuditChanges type.
- */
-export type AuditChanges = Record<string, unknown>;
-/**
- * AuditEventPayload type.
- */
+export type AuditChanges = Record<string, ReturnType<typeof JSON.parse>>;
 export type AuditEventPayload = {
     /**
      * - Audit action name.
@@ -38,19 +29,13 @@ export type AuditEventPayload = {
     /**
      * - Optional caller-supplied audit params.
      */
-    params: Record<string, unknown> | null;
+    params: Record<string, ReturnType<typeof JSON.parse>> | null;
     /**
      * - Audited record.
      */
     record: import("./index.js").default;
 };
-/**
- * AuditCallback type.
- */
 export type AuditCallback = (payload: AuditEventPayload) => void | Promise<void>;
-/**
- * CreateAuditArgs type.
- */
 export type CreateAuditArgs = {
     /**
      * - Audit action name.
@@ -59,24 +44,18 @@ export type CreateAuditArgs = {
     /**
      * - Explicit changes to persist.
      */
-    auditedChanges?: AuditChanges | null | undefined;
+    auditedChanges?: AuditChanges | null;
     /**
      * - Optional metadata to store with the audit.
      */
-    params?: Record<string, any> | null | undefined;
+    params?: Record<string, ReturnType<typeof JSON.parse>> | null;
 };
-/**
- * AuditedModelClass type.
- */
 export type AuditedModelClass = typeof import("./index.js").default & {
     _auditCallbacks?: Record<string, AuditCallback[]>;
     _auditLifecycleCallbacksRegistered?: boolean;
     _auditTableResolved?: boolean;
     _auditTableData?: AuditTableData;
 };
-/**
- * AuditTableData type.
- */
 export type AuditTableData = {
     /**
      * - Whether a dedicated audit table exists.
@@ -96,59 +75,100 @@ export type AuditTableData = {
     auditClass: typeof import("./index.js").default;
 };
 /** @type {AuditEventsType} */
-export const AuditEvents: AuditEventsType;
+declare const AuditEvents: AuditEventsType;
 /**
- * Captures create changes before persistence clears the change set.
- * @param {import("./index.js").default & {_pendingCreateAuditChanges?: AuditChanges}} record - Record whose pending changes should be captured.
+ * Registers lifecycle callbacks for automatic create/update/destroy auditing.
+ * Table detection and relationship registration happen lazily on first usage.
+ * Called synchronously from Model.audited() at module-load time.
+ * @param {AuditedModelClass} modelClass - Model class to audit.
  * @returns {void}
  */
-export function captureCreateAuditChanges(record: import("./index.js").default & {
-    _pendingCreateAuditChanges?: AuditChanges;
-}): void;
+declare function registerAuditing(modelClass: AuditedModelClass): void;
 /**
- * Captures update changes before persistence clears the change set.
- * @param {import("./index.js").default & {_pendingUpdateAuditChanges?: AuditChanges}} record - Record whose pending changes should be captured.
- * @returns {void}
+ * Initializes audit metadata for audited model classes.
+ * @param {typeof import("./index.js").default} modelClass - Model class to initialize.
+ * @param {{resolveTableData?: boolean}} [args] - Initialization options.
+ * @returns {Promise<void>}
  */
-export function captureUpdateAuditChanges(record: import("./index.js").default & {
-    _pendingUpdateAuditChanges?: AuditChanges;
-}): void;
+declare function initializeAuditing(modelClass: typeof import("./index.js").default, args?: {
+    resolveTableData?: boolean;
+}): Promise<void>;
+/**
+ * Resolves audit metadata after application and package model classes are registered.
+ * @param {import("../../configuration.js").default} configuration - Configuration whose models should be finalized.
+ * @returns {Promise<void>}
+ */
+declare function initializeAuditedModelRelationships(configuration: import("../../configuration.js").default): Promise<void>;
 /**
  * Creates an audit row for a record.
  * @param {import("./index.js").default} record - Record to audit.
  * @param {CreateAuditArgs} args - Audit row options (action, auditedChanges, params).
  * @returns {Promise<number | string>} Created audit row id.
  */
-export function createAudit(record: import("./index.js").default, args: CreateAuditArgs): Promise<number | string>;
+declare function createAudit(record: import("./index.js").default, args: CreateAuditArgs): Promise<number | string>;
+/**
+ * Captures create changes before persistence clears the change set.
+ * @param {import("./index.js").default & {_pendingCreateAuditChanges?: AuditChanges}} record - Record whose pending changes should be captured.
+ * @returns {void}
+ */
+declare function captureCreateAuditChanges(record: import("./index.js").default & {
+    _pendingCreateAuditChanges?: AuditChanges;
+}): void;
 /**
  * Writes the create audit row for a model instance.
  * @param {import("./index.js").default & {_pendingCreateAuditChanges?: AuditChanges}} record - Record to audit.
  * @returns {Promise<void>}
  */
-export function createCreateAudit(record: import("./index.js").default & {
+declare function createCreateAudit(record: import("./index.js").default & {
     _pendingCreateAuditChanges?: AuditChanges;
 }): Promise<void>;
 /**
- * Writes the destroy audit row for a model instance.
- * @param {import("./index.js").default} record - Record to audit.
- * @returns {Promise<void>}
+ * Captures update changes before persistence clears the change set.
+ * @param {import("./index.js").default & {_pendingUpdateAuditChanges?: AuditChanges}} record - Record whose pending changes should be captured.
+ * @returns {void}
  */
-export function createDestroyAudit(record: import("./index.js").default): Promise<void>;
+declare function captureUpdateAuditChanges(record: import("./index.js").default & {
+    _pendingUpdateAuditChanges?: AuditChanges;
+}): void;
 /**
  * Writes the update audit row for a model instance.
  * @param {import("./index.js").default & {_pendingUpdateAuditChanges?: AuditChanges}} record - Record to audit.
  * @returns {Promise<void>}
  */
-export function createUpdateAudit(record: import("./index.js").default & {
+declare function createUpdateAudit(record: import("./index.js").default & {
     _pendingUpdateAuditChanges?: AuditChanges;
 }): Promise<void>;
+/**
+ * Writes the destroy audit row for a model instance.
+ * @param {import("./index.js").default} record - Record to audit.
+ * @returns {Promise<void>}
+ */
+declare function createDestroyAudit(record: import("./index.js").default): Promise<void>;
+/**
+ * Returns records without an audit row for the given action.
+ * Uses shared-table defaults when table data is not yet resolved;
+ * switches to the dedicated table path once resolved.
+ * @template {AuditedModelClass} MC
+ * @param {MC} modelClass - Model class to scope.
+ * @param {string} action - Audit action to exclude.
+ * @returns {import("../query/model-class-query.js").default<MC>} Query scoped to records without that audit action.
+ */
+declare function withoutAudit<MC extends AuditedModelClass>(modelClass: MC, action: string): import("../query/model-class-query.js").default<MC>;
+/**
+ * Registers a per-model callback fired after an audit row is created.
+ * @param {AuditedModelClass} modelClass - Model class to observe.
+ * @param {string} action - Audit action name (e.g. "create").
+ * @param {AuditCallback} callback - Callback invoked after matching audit rows are created.
+ * @returns {() => void} Unsubscribe function.
+ */
+declare function registerAuditCallback(modelClass: AuditedModelClass, action: string, callback: AuditCallback): () => void;
 /**
  * Creates the shared audit tables migration up/down callbacks for use inside
  * a Migration class. The `table` parameter is a Migration instance.
  * @param {{id?: {type: string}}} [options] - ID column options.
  * @returns {{down: (table: import("../migration/index.js").default) => Promise<void>, up: (table: import("../migration/index.js").default) => Promise<void>}} - Up/down callbacks for the shared audit tables.
  */
-export function createSharedAuditTablesMigration(options?: {
+declare function createSharedAuditTablesMigration(options?: {
     id?: {
         type: string;
     };
@@ -161,46 +181,6 @@ export function createSharedAuditTablesMigration(options?: {
  * @param {string} modelTableName - Model table name (e.g. "projects").
  * @returns {string} Dedicated audit table name (e.g. "project_audits").
  */
-export function dedicatedAuditTableNameForTable(modelTableName: string): string;
-/**
- * Resolves audit metadata after application and package model classes are registered.
- * @param {import("../../configuration.js").default} configuration - Configuration whose models should be finalized.
- * @returns {Promise<void>}
- */
-export function initializeAuditedModelRelationships(configuration: import("../../configuration.js").default): Promise<void>;
-/**
- * Initializes audit metadata for audited model classes.
- * @param {typeof import("./index.js").default} modelClass - Model class to initialize.
- * @param {{resolveTableData?: boolean}} [args] - Initialization options.
- * @returns {Promise<void>}
- */
-export function initializeAuditing(modelClass: typeof import("./index.js").default, args?: {
-    resolveTableData?: boolean;
-}): Promise<void>;
-/**
- * Registers a per-model callback fired after an audit row is created.
- * @param {AuditedModelClass} modelClass - Model class to observe.
- * @param {string} action - Audit action name (e.g. "create").
- * @param {AuditCallback} callback - Callback invoked after matching audit rows are created.
- * @returns {() => void} Unsubscribe function.
- */
-export function registerAuditCallback(modelClass: AuditedModelClass, action: string, callback: AuditCallback): () => void;
-/**
- * Registers lifecycle callbacks for automatic create/update/destroy auditing.
- * Table detection and relationship registration happen lazily on first usage.
- * Called synchronously from Model.audited() at module-load time.
- * @param {AuditedModelClass} modelClass - Model class to audit.
- * @returns {void}
- */
-export function registerAuditing(modelClass: AuditedModelClass): void;
-/**
- * Returns records without an audit row for the given action.
- * Uses shared-table defaults when table data is not yet resolved;
- * switches to the dedicated table path once resolved.
- * @template {AuditedModelClass} MC
- * @param {MC} modelClass - Model class to scope.
- * @param {string} action - Audit action to exclude.
- * @returns {import("../query/model-class-query.js").default<MC>} Query scoped to records without that audit action.
- */
-export function withoutAudit<MC extends AuditedModelClass>(modelClass: MC, action: string): import("../query/model-class-query.js").default<MC>;
+declare function dedicatedAuditTableNameForTable(modelTableName: string): string;
+export { AuditEvents, captureCreateAuditChanges, captureUpdateAuditChanges, createAudit, createCreateAudit, createDestroyAudit, createUpdateAudit, createSharedAuditTablesMigration, dedicatedAuditTableNameForTable, initializeAuditedModelRelationships, initializeAuditing, registerAuditCallback, registerAuditing, withoutAudit };
 //# sourceMappingURL=auditing.d.ts.map

package/build/src/database/record/auditing.d.ts.map

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