@pi-ohm/core 0.6.4-dev.22269206811.1.0e8e307

package/README.md

@@ -0,0 +1,9 @@
+# @pi-ohm/core
+
+Internal shared runtime primitives for pi-ohm packages.
+
+Current module:
+
+- `@pi-ohm/core/errors`
+- `@pi-ohm/core/grammar`
+- `@pi-ohm/core/paths`

package/dist/errors.d.ts

@@ -0,0 +1,75 @@
+import * as better_result0 from "better-result";
+import { Result } from "better-result";
+
+//#region src/errors.d.ts
+type CoreErrorMeta = Record<string, unknown>;
+declare const CoreValidationError_base: better_result0.TaggedErrorClass<"CoreValidationError", {
+  code: string;
+  message: string;
+  path?: string;
+  cause?: unknown;
+  meta?: CoreErrorMeta;
+}>;
+declare class CoreValidationError extends CoreValidationError_base {
+  constructor(args: {
+    code: string;
+    path?: string;
+    message?: string;
+    cause?: unknown;
+    meta?: CoreErrorMeta;
+  });
+}
+declare const CorePolicyError_base: better_result0.TaggedErrorClass<"CorePolicyError", {
+  code: string;
+  message: string;
+  action?: string;
+  cause?: unknown;
+  meta?: CoreErrorMeta;
+}>;
+declare class CorePolicyError extends CorePolicyError_base {
+  constructor(args: {
+    code: string;
+    action?: string;
+    message?: string;
+    cause?: unknown;
+    meta?: CoreErrorMeta;
+  });
+}
+declare const CoreRuntimeError_base: better_result0.TaggedErrorClass<"CoreRuntimeError", {
+  code: string;
+  message: string;
+  stage?: string;
+  cause?: unknown;
+  meta?: CoreErrorMeta;
+}>;
+declare class CoreRuntimeError extends CoreRuntimeError_base {
+  constructor(args: {
+    code: string;
+    stage?: string;
+    message?: string;
+    cause?: unknown;
+    meta?: CoreErrorMeta;
+  });
+}
+declare const CorePersistenceError_base: better_result0.TaggedErrorClass<"CorePersistenceError", {
+  code: string;
+  message: string;
+  resource?: string;
+  cause?: unknown;
+  meta?: CoreErrorMeta;
+}>;
+declare class CorePersistenceError extends CorePersistenceError_base {
+  constructor(args: {
+    code: string;
+    resource?: string;
+    message?: string;
+    cause?: unknown;
+    meta?: CoreErrorMeta;
+  });
+}
+type CoreError = CoreValidationError | CorePolicyError | CoreRuntimeError | CorePersistenceError;
+type CoreResult<T, E extends CoreError = CoreError> = Result<T, E>;
+declare function isCoreError(value: unknown): value is CoreError;
+//#endregion
+export { CoreError, CoreErrorMeta, CorePersistenceError, CorePolicyError, CoreResult, CoreRuntimeError, CoreValidationError, isCoreError };
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.js

@@ -0,0 +1,63 @@
+import { TaggedError } from "better-result";
+
+//#region src/errors.ts
+function messageFromCause(cause) {
+	if (cause instanceof Error && cause.message.trim().length > 0) return cause.message;
+	if (typeof cause === "string" && cause.trim().length > 0) return cause;
+	return String(cause);
+}
+var CoreValidationError = class extends TaggedError("CoreValidationError")() {
+	constructor(args) {
+		const derivedMessage = args.message ?? (args.cause ? `Validation failed (${args.code}): ${messageFromCause(args.cause)}` : `Validation failed (${args.code})`);
+		super({
+			code: args.code,
+			path: args.path,
+			cause: args.cause,
+			meta: args.meta,
+			message: derivedMessage
+		});
+	}
+};
+var CorePolicyError = class extends TaggedError("CorePolicyError")() {
+	constructor(args) {
+		const derivedMessage = args.message ?? (args.cause ? `Policy denied (${args.code}): ${messageFromCause(args.cause)}` : `Policy denied (${args.code})`);
+		super({
+			code: args.code,
+			action: args.action,
+			cause: args.cause,
+			meta: args.meta,
+			message: derivedMessage
+		});
+	}
+};
+var CoreRuntimeError = class extends TaggedError("CoreRuntimeError")() {
+	constructor(args) {
+		const derivedMessage = args.message ?? (args.cause ? `Runtime failure (${args.code}): ${messageFromCause(args.cause)}` : `Runtime failure (${args.code})`);
+		super({
+			code: args.code,
+			stage: args.stage,
+			cause: args.cause,
+			meta: args.meta,
+			message: derivedMessage
+		});
+	}
+};
+var CorePersistenceError = class extends TaggedError("CorePersistenceError")() {
+	constructor(args) {
+		const derivedMessage = args.message ?? (args.cause ? `Persistence failure (${args.code}): ${messageFromCause(args.cause)}` : `Persistence failure (${args.code})`);
+		super({
+			code: args.code,
+			resource: args.resource,
+			cause: args.cause,
+			meta: args.meta,
+			message: derivedMessage
+		});
+	}
+};
+function isCoreError(value) {
+	return CoreValidationError.is(value) || CorePolicyError.is(value) || CoreRuntimeError.is(value) || CorePersistenceError.is(value);
+}
+
+//#endregion
+export { CorePersistenceError, CorePolicyError, CoreRuntimeError, CoreValidationError, isCoreError };
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["import { TaggedError, type Result } from \"better-result\";\n\nexport type CoreErrorMeta = Record<string, unknown>;\n\nfunction messageFromCause(cause: unknown): string {\n  if (cause instanceof Error && cause.message.trim().length > 0) return cause.message;\n  if (typeof cause === \"string\" && cause.trim().length > 0) return cause;\n  return String(cause);\n}\n\nexport class CoreValidationError extends TaggedError(\"CoreValidationError\")<{\n  code: string;\n  message: string;\n  path?: string;\n  cause?: unknown;\n  meta?: CoreErrorMeta;\n}>() {\n  constructor(args: {\n    code: string;\n    path?: string;\n    message?: string;\n    cause?: unknown;\n    meta?: CoreErrorMeta;\n  }) {\n    const derivedMessage =\n      args.message ??\n      (args.cause\n        ? `Validation failed (${args.code}): ${messageFromCause(args.cause)}`\n        : `Validation failed (${args.code})`);\n\n    super({\n      code: args.code,\n      path: args.path,\n      cause: args.cause,\n      meta: args.meta,\n      message: derivedMessage,\n    });\n  }\n}\n\nexport class CorePolicyError extends TaggedError(\"CorePolicyError\")<{\n  code: string;\n  message: string;\n  action?: string;\n  cause?: unknown;\n  meta?: CoreErrorMeta;\n}>() {\n  constructor(args: {\n    code: string;\n    action?: string;\n    message?: string;\n    cause?: unknown;\n    meta?: CoreErrorMeta;\n  }) {\n    const derivedMessage =\n      args.message ??\n      (args.cause\n        ? `Policy denied (${args.code}): ${messageFromCause(args.cause)}`\n        : `Policy denied (${args.code})`);\n\n    super({\n      code: args.code,\n      action: args.action,\n      cause: args.cause,\n      meta: args.meta,\n      message: derivedMessage,\n    });\n  }\n}\n\nexport class CoreRuntimeError extends TaggedError(\"CoreRuntimeError\")<{\n  code: string;\n  message: string;\n  stage?: string;\n  cause?: unknown;\n  meta?: CoreErrorMeta;\n}>() {\n  constructor(args: {\n    code: string;\n    stage?: string;\n    message?: string;\n    cause?: unknown;\n    meta?: CoreErrorMeta;\n  }) {\n    const derivedMessage =\n      args.message ??\n      (args.cause\n        ? `Runtime failure (${args.code}): ${messageFromCause(args.cause)}`\n        : `Runtime failure (${args.code})`);\n\n    super({\n      code: args.code,\n      stage: args.stage,\n      cause: args.cause,\n      meta: args.meta,\n      message: derivedMessage,\n    });\n  }\n}\n\nexport class CorePersistenceError extends TaggedError(\"CorePersistenceError\")<{\n  code: string;\n  message: string;\n  resource?: string;\n  cause?: unknown;\n  meta?: CoreErrorMeta;\n}>() {\n  constructor(args: {\n    code: string;\n    resource?: string;\n    message?: string;\n    cause?: unknown;\n    meta?: CoreErrorMeta;\n  }) {\n    const derivedMessage =\n      args.message ??\n      (args.cause\n        ? `Persistence failure (${args.code}): ${messageFromCause(args.cause)}`\n        : `Persistence failure (${args.code})`);\n\n    super({\n      code: args.code,\n      resource: args.resource,\n      cause: args.cause,\n      meta: args.meta,\n      message: derivedMessage,\n    });\n  }\n}\n\nexport type CoreError =\n  | CoreValidationError\n  | CorePolicyError\n  | CoreRuntimeError\n  | CorePersistenceError;\n\nexport type CoreResult<T, E extends CoreError = CoreError> = Result<T, E>;\n\nexport function isCoreError(value: unknown): value is CoreError {\n  return (\n    CoreValidationError.is(value) ||\n    CorePolicyError.is(value) ||\n    CoreRuntimeError.is(value) ||\n    CorePersistenceError.is(value)\n  );\n}\n"],"mappings":";;;AAIA,SAAS,iBAAiB,OAAwB;AAChD,KAAI,iBAAiB,SAAS,MAAM,QAAQ,MAAM,CAAC,SAAS,EAAG,QAAO,MAAM;AAC5E,KAAI,OAAO,UAAU,YAAY,MAAM,MAAM,CAAC,SAAS,EAAG,QAAO;AACjE,QAAO,OAAO,MAAM;;AAGtB,IAAa,sBAAb,cAAyC,YAAY,sBAAsB,EAMvE,CAAC;CACH,YAAY,MAMT;EACD,MAAM,iBACJ,KAAK,YACJ,KAAK,QACF,sBAAsB,KAAK,KAAK,KAAK,iBAAiB,KAAK,MAAM,KACjE,sBAAsB,KAAK,KAAK;AAEtC,QAAM;GACJ,MAAM,KAAK;GACX,MAAM,KAAK;GACX,OAAO,KAAK;GACZ,MAAM,KAAK;GACX,SAAS;GACV,CAAC;;;AAIN,IAAa,kBAAb,cAAqC,YAAY,kBAAkB,EAM/D,CAAC;CACH,YAAY,MAMT;EACD,MAAM,iBACJ,KAAK,YACJ,KAAK,QACF,kBAAkB,KAAK,KAAK,KAAK,iBAAiB,KAAK,MAAM,KAC7D,kBAAkB,KAAK,KAAK;AAElC,QAAM;GACJ,MAAM,KAAK;GACX,QAAQ,KAAK;GACb,OAAO,KAAK;GACZ,MAAM,KAAK;GACX,SAAS;GACV,CAAC;;;AAIN,IAAa,mBAAb,cAAsC,YAAY,mBAAmB,EAMjE,CAAC;CACH,YAAY,MAMT;EACD,MAAM,iBACJ,KAAK,YACJ,KAAK,QACF,oBAAoB,KAAK,KAAK,KAAK,iBAAiB,KAAK,MAAM,KAC/D,oBAAoB,KAAK,KAAK;AAEpC,QAAM;GACJ,MAAM,KAAK;GACX,OAAO,KAAK;GACZ,OAAO,KAAK;GACZ,MAAM,KAAK;GACX,SAAS;GACV,CAAC;;;AAIN,IAAa,uBAAb,cAA0C,YAAY,uBAAuB,EAMzE,CAAC;CACH,YAAY,MAMT;EACD,MAAM,iBACJ,KAAK,YACJ,KAAK,QACF,wBAAwB,KAAK,KAAK,KAAK,iBAAiB,KAAK,MAAM,KACnE,wBAAwB,KAAK,KAAK;AAExC,QAAM;GACJ,MAAM,KAAK;GACX,UAAU,KAAK;GACf,OAAO,KAAK;GACZ,MAAM,KAAK;GACX,SAAS;GACV,CAAC;;;AAYN,SAAgB,YAAY,OAAoC;AAC9D,QACE,oBAAoB,GAAG,MAAM,IAC7B,gBAAgB,GAAG,MAAM,IACzB,iBAAiB,GAAG,MAAM,IAC1B,qBAAqB,GAAG,MAAM"}

package/dist/grammar.d.ts

@@ -0,0 +1,10 @@
+//#region src/grammar.d.ts
+declare function pluralSuffix(count: number): "" | "s";
+declare function withCountNoun(input: {
+  readonly count: number;
+  readonly singular: string;
+  readonly plural?: string;
+}): string;
+//#endregion
+export { pluralSuffix, withCountNoun };
+//# sourceMappingURL=grammar.d.ts.map

package/dist/grammar.js

@@ -0,0 +1,12 @@
+//#region src/grammar.ts
+function pluralSuffix(count) {
+	return count === 1 ? "" : "s";
+}
+function withCountNoun(input) {
+	const noun = input.plural ?? `${input.singular}${pluralSuffix(input.count)}`;
+	return `${input.count} ${noun}`;
+}
+
+//#endregion
+export { pluralSuffix, withCountNoun };
+//# sourceMappingURL=grammar.js.map

package/dist/grammar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammar.js","names":[],"sources":["../src/grammar.ts"],"sourcesContent":["export function pluralSuffix(count: number): \"\" | \"s\" {\n  return count === 1 ? \"\" : \"s\";\n}\n\nexport function withCountNoun(input: {\n  readonly count: number;\n  readonly singular: string;\n  readonly plural?: string;\n}): string {\n  const noun = input.plural ?? `${input.singular}${pluralSuffix(input.count)}`;\n  return `${input.count} ${noun}`;\n}\n"],"mappings":";AAAA,SAAgB,aAAa,OAAyB;AACpD,QAAO,UAAU,IAAI,KAAK;;AAG5B,SAAgB,cAAc,OAInB;CACT,MAAM,OAAO,MAAM,UAAU,GAAG,MAAM,WAAW,aAAa,MAAM,MAAM;AAC1E,QAAO,GAAG,MAAM,MAAM,GAAG"}

package/dist/paths.d.ts

@@ -0,0 +1,9 @@
+//#region src/paths.d.ts
+interface ResolveOhmDataHomeInput {
+  readonly env?: NodeJS.ProcessEnv;
+}
+declare function resolveOhmDataHome(input?: ResolveOhmDataHomeInput): string;
+declare function resolveOhmAgentDataHome(input?: ResolveOhmDataHomeInput): string;
+//#endregion
+export { ResolveOhmDataHomeInput, resolveOhmAgentDataHome, resolveOhmDataHome };
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.js

@@ -0,0 +1,23 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+//#region src/paths.ts
+function readNonEmptyEnv(env, name) {
+	const raw = env[name];
+	if (!raw) return void 0;
+	const trimmed = raw.trim();
+	if (trimmed.length === 0) return void 0;
+	return trimmed;
+}
+function resolveOhmDataHome(input = {}) {
+	const xdgDataHome = readNonEmptyEnv(input.env ?? process.env, "XDG_DATA_HOME");
+	if (xdgDataHome) return join(xdgDataHome, "pi-ohm");
+	return join(homedir(), ".local", "share", "pi-ohm");
+}
+function resolveOhmAgentDataHome(input = {}) {
+	return join(resolveOhmDataHome(input), "agent");
+}
+
+//#endregion
+export { resolveOhmAgentDataHome, resolveOhmDataHome };
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","names":[],"sources":["../src/paths.ts"],"sourcesContent":["import { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\nexport interface ResolveOhmDataHomeInput {\n  readonly env?: NodeJS.ProcessEnv;\n}\n\nfunction readNonEmptyEnv(env: NodeJS.ProcessEnv, name: string): string | undefined {\n  const raw = env[name];\n  if (!raw) return undefined;\n  const trimmed = raw.trim();\n  if (trimmed.length === 0) return undefined;\n  return trimmed;\n}\n\nexport function resolveOhmDataHome(input: ResolveOhmDataHomeInput = {}): string {\n  const env = input.env ?? process.env;\n  const xdgDataHome = readNonEmptyEnv(env, \"XDG_DATA_HOME\");\n\n  if (xdgDataHome) {\n    return join(xdgDataHome, \"pi-ohm\");\n  }\n\n  return join(homedir(), \".local\", \"share\", \"pi-ohm\");\n}\n\nexport function resolveOhmAgentDataHome(input: ResolveOhmDataHomeInput = {}): string {\n  return join(resolveOhmDataHome(input), \"agent\");\n}\n"],"mappings":";;;;AAOA,SAAS,gBAAgB,KAAwB,MAAkC;CACjF,MAAM,MAAM,IAAI;AAChB,KAAI,CAAC,IAAK,QAAO;CACjB,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,QAAO;;AAGT,SAAgB,mBAAmB,QAAiC,EAAE,EAAU;CAE9E,MAAM,cAAc,gBADR,MAAM,OAAO,QAAQ,KACQ,gBAAgB;AAEzD,KAAI,YACF,QAAO,KAAK,aAAa,SAAS;AAGpC,QAAO,KAAK,SAAS,EAAE,UAAU,SAAS,SAAS;;AAGrD,SAAgB,wBAAwB,QAAiC,EAAE,EAAU;AACnF,QAAO,KAAK,mBAAmB,MAAM,EAAE,QAAQ"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@pi-ohm/core",
+  "version": "0.6.4-dev.22269206811.1.0e8e307",
+  "homepage": "https://github.com/pi-ohm/pi-ohm/tree/dev/packages/core#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pi-ohm/pi-ohm.git",
+    "directory": "packages/core"
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "default": "./dist/errors.js"
+    },
+    "./grammar": {
+      "types": "./dist/grammar.d.ts",
+      "default": "./dist/grammar.js"
+    },
+    "./paths": {
+      "types": "./dist/paths.d.ts",
+      "default": "./dist/paths.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "better-result": "^2.6.0"
+  },
+  "tsdown": {
+    "entry": {
+      "errors": "src/errors.ts",
+      "grammar": "src/grammar.ts",
+      "paths": "src/paths.ts"
+    }
+  }
+}