@epsilon-asi/foundation 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Epsilon ASI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,10 @@
+# @epsilon-asi/foundation
+
+Shared isomorphic utilities intended for both browser and Node.js consumers.
+
+```ts
+import { createPackageName, ok, unwrapOr } from '@epsilon-asi/foundation';
+
+const packageName = createPackageName('epsilon-asi', 'SYSTEM');
+const value = unwrapOr(ok(packageName), '@epsilon-asi/unknown');
+```

package/dist/index.cjs

@@ -0,0 +1,49 @@
+'use strict';
+
+// src/result.ts
+function ok(value) {
+  return { ok: true, value };
+}
+function err(error) {
+  return { ok: false, error };
+}
+function isOk(result) {
+  return result.ok;
+}
+function isErr(result) {
+  return !result.ok;
+}
+function mapResult(result, mapper) {
+  return isOk(result) ? ok(mapper(result.value)) : result;
+}
+function unwrapOr(result, fallback) {
+  return isOk(result) ? result.value : fallback;
+}
+
+// src/strings.ts
+function toKebabCase(input) {
+  return input.trim().replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").toLowerCase();
+}
+function createPackageName(scope, packageName) {
+  const normalizedScope = toKebabCase(scope.replace(/^@/, ""));
+  const normalizedPackage = toKebabCase(packageName);
+  return `@${normalizedScope}/${normalizedPackage}`;
+}
+
+// src/versioning.ts
+function createVersionedName(name, version) {
+  const normalizedName = toKebabCase(name);
+  return `${normalizedName}@${version}`;
+}
+
+exports.createPackageName = createPackageName;
+exports.createVersionedName = createVersionedName;
+exports.err = err;
+exports.isErr = isErr;
+exports.isOk = isOk;
+exports.mapResult = mapResult;
+exports.ok = ok;
+exports.toKebabCase = toKebabCase;
+exports.unwrapOr = unwrapOr;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/result.ts","../src/strings.ts","../src/versioning.ts"],"names":[],"mappings":";;;AAYO,SAAS,GAAM,KAAA,EAAiB;AACrC,EAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,KAAA,EAAM;AAC3B;AAEO,SAAS,IAAqB,KAAA,EAAkB;AACrD,EAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,KAAA,EAAM;AAC5B;AAEO,SAAS,KAAyB,MAAA,EAAuC;AAC9E,EAAA,OAAO,MAAA,CAAO,EAAA;AAChB;AAEO,SAAS,MAA0B,MAAA,EAAwC;AAChF,EAAA,OAAO,CAAC,MAAA,CAAO,EAAA;AACjB;AAEO,SAAS,SAAA,CACd,QACA,MAAA,EACc;AACd,EAAA,OAAO,IAAA,CAAK,MAAM,CAAA,GAAI,EAAA,CAAG,OAAO,MAAA,CAAO,KAAK,CAAC,CAAA,GAAI,MAAA;AACnD;AAEO,SAAS,QAAA,CAA6B,QAAsB,QAAA,EAAgB;AACjF,EAAA,OAAO,IAAA,CAAK,MAAM,CAAA,GAAI,MAAA,CAAO,KAAA,GAAQ,QAAA;AACvC;;;ACrCO,SAAS,YAAY,KAAA,EAAuB;AACjD,EAAA,OAAO,MACJ,IAAA,EAAK,CACL,QAAQ,oBAAA,EAAsB,OAAO,EACrC,OAAA,CAAQ,SAAA,EAAW,GAAG,CAAA,CACtB,OAAA,CAAQ,OAAO,GAAG,CAAA,CAClB,QAAQ,QAAA,EAAU,EAAE,EACpB,WAAA,EAAY;AACjB;AAEO,SAAS,iBAAA,CAAkB,OAAe,WAAA,EAA6C;AAC5F,EAAA,MAAM,kBAAkB,WAAA,CAAY,KAAA,CAAM,OAAA,CAAQ,IAAA,EAAM,EAAE,CAAC,CAAA;AAC3D,EAAA,MAAM,iBAAA,GAAoB,YAAY,WAAW,CAAA;AAEjD,EAAA,OAAO,CAAA,CAAA,EAAI,eAAe,CAAA,CAAA,EAAI,iBAAiB,CAAA,CAAA;AACjD;;;ACbO,SAAS,mBAAA,CAAoB,MAAc,OAAA,EAAyB;AACzE,EAAA,MAAM,cAAA,GAAiB,YAAY,IAAI,CAAA;AACvC,EAAA,OAAO,CAAA,EAAG,cAAc,CAAA,CAAA,EAAI,OAAO,CAAA,CAAA;AACrC","file":"index.cjs","sourcesContent":["export type Ok<T> = Readonly<{\n  ok: true;\n  value: T;\n}>;\n\nexport type Err<E extends Error = Error> = Readonly<{\n  ok: false;\n  error: E;\n}>;\n\nexport type Result<T, E extends Error = Error> = Ok<T> | Err<E>;\n\nexport function ok<T>(value: T): Ok<T> {\n  return { ok: true, value };\n}\n\nexport function err<E extends Error>(error: E): Err<E> {\n  return { ok: false, error };\n}\n\nexport function isOk<T, E extends Error>(result: Result<T, E>): result is Ok<T> {\n  return result.ok;\n}\n\nexport function isErr<T, E extends Error>(result: Result<T, E>): result is Err<E> {\n  return !result.ok;\n}\n\nexport function mapResult<T, U, E extends Error>(\n  result: Result<T, E>,\n  mapper: (value: T) => U\n): Result<U, E> {\n  return isOk(result) ? ok(mapper(result.value)) : result;\n}\n\nexport function unwrapOr<T, E extends Error>(result: Result<T, E>, fallback: T): T {\n  return isOk(result) ? result.value : fallback;\n}\n","export function toKebabCase(input: string): string {\n  return input\n    .trim()\n    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')\n    .replace(/[\\s_]+/g, '-')\n    .replace(/-+/g, '-')\n    .replace(/^-|-$/g, '')\n    .toLowerCase();\n}\n\nexport function createPackageName(scope: string, packageName: string): `@${string}/${string}` {\n  const normalizedScope = toKebabCase(scope.replace(/^@/, ''));\n  const normalizedPackage = toKebabCase(packageName);\n\n  return `@${normalizedScope}/${normalizedPackage}`;\n}\n","import { toKebabCase } from './strings.js';\n\nexport function createVersionedName(name: string, version: string): string {\n  const normalizedName = toKebabCase(name);\n  return `${normalizedName}@${version}`;\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export type { Err, Ok, Result } from './result.js';
+export { err, isErr, isOk, mapResult, ok, unwrapOr } from './result.js';
+export { createPackageName, toKebabCase } from './strings.js';
+export { createVersionedName } from './versioning.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,39 @@
+// src/result.ts
+function ok(value) {
+  return { ok: true, value };
+}
+function err(error) {
+  return { ok: false, error };
+}
+function isOk(result) {
+  return result.ok;
+}
+function isErr(result) {
+  return !result.ok;
+}
+function mapResult(result, mapper) {
+  return isOk(result) ? ok(mapper(result.value)) : result;
+}
+function unwrapOr(result, fallback) {
+  return isOk(result) ? result.value : fallback;
+}
+
+// src/strings.ts
+function toKebabCase(input) {
+  return input.trim().replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").toLowerCase();
+}
+function createPackageName(scope, packageName) {
+  const normalizedScope = toKebabCase(scope.replace(/^@/, ""));
+  const normalizedPackage = toKebabCase(packageName);
+  return `@${normalizedScope}/${normalizedPackage}`;
+}
+
+// src/versioning.ts
+function createVersionedName(name, version) {
+  const normalizedName = toKebabCase(name);
+  return `${normalizedName}@${version}`;
+}
+
+export { createPackageName, createVersionedName, err, isErr, isOk, mapResult, ok, toKebabCase, unwrapOr };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/result.ts","../src/strings.ts","../src/versioning.ts"],"names":[],"mappings":";AAYO,SAAS,GAAM,KAAA,EAAiB;AACrC,EAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,KAAA,EAAM;AAC3B;AAEO,SAAS,IAAqB,KAAA,EAAkB;AACrD,EAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,KAAA,EAAM;AAC5B;AAEO,SAAS,KAAyB,MAAA,EAAuC;AAC9E,EAAA,OAAO,MAAA,CAAO,EAAA;AAChB;AAEO,SAAS,MAA0B,MAAA,EAAwC;AAChF,EAAA,OAAO,CAAC,MAAA,CAAO,EAAA;AACjB;AAEO,SAAS,SAAA,CACd,QACA,MAAA,EACc;AACd,EAAA,OAAO,IAAA,CAAK,MAAM,CAAA,GAAI,EAAA,CAAG,OAAO,MAAA,CAAO,KAAK,CAAC,CAAA,GAAI,MAAA;AACnD;AAEO,SAAS,QAAA,CAA6B,QAAsB,QAAA,EAAgB;AACjF,EAAA,OAAO,IAAA,CAAK,MAAM,CAAA,GAAI,MAAA,CAAO,KAAA,GAAQ,QAAA;AACvC;;;ACrCO,SAAS,YAAY,KAAA,EAAuB;AACjD,EAAA,OAAO,MACJ,IAAA,EAAK,CACL,QAAQ,oBAAA,EAAsB,OAAO,EACrC,OAAA,CAAQ,SAAA,EAAW,GAAG,CAAA,CACtB,OAAA,CAAQ,OAAO,GAAG,CAAA,CAClB,QAAQ,QAAA,EAAU,EAAE,EACpB,WAAA,EAAY;AACjB;AAEO,SAAS,iBAAA,CAAkB,OAAe,WAAA,EAA6C;AAC5F,EAAA,MAAM,kBAAkB,WAAA,CAAY,KAAA,CAAM,OAAA,CAAQ,IAAA,EAAM,EAAE,CAAC,CAAA;AAC3D,EAAA,MAAM,iBAAA,GAAoB,YAAY,WAAW,CAAA;AAEjD,EAAA,OAAO,CAAA,CAAA,EAAI,eAAe,CAAA,CAAA,EAAI,iBAAiB,CAAA,CAAA;AACjD;;;ACbO,SAAS,mBAAA,CAAoB,MAAc,OAAA,EAAyB;AACzE,EAAA,MAAM,cAAA,GAAiB,YAAY,IAAI,CAAA;AACvC,EAAA,OAAO,CAAA,EAAG,cAAc,CAAA,CAAA,EAAI,OAAO,CAAA,CAAA;AACrC","file":"index.js","sourcesContent":["export type Ok<T> = Readonly<{\n  ok: true;\n  value: T;\n}>;\n\nexport type Err<E extends Error = Error> = Readonly<{\n  ok: false;\n  error: E;\n}>;\n\nexport type Result<T, E extends Error = Error> = Ok<T> | Err<E>;\n\nexport function ok<T>(value: T): Ok<T> {\n  return { ok: true, value };\n}\n\nexport function err<E extends Error>(error: E): Err<E> {\n  return { ok: false, error };\n}\n\nexport function isOk<T, E extends Error>(result: Result<T, E>): result is Ok<T> {\n  return result.ok;\n}\n\nexport function isErr<T, E extends Error>(result: Result<T, E>): result is Err<E> {\n  return !result.ok;\n}\n\nexport function mapResult<T, U, E extends Error>(\n  result: Result<T, E>,\n  mapper: (value: T) => U\n): Result<U, E> {\n  return isOk(result) ? ok(mapper(result.value)) : result;\n}\n\nexport function unwrapOr<T, E extends Error>(result: Result<T, E>, fallback: T): T {\n  return isOk(result) ? result.value : fallback;\n}\n","export function toKebabCase(input: string): string {\n  return input\n    .trim()\n    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')\n    .replace(/[\\s_]+/g, '-')\n    .replace(/-+/g, '-')\n    .replace(/^-|-$/g, '')\n    .toLowerCase();\n}\n\nexport function createPackageName(scope: string, packageName: string): `@${string}/${string}` {\n  const normalizedScope = toKebabCase(scope.replace(/^@/, ''));\n  const normalizedPackage = toKebabCase(packageName);\n\n  return `@${normalizedScope}/${normalizedPackage}`;\n}\n","import { toKebabCase } from './strings.js';\n\nexport function createVersionedName(name: string, version: string): string {\n  const normalizedName = toKebabCase(name);\n  return `${normalizedName}@${version}`;\n}\n"]}

package/dist/result.d.ts

@@ -0,0 +1,16 @@
+export type Ok<T> = Readonly<{
+    ok: true;
+    value: T;
+}>;
+export type Err<E extends Error = Error> = Readonly<{
+    ok: false;
+    error: E;
+}>;
+export type Result<T, E extends Error = Error> = Ok<T> | Err<E>;
+export declare function ok<T>(value: T): Ok<T>;
+export declare function err<E extends Error>(error: E): Err<E>;
+export declare function isOk<T, E extends Error>(result: Result<T, E>): result is Ok<T>;
+export declare function isErr<T, E extends Error>(result: Result<T, E>): result is Err<E>;
+export declare function mapResult<T, U, E extends Error>(result: Result<T, E>, mapper: (value: T) => U): Result<U, E>;
+export declare function unwrapOr<T, E extends Error>(result: Result<T, E>, fallback: T): T;
+//# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,EAAE,CAAC,CAAC,IAAI,QAAQ,CAAC;IAC3B,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,CAAC,CAAC;CACV,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,IAAI,QAAQ,CAAC;IAClD,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,CAAC,CAAC;CACV,CAAC,CAAC;AAEH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,KAAK,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;AAEhE,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAErC;AAED,wBAAgB,GAAG,CAAC,CAAC,SAAS,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAErD;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,SAAS,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,CAE9E;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,SAAS,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAEhF;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,KAAK,EAC7C,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GACtB,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAEd;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAEjF"}

package/dist/strings.d.ts

@@ -0,0 +1,3 @@
+export declare function toKebabCase(input: string): string;
+export declare function createPackageName(scope: string, packageName: string): `@${string}/${string}`;
+//# sourceMappingURL=strings.d.ts.map

package/dist/strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../src/strings.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,MAAM,IAAI,MAAM,EAAE,CAK5F"}

package/dist/versioning.d.ts

@@ -0,0 +1,2 @@
+export declare function createVersionedName(name: string, version: string): string;
+//# sourceMappingURL=versioning.d.ts.map

package/dist/versioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.d.ts","sourceRoot":"","sources":["../src/versioning.ts"],"names":[],"mappings":"AAEA,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGzE"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@epsilon-asi/foundation",
+  "version": "0.1.0",
+  "description": "Isomorphic shared primitives for Epsilon ASI browser and backend packages.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup && tsc -p tsconfig.build.json",
+    "clean": "rimraf dist coverage",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "test:unit": "vitest run test/unit",
+    "test:integration": "vitest run test/integration",
+    "test:coverage": "vitest run --coverage"
+  }
+}