@pithos/core 2.0.0 → 2.1.0

package/dist/autocompletion.d.ts

@@ -10,7 +10,7 @@
  * ❌ const distance = math.geometry.distance; // from autocompletion
  * ✅ import { distance } from 'pithos/math/geometry';
  * 
- * Generated on: 2026-02-22T16:49:34.264Z
+ * Generated on: 2026-03-04T07:03:41.432Z
  * */
 
 /** 
@@ -555,6 +555,17 @@ declare const _autocompletion: {
           };
         };
   };
+  bridges: {
+    ensure: {
+      ensure: typeof import('./bridges/ensure')['ensure'];
+    };
+    ensureAsync: {
+      ensureAsync: typeof import('./bridges/ensureAsync')['ensureAsync'];
+    };
+    ensurePromise: {
+      ensurePromise: typeof import('./bridges/ensurePromise')['ensurePromise'];
+    };
+  };
   kanon: {
     index: {
       any: typeof import('./kanon/index')['any'];
@@ -1589,6 +1600,15 @@ export default _autocompletion;
 declare const arkhe: typeof _autocompletion.arkhe;
 export { arkhe };
 
+/** 
+ * @deprecated ⚠️ For autocompletion only.
+ * Use direct imports from 'bridges/...' to preserve tree-shaking.
+ * @example
+ * import { ensure } from 'pithos/bridges/ensure';
+ */
+declare const bridges: typeof _autocompletion.bridges;
+export { bridges };
+
 /** 
  * @deprecated ⚠️ For autocompletion only.
  * Use direct imports from 'kanon/...' to preserve tree-shaking.

package/dist/bridges/ensure.d.ts

@@ -0,0 +1,28 @@
+import type { Schema } from "../kanon/types/base";
+import type { Result } from "../zygos/result/result";
+/**
+ * Parses a value against a Kanon schema and returns a Zygos `Result`.
+ *
+ * Bridge between Kanon validation and Zygos error handling:
+ * instead of checking `result.success`, you get a chainable `Result<T, string>`.
+ *
+ * @template T - The expected output type of the schema.
+ * @param schema - Kanon schema to validate against.
+ * @param input - Value to validate.
+ * @returns `Ok<T>` if validation succeeds, `Err<string>` otherwise.
+ * @since 2.1.0
+ *
+ * @example
+ * ```typescript
+ * import { ensure } from "pithos/bridges/ensure";
+ * import { object, string, number } from "pithos/kanon";
+ *
+ * const schema = object({ name: string(), age: number() });
+ *
+ * ensure(schema, data)
+ *   .map(user => user.name.toUpperCase())
+ *   .mapErr(error => `Validation failed: ${error}`);
+ * ```
+ */
+export declare function ensure<T>(schema: Schema<T>, input: unknown): Result<T, string>;
+//# sourceMappingURL=ensure.d.ts.map

package/dist/bridges/ensure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure.d.ts","sourceRoot":"","sources":["../../src/bridges/ensure.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,MAAM,CAAC,CAAC,EACtB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EACjB,KAAK,EAAE,OAAO,GACb,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAGnB"}

package/dist/bridges/ensure.js

@@ -0,0 +1,31 @@
+import { parse } from "../kanon/core/parser";
+import { ok, err } from "../zygos/result/result";
+/**
+ * Parses a value against a Kanon schema and returns a Zygos `Result`.
+ *
+ * Bridge between Kanon validation and Zygos error handling:
+ * instead of checking `result.success`, you get a chainable `Result<T, string>`.
+ *
+ * @template T - The expected output type of the schema.
+ * @param schema - Kanon schema to validate against.
+ * @param input - Value to validate.
+ * @returns `Ok<T>` if validation succeeds, `Err<string>` otherwise.
+ * @since 2.1.0
+ *
+ * @example
+ * ```typescript
+ * import { ensure } from "pithos/bridges/ensure";
+ * import { object, string, number } from "pithos/kanon";
+ *
+ * const schema = object({ name: string(), age: number() });
+ *
+ * ensure(schema, data)
+ *   .map(user => user.name.toUpperCase())
+ *   .mapErr(error => `Validation failed: ${error}`);
+ * ```
+ */
+export function ensure(schema, input) {
+    const result = parse(schema, input);
+    return result.success ? ok(result.data) : err(result.error);
+}
+//# sourceMappingURL=ensure.js.map

package/dist/bridges/ensure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure.js","sourceRoot":"","sources":["../../src/bridges/ensure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAI/C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,MAAM,CACpB,MAAiB,EACjB,KAAc;IAEd,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC"}

package/dist/bridges/ensureAsync.d.ts

@@ -0,0 +1,27 @@
+import type { Schema } from "../kanon/types/base";
+import type { ResultAsync } from "../zygos/result/result-async";
+/**
+ * Parses a value against a Kanon schema and returns a Zygos `ResultAsync`.
+ *
+ * Async variant of `ensure` — designed for `ResultAsync` chains
+ * where validation is one step in an async pipeline.
+ *
+ * @template T - The expected output type of the schema.
+ * @param schema - Kanon schema to validate against.
+ * @param input - Value to validate.
+ * @returns `OkAsync<T>` if validation succeeds, `ErrAsync<string>` otherwise.
+ * @since 2.1.0
+ *
+ * @example
+ * ```typescript
+ * import { ensureAsync } from "pithos/bridges/ensureAsync";
+ * import { object, string, number } from "pithos/kanon";
+ *
+ * safeFetch("/api/user")
+ *   .andThen(res => safeJson(res))
+ *   .andThen(data => ensureAsync(UserSchema, data))
+ *   .map(user => user.name);
+ * ```
+ */
+export declare function ensureAsync<T>(schema: Schema<T>, input: unknown): ResultAsync<T, string>;
+//# sourceMappingURL=ensureAsync.d.ts.map

package/dist/bridges/ensureAsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureAsync.d.ts","sourceRoot":"","sources":["../../src/bridges/ensureAsync.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EACjB,KAAK,EAAE,OAAO,GACb,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,CAGxB"}

package/dist/bridges/ensureAsync.js

@@ -0,0 +1,30 @@
+import { parse } from "../kanon/core/parser";
+import { okAsync, errAsync } from "../zygos/result/result-async";
+/**
+ * Parses a value against a Kanon schema and returns a Zygos `ResultAsync`.
+ *
+ * Async variant of `ensure` — designed for `ResultAsync` chains
+ * where validation is one step in an async pipeline.
+ *
+ * @template T - The expected output type of the schema.
+ * @param schema - Kanon schema to validate against.
+ * @param input - Value to validate.
+ * @returns `OkAsync<T>` if validation succeeds, `ErrAsync<string>` otherwise.
+ * @since 2.1.0
+ *
+ * @example
+ * ```typescript
+ * import { ensureAsync } from "pithos/bridges/ensureAsync";
+ * import { object, string, number } from "pithos/kanon";
+ *
+ * safeFetch("/api/user")
+ *   .andThen(res => safeJson(res))
+ *   .andThen(data => ensureAsync(UserSchema, data))
+ *   .map(user => user.name);
+ * ```
+ */
+export function ensureAsync(schema, input) {
+    const result = parse(schema, input);
+    return result.success ? okAsync(result.data) : errAsync(result.error);
+}
+//# sourceMappingURL=ensureAsync.js.map

package/dist/bridges/ensureAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureAsync.js","sourceRoot":"","sources":["../../src/bridges/ensureAsync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAI/D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,WAAW,CACzB,MAAiB,EACjB,KAAc;IAEd,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACxE,CAAC"}

package/dist/bridges/ensurePromise.d.ts

@@ -0,0 +1,28 @@
+import { ResultAsync } from "../zygos/result/result-async";
+import type { Schema } from "../kanon/types/base";
+/**
+ * Resolves a Promise, validates the result against a Kanon schema,
+ * and returns a `ResultAsync`.
+ *
+ * Eliminates the `ResultAsync.fromPromise(...).andThen(...)` boilerplate
+ * when you need to fetch data and validate it in one step.
+ *
+ * @template T - The expected output type of the schema.
+ * @param schema - Kanon schema to validate against.
+ * @param promise - Promise that resolves to the value to validate.
+ * @returns `ResultAsync<T, string>` — `Ok<T>` if the promise resolves and validation succeeds, `Err<string>` otherwise.
+ * @since 2.2.0
+ *
+ * @example
+ * ```typescript
+ * import { ensurePromise } from "pithos/bridges/ensurePromise";
+ * import { object, string, number } from "pithos/kanon";
+ *
+ * const UserSchema = object({ name: string(), age: number() });
+ *
+ * ensurePromise(UserSchema, fetch("/api/user").then(r => r.json()))
+ *   .map(user => user.name.toUpperCase());
+ * ```
+ */
+export declare function ensurePromise<T>(schema: Schema<T>, promise: Promise<unknown>): ResultAsync<T, string>;
+//# sourceMappingURL=ensurePromise.d.ts.map

package/dist/bridges/ensurePromise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensurePromise.d.ts","sourceRoot":"","sources":["../../src/bridges/ensurePromise.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAqB,MAAM,4BAA4B,CAAC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EACjB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GACxB,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,CAQxB"}

package/dist/bridges/ensurePromise.js

@@ -0,0 +1,33 @@
+import { parse } from "../kanon/core/parser";
+import { ResultAsync, okAsync, errAsync } from "../zygos/result/result-async";
+/**
+ * Resolves a Promise, validates the result against a Kanon schema,
+ * and returns a `ResultAsync`.
+ *
+ * Eliminates the `ResultAsync.fromPromise(...).andThen(...)` boilerplate
+ * when you need to fetch data and validate it in one step.
+ *
+ * @template T - The expected output type of the schema.
+ * @param schema - Kanon schema to validate against.
+ * @param promise - Promise that resolves to the value to validate.
+ * @returns `ResultAsync<T, string>` — `Ok<T>` if the promise resolves and validation succeeds, `Err<string>` otherwise.
+ * @since 2.2.0
+ *
+ * @example
+ * ```typescript
+ * import { ensurePromise } from "pithos/bridges/ensurePromise";
+ * import { object, string, number } from "pithos/kanon";
+ *
+ * const UserSchema = object({ name: string(), age: number() });
+ *
+ * ensurePromise(UserSchema, fetch("/api/user").then(r => r.json()))
+ *   .map(user => user.name.toUpperCase());
+ * ```
+ */
+export function ensurePromise(schema, promise) {
+    return ResultAsync.fromPromise(promise, (e) => e instanceof Error ? e.message : String(e)).andThen((data) => {
+        const result = parse(schema, data);
+        return result.success ? okAsync(result.data) : errAsync(result.error);
+    });
+}
+//# sourceMappingURL=ensurePromise.js.map

package/dist/bridges/ensurePromise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensurePromise.js","sourceRoot":"","sources":["../../src/bridges/ensurePromise.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAG5E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAiB,EACjB,OAAyB;IAEzB,OAAO,WAAW,CAAC,WAAW,CAC5B,OAAO,EACP,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAClD,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACjB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pithos/core",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Advanced JavaScript/TypeScript superset providing utilities, validation, and functional patterns",
   "publishConfig": {
     "access": "public"
@@ -25,6 +25,7 @@
     "./arkhe/types/performance/*": "./dist/arkhe/types/performance/*.js",
     "./arkhe/types/utilities/*": "./dist/arkhe/types/utilities/*.js",
     "./arkhe/util/*": "./dist/arkhe/util/*.js",
+    "./bridges/*": "./dist/bridges/*.js",
     "./kanon/core/consts/*": "./dist/kanon/core/consts/*.js",
     "./kanon/core/*": "./dist/kanon/core/*.js",
     "./kanon/helpers/*": "./dist/kanon/helpers/*.js",
@@ -70,7 +71,11 @@
     "utilities",
     "validation",
     "functional",
-    "ecosystem"
+    "ecosystem",
+    "lodash-alternative",
+    "zod-alternative",
+    "neverthrow-alternative",
+    "fp-ts-alternative"
   ],
   "author": "Pierre Moati <mopi1402>",
   "license": "MIT",
@@ -81,7 +86,7 @@
   "bugs": {
     "url": "https://github.com/mopi1402/pithos/issues"
   },
-  "homepage": "https://github.com/mopi1402/pithos#readme",
+  "homepage": "https://pithos.dev",
   "engines": {
     "node": ">=20.0.0"
   },