@decaf-ts/core 0.30.0 → 0.30.2

package/lib/types/index.d.cts

@@ -24,21 +24,21 @@ export * from "./persistence/index.d.cts";
  * @const VERSION
  * @memberOf module:core
  */
-export declare const VERSION = "0.29.0";
+export declare const VERSION = "0.30.1";
 /**
  * @description Represents the current commit hash of the module build.
  * @summary Stores the current git commit hash for the package. The build replaces
  * the placeholder with the actual commit hash at publish time.
  * @const COMMIT
  */
-export declare const COMMIT = "53430c1";
+export declare const COMMIT = "5b0ad63";
 /**
  * @description Represents the full version string of the module.
  * @summary Stores the semver version and commit hash for the package.
  * The build replaces the placeholder with the actual `<version>-<commit>` value at publish time.
  * @const FULL_VERSION
  */
-export declare const FULL_VERSION = "0.29.0-53430c1";
+export declare const FULL_VERSION = "0.30.1-5b0ad63";
 /**
  * @description Stores the current package version
  * @summary A constant representing the version of the core package

package/lib/types/index.d.mts

@@ -24,21 +24,21 @@ export * from "./persistence/index.d.mts";
  * @const VERSION
  * @memberOf module:core
  */
-export declare const VERSION = "0.29.0";
+export declare const VERSION = "0.30.1";
 /**
  * @description Represents the current commit hash of the module build.
  * @summary Stores the current git commit hash for the package. The build replaces
  * the placeholder with the actual commit hash at publish time.
  * @const COMMIT
  */
-export declare const COMMIT = "53430c1";
+export declare const COMMIT = "5b0ad63";
 /**
  * @description Represents the full version string of the module.
  * @summary Stores the semver version and commit hash for the package.
  * The build replaces the placeholder with the actual `<version>-<commit>` value at publish time.
  * @const FULL_VERSION
  */
-export declare const FULL_VERSION = "0.29.0-53430c1";
+export declare const FULL_VERSION = "0.30.1-5b0ad63";
 /**
  * @description Stores the current package version
  * @summary A constant representing the version of the core package

package/lib/types/persistence/constants.d.cts

@@ -60,12 +60,18 @@ export declare enum PersistenceKeys {
     MIGRATION = "migration",
     STATEMENT = "statement",
     QUERY = "query",
+    /** @description Action log grouping for value-based scans over a model's records (findOneBy/findBy/findByPaginate) */
+    TABLE_SCAN = "table-scan",
+    /** @description Action log grouping for dynamic dispatch to `@prepared()`/`@query()`-decorated repository methods */
+    PREPARED_STATEMENT = "prepared-statement",
     UUID = "uuid",
     TAG_FOR_DELETION = "tag_for_deletion",
     INITIALIZATION = "initialization",
     SHUTDOWN = "shutdown",
     BY_KEY = "by-key",
     AUTH = "auth",
+    /** @description Action log key for authorization/authentication failures - the inverse of {@link PersistenceKeys.AUTH} */
+    FORBIDDEN = "forbidden",
     AUTH_ROLE = "auth-role",
     DECAF_ROUTE = "DecafRoute",
     THROTTLE = "throttle",

package/lib/types/persistence/constants.d.mts

@@ -60,12 +60,18 @@ export declare enum PersistenceKeys {
     MIGRATION = "migration",
     STATEMENT = "statement",
     QUERY = "query",
+    /** @description Action log grouping for value-based scans over a model's records (findOneBy/findBy/findByPaginate) */
+    TABLE_SCAN = "table-scan",
+    /** @description Action log grouping for dynamic dispatch to `@prepared()`/`@query()`-decorated repository methods */
+    PREPARED_STATEMENT = "prepared-statement",
     UUID = "uuid",
     TAG_FOR_DELETION = "tag_for_deletion",
     INITIALIZATION = "initialization",
     SHUTDOWN = "shutdown",
     BY_KEY = "by-key",
     AUTH = "auth",
+    /** @description Action log key for authorization/authentication failures - the inverse of {@link PersistenceKeys.AUTH} */
+    FORBIDDEN = "forbidden",
     AUTH_ROLE = "auth-role",
     DECAF_ROUTE = "DecafRoute",
     THROTTLE = "throttle",

package/lib/types/tasks/logging.d.cts

@@ -11,6 +11,21 @@ export declare class TaskLogger<LOG extends Logger> implements Logger {
     flush<PIPE extends LogPipe>(pipe?: PIPE): PIPE extends LogPipe ? Promise<[LogLevel, string, any][]> : [LogLevel, string, any][];
     readonly root: string[];
     benchmark(msg: StringLike): void;
+    /**
+     * @description Logs a named action event (delegated to the wrapped logger).
+     * @summary {@link TaskLogger} does not track `action()` events in its
+     * in-memory history — the call is forwarded verbatim to the underlying
+     * {@link Logger.action} implementation, which owns action-level handling.
+     * Because only the single wrapped call is proxied, the entire received
+     * argument set including the optional status code is passed through.
+     * @param {string} action The name of the action being recorded.
+     * @param {number} [code] Optional integer code annotating the action outcome.
+     * @param {LogMeta} [meta] Optional structured metadata for the action.
+     * @memberOf module:tasks.TaskLogger
+     * @method action
+     */
+    action(action: string, meta?: LogMeta): void;
+    action(action: string, code: number, meta?: LogMeta): void;
     clear(): this;
     debug(msg: StringLike, meta?: LogMeta): void;
     error(msg: StringLike | Error, e?: Error | LogMeta, meta?: LogMeta): void;

package/lib/types/tasks/logging.d.mts

@@ -11,6 +11,21 @@ export declare class TaskLogger<LOG extends Logger> implements Logger {
     flush<PIPE extends LogPipe>(pipe?: PIPE): PIPE extends LogPipe ? Promise<[LogLevel, string, any][]> : [LogLevel, string, any][];
     readonly root: string[];
     benchmark(msg: StringLike): void;
+    /**
+     * @description Logs a named action event (delegated to the wrapped logger).
+     * @summary {@link TaskLogger} does not track `action()` events in its
+     * in-memory history — the call is forwarded verbatim to the underlying
+     * {@link Logger.action} implementation, which owns action-level handling.
+     * Because only the single wrapped call is proxied, the entire received
+     * argument set including the optional status code is passed through.
+     * @param {string} action The name of the action being recorded.
+     * @param {number} [code] Optional integer code annotating the action outcome.
+     * @param {LogMeta} [meta] Optional structured metadata for the action.
+     * @memberOf module:tasks.TaskLogger
+     * @method action
+     */
+    action(action: string, meta?: LogMeta): void;
+    action(action: string, code: number, meta?: LogMeta): void;
     clear(): this;
     debug(msg: StringLike, meta?: LogMeta): void;
     error(msg: StringLike | Error, e?: Error | LogMeta, meta?: LogMeta): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decaf-ts/core",
-  "version": "0.30.0",
+  "version": "0.30.2",
   "description": "Core persistence module for the decaf framework",
   "type": "module",
   "exports": {
@@ -114,6 +114,7 @@
     "repo:setup": "codex exec \"$(cat ./.codex/prompts/repo-setup.md)\nbase_path is ./\"",
     "repo:doc": "codex exec \"$(cat ./.codex/prompts/doc.md) $(cat ./.codex/prompts/bulk-docs.md)\nbase_path is ./\"",
     "repo:tests": "codex exec \"$(cat ./.codex/prompts/bulk-tests.md)\nbase_path is ./ and coverage is 95%\" -s workspace-write",
+    "prepare-it-tests": "echo \"prepare-it-tests: no infra to boot\"",
     "repo:readme": "codex exec \"$(cat ./.codex/prompts/update-readme.md)\nbase_path is ./\"",
     "repo:pr": "npm run repo:doc && npm run repo:tests && npm run repo:readme",
     "sync-codex": "./bin/sync-codex.sh"