@feasibleone/blong 1.18.3 → 1.20.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [1.20.0](https://github.com/feasibleone/blong/compare/blong-v1.19.0...blong-v1.20.0) (2026-05-19)
+
+
+### Features
+
+* blong-dev ([8eb1aa4](https://github.com/feasibleone/blong/commit/8eb1aa4a8acb6a3dcdd52fb51582e0403efa4064))
+
+
+### Bug Fixes
+
+* lint ([8cde9a7](https://github.com/feasibleone/blong/commit/8cde9a7b9d54d4556bf33b4f8f61d5c5597ca108))
+* linting ([c45c515](https://github.com/feasibleone/blong/commit/c45c515c41d8dd7c9bb5b14e30a3d3e8afc75db8))
+* linting ([f5ae3f9](https://github.com/feasibleone/blong/commit/f5ae3f9b563c6090080bf58f9b224a1b626b160e))
+* linting ([fec5ee2](https://github.com/feasibleone/blong/commit/fec5ee2c4977e06a1d9d4d606dcb86dc9334aaa4))
+* linting ([27102ca](https://github.com/feasibleone/blong/commit/27102ca91ddf21124439452486a086aa68fc8886))
+
+## [1.19.0](https://github.com/feasibleone/blong/compare/blong-v1.18.3...blong-v1.19.0) (2026-05-15)
+
+
+### Features
+
+* snapshot testing ([ffae636](https://github.com/feasibleone/blong/commit/ffae6360d9f6a04b42e733fc6be291e1cd707bfa))
+
 ## [1.18.3](https://github.com/feasibleone/blong/compare/blong-v1.18.2...blong-v1.18.3) (2026-05-14)
 
 

package/dist/knex.js.map

@@ -1 +1 @@
-{"version":3,"file":"knex.js","sourceRoot":"","sources":["../knex.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,4EAA4E;AAC5E,6FAA6F;AAC7F,2BAA2B;AAu/F3B,eAAe,IAAI,CAAC;AACpB,OAAO,EAAC,IAAI,EAAC,CAAC"}
+{"version":3,"file":"knex.js","sourceRoot":"","sources":["../knex.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,4EAA4E;AAC5E,6FAA6F;AAC7F,2BAA2B;AAy/F3B,eAAe,IAAI,CAAC;AACpB,OAAO,EAAC,IAAI,EAAC,CAAC"}

package/dist/types.d.ts

@@ -12,7 +12,7 @@ import { Level, LogFn, Logger as PinoLogger } from 'pino';
 import React$1 from 'react';
 import { Readable, Writable } from 'stream';
 import { ConnectionOptions as ConnectionOptions_2, TLSSocket, TLSSocketOptions } from 'tls';
-import { Static, TArray, TBoolean, TFunction, TNever, TNumber, TObject, TSchema, TString, TUnknown, Type } from 'typebox';
+import { Static, TArray, TBoolean, TFunction, TIntersect, TNever, TNumber, TObject, TSchema, TString, TUnknown, Type } from 'typebox';
 
 export type Method = "GET" | "POST" | "PUT" | "DELETE";
 export interface RequestArgs {
@@ -18198,7 +18198,10 @@ export interface IPlatformApi {
 	configs: string[];
 }
 export interface IErrorFactory {
-	get(type?: string): unknown;
+	get(type?: string): Record<string | symbol, {
+		message: string;
+		print?: string;
+	} | string>;
 	fetch(type: string): object;
 	define(id: string, superType: string | {
 		type: string;
@@ -18265,7 +18268,7 @@ export interface IRpcServer {
 	setAttachCheckpoint?: (fn: ((meta: IMeta) => void) | undefined) => void;
 }
 export interface ILocal {
-	register: (methods: object, namespace: string, reply: boolean, pkg: {
+	register: (methods: Record<string, (...params: unknown[]) => Promise<unknown>> | Array<(...params: unknown[]) => Promise<unknown>>, namespace: string, reply: boolean, pkg: {
 		version: string;
 	}) => void;
 	unregister: (methods: string[], namespace: string) => void;
@@ -18329,11 +18332,11 @@ export interface IApi {
 	rpc: IRpcServer;
 	local: ILocal;
 	registry: IRegistry;
-	register: (methods: object, namespace: string, id: string, pkg: {
+	register: (methods: Record<string, (...params: unknown[]) => Promise<unknown>> | Array<(...params: unknown[]) => Promise<unknown>>, namespace: string, id: string, pkg: {
 		version: string;
 	}) => void;
 	unregister: (methods: string[], namespace: string) => void;
-	subscribe: (methods: object, namespace: string, id: string, pkg: {
+	subscribe: (methods: Record<string, (...params: unknown[]) => Promise<unknown>> | Array<(...params: unknown[]) => Promise<unknown>>, namespace: string, id: string, pkg: {
 		version: string;
 	}) => void;
 	unsubscribe: (methods: string[], namespace: string) => void;
@@ -18615,7 +18618,7 @@ export interface IStep {
 	method?: string;
 }
 export type Sequence = (boolean | string | IStep)[];
-export type ApiSchema = TObject | TArray | TBoolean | TString | TNumber | TUnknown;
+export type ApiSchema = TObject | TArray | TBoolean | TString | TNumber | TUnknown | TIntersect;
 export type GatewaySchema = ({
 	params: ApiSchema;
 	result: ApiSchema;
@@ -18648,7 +18651,24 @@ export type PathItemObject = OpenAPIV3_1.PathItemObject | OpenAPIV2.PathItemObje
 export type ThenableProxy = Promise<unknown> & {
 	[key: string]: ThenableProxy;
 };
-export type ChainStep = ((assert: typeof Assert, context: {
+/**
+ * Augmented assert passed to every chain step.  The `snapshot()` method is
+ * injected at runtime by the test executor, so handlers can call it directly
+ * without `(assert as any)` casts.  Import this type from `@feasibleone/blong`
+ * instead of `typeof Assert` from `node:assert` in test handlers.
+ */
+export type IAssert = typeof Assert & {
+	/**
+	 * Deferred (no-args): snapshot the step's return value under the step name.
+	 * Optional object form: `assert.snapshot({mask: ['id']})` adds a per-call mask.
+	 * Explicit form: `assert.snapshot(value, 'name', {mask?})` writes immediately.
+	 */
+	snapshot(valueOrOpts?: unknown, name?: string, opts?: {
+		mask?: string[];
+	}): void;
+	matchSnapshot(value: unknown, name?: string): void;
+};
+export type ChainStep = ((assert: IAssert, context: {
 	$meta: IMeta;
 } & Record<string, Promise<unknown[]> & ThenableProxy>) => Promise<object>) | object;
 export type CheckpointFn = (this: IMeta, name: string, data?: unknown) => void;
@@ -18658,11 +18678,39 @@ export interface ILib {
 	rename: <T extends object>(object: T, name: string) => T & {
 		name: string;
 	};
-	/** @deprecated The framework now auto-names step arrays from handler names. */
-	group: (name: string) => (handlers: ChainStep[]) => ChainStep[] & {
+	/**
+	 * Create a named group of chain steps.  The group name is used in test reports.
+	 * Optionally configure the group with `autoSnapshot: true` to automatically snapshot the
+	 * return the steps and the common mask to apply to all snapshots taken within the group.
+	 *
+	 * @param name
+	 * @param config
+	 * @returns
+	 */
+	group: (name: string, config?: {
+		autoSnapshot?: boolean;
+		mask?: string[];
+	}) => (handlers: ChainStep[]) => ChainStep[] & {
+		name: string;
+	};
+	/**
+	 * Create a named snapshot checkpoint marker to place inside a `group()` steps array.
+	 * Without extra arguments the `'*'` wildcard waits for all pending steps.
+	 * With step names only those steps are awaited before the context snapshot is taken.
+	 *
+	 * @example
+	 * group('my-test')([
+	 *   stepA,
+	 *   stepB,
+	 *   checkpoint('after-b', 'stepA', 'stepB'),  // wait for A & B, then snapshot
+	 *   stepC,
+	 *   checkpoint('final'),                        // wait for all, then snapshot
+	 * ])
+	 */
+	checkpoint: (name: string, ...markers: string[]) => string[] & {
 		name: string;
 	};
-	assert: typeof Assert | undefined;
+	assert: IAssert | undefined;
 	yaml: {
 		parse: <T>(source: string, options?: unknown) => T;
 		parseAllDocuments: <T>(source: string, options?: unknown) => T;

package/dist/types.js

@@ -16,7 +16,6 @@ export class Internal {
     async stop() {
         return this;
     }
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
     async start(..._args) {
         return this;
     }

package/dist/types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feasibleone/blong",
-  "version": "1.18.3",
+  "version": "1.20.0",
   "description": "API and DRY focused RAD framework https://feasibleone.github.io/blong-docs",
   "keywords": [
     "blong",
@@ -46,11 +46,12 @@
     "openapi-types": "^12.1.3",
     "react": "^19.1.0",
     "tarn": "^3.0.2",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "@feasibleone/blong-dev": "1.0.0"
   },
   "scripts": {
     "build": "heft build --clean;dts-bundle-generator --config dts-gen.config.json",
-    "ci-lint": "tsc --noEmit",
+    "ci-lint": "blong-dev lint",
     "ci-publish": "node ../../common/scripts/install-run-rush-pnpm.js publish --access public --provenance"
   }
 }

package/types.ts

@@ -16,6 +16,7 @@ import {
     type TArray,
     type TBoolean,
     type TFunction,
+    type TIntersect,
     type TNever,
     type TNumber,
     type TObject,
@@ -165,7 +166,7 @@ export interface IPlatformApi {
 }
 
 export interface IErrorFactory {
-    get(type?: string): unknown;
+    get(type?: string): Record<string | symbol, {message: string; print?: string} | string>;
     fetch(type: string): object;
     define(
         id: string,
@@ -237,7 +238,14 @@ export interface IRpcServer {
 }
 
 export interface ILocal {
-    register: (methods: object, namespace: string, reply: boolean, pkg: {version: string}) => void;
+    register: (
+        methods:
+            | Record<string, (...params: unknown[]) => Promise<unknown>>
+            | Array<(...params: unknown[]) => Promise<unknown>>,
+        namespace: string,
+        reply: boolean,
+        pkg: {version: string},
+    ) => void;
     unregister: (methods: string[], namespace: string) => void;
     get: (name: string) => {method: (...params: unknown[]) => Promise<unknown[]>};
 }
@@ -307,9 +315,23 @@ export interface IApi {
     rpc: IRpcServer;
     local: ILocal;
     registry: IRegistry;
-    register: (methods: object, namespace: string, id: string, pkg: {version: string}) => void;
+    register: (
+        methods:
+            | Record<string, (...params: unknown[]) => Promise<unknown>>
+            | Array<(...params: unknown[]) => Promise<unknown>>,
+        namespace: string,
+        id: string,
+        pkg: {version: string},
+    ) => void;
     unregister: (methods: string[], namespace: string) => void;
-    subscribe: (methods: object, namespace: string, id: string, pkg: {version: string}) => void;
+    subscribe: (
+        methods:
+            | Record<string, (...params: unknown[]) => Promise<unknown>>
+            | Array<(...params: unknown[]) => Promise<unknown>>,
+        namespace: string,
+        id: string,
+        pkg: {version: string},
+    ) => void;
     unsubscribe: (methods: string[], namespace: string) => void;
     dispatch: (...params: unknown[]) => boolean | Promise<unknown>;
     methodId: (name: string) => string;
@@ -636,7 +658,7 @@ export interface IStep {
 }
 export type Sequence = (boolean | string | IStep)[];
 
-export type ApiSchema = TObject | TArray | TBoolean | TString | TNumber | TUnknown;
+export type ApiSchema = TObject | TArray | TBoolean | TString | TNumber | TUnknown | TIntersect;
 
 export type GatewaySchema = (
     | {
@@ -675,9 +697,26 @@ export type GatewaySchema = (
 export type SchemaObject = OpenAPIV3_1.SchemaObject | OpenAPIV2.SchemaObject;
 export type PathItemObject = OpenAPIV3_1.PathItemObject | OpenAPIV2.PathItemObject;
 export type ThenableProxy = Promise<unknown> & {[key: string]: ThenableProxy};
+
+/**
+ * Augmented assert passed to every chain step.  The `snapshot()` method is
+ * injected at runtime by the test executor, so handlers can call it directly
+ * without `(assert as any)` casts.  Import this type from `@feasibleone/blong`
+ * instead of `typeof Assert` from `node:assert` in test handlers.
+ */
+export type IAssert = typeof Assert & {
+    /**
+     * Deferred (no-args): snapshot the step's return value under the step name.
+     * Optional object form: `assert.snapshot({mask: ['id']})` adds a per-call mask.
+     * Explicit form: `assert.snapshot(value, 'name', {mask?})` writes immediately.
+     */
+    snapshot(valueOrOpts?: unknown, name?: string, opts?: {mask?: string[]}): void;
+    matchSnapshot(value: unknown, name?: string): void;
+};
+
 export type ChainStep =
     | ((
-          assert: typeof Assert,
+          assert: IAssert,
           context: {
               $meta: IMeta;
           } & Record<string, Promise<unknown[]> & ThenableProxy>,
@@ -690,9 +729,35 @@ export interface ILib {
     type: typeof Type;
     error: <T>(errors: T) => Record<keyof T, (params?: unknown, $meta?: IMeta) => ITypedError>;
     rename: <T extends object>(object: T, name: string) => T & {name: string};
-    /** @deprecated The framework now auto-names step arrays from handler names. */
-    group: (name: string) => (handlers: ChainStep[]) => ChainStep[] & {name: string};
-    assert: typeof Assert | undefined;
+    /**
+     * Create a named group of chain steps.  The group name is used in test reports.
+     * Optionally configure the group with `autoSnapshot: true` to automatically snapshot the
+     * return the steps and the common mask to apply to all snapshots taken within the group.
+     *
+     * @param name
+     * @param config
+     * @returns
+     */
+    group: (
+        name: string,
+        config?: {autoSnapshot?: boolean; mask?: string[]},
+    ) => (handlers: ChainStep[]) => ChainStep[] & {name: string};
+    /**
+     * Create a named snapshot checkpoint marker to place inside a `group()` steps array.
+     * Without extra arguments the `'*'` wildcard waits for all pending steps.
+     * With step names only those steps are awaited before the context snapshot is taken.
+     *
+     * @example
+     * group('my-test')([
+     *   stepA,
+     *   stepB,
+     *   checkpoint('after-b', 'stepA', 'stepB'),  // wait for A & B, then snapshot
+     *   stepC,
+     *   checkpoint('final'),                        // wait for all, then snapshot
+     * ])
+     */
+    checkpoint: (name: string, ...markers: string[]) => string[] & {name: string};
+    assert: IAssert | undefined;
     yaml: {
         parse: <T>(source: string, options?: unknown) => T;
         parseAllDocuments: <T>(source: string, options?: unknown) => T;
@@ -829,7 +894,6 @@ export abstract class Internal {
     public async stop(): Promise<unknown> {
         return this;
     }
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
     public async start(..._args: unknown[]): Promise<unknown> {
         return this;
     }