@forgeax/engine-project 0.1.3 → 0.1.6

package/src/loader.ts

@@ -1,9 +1,8 @@
 // loader.ts — loadGameProject + resolveDefaultScene (D-6, AC-06/07/08/09)
 //
 // loadGameProject: injection-only `read:(path)=>Promise<string>`, returns
-//   GuidResult<GameProject, GameProjectError>. Reader failures preserve ENOENT
-//   as forge-missing and classify all other refusals as forge-read-failed;
-//   validation then has the remaining five return paths:
+//   GuidResult<GameProject, GameProjectError>. Five return paths:
+//   1. read throws → ok:false, error(code='forge-missing')
 //   2. JSON.parse fails → ok:false, error(code='forge-parse-failed')
 //   3. schema.parse fails (missing fields) → ok:false, error(code='forge-schema-invalid')
 //   3b. schema.parse fails (unknown fields via .strict()) → ok:false, error(code='forge-unknown-field')
@@ -18,7 +17,6 @@
 
 import type { GuidResult } from '@forgeax/engine-pack/guid';
 import {
-  type ForgeReadFailureCauseCode,
   GameProjectError,
   type GameProjectErrorArgs,
   type GameProjectErrorCode,
@@ -42,73 +40,6 @@ function ok<T>(value: T) {
   return { ok: true as const, value };
 }
 
-type ReaderErrorMetadata = {
-  readonly code?: unknown;
-  readonly name?: unknown;
-};
-
-function readerFailureToken(error: unknown): string | undefined {
-  if (typeof error !== 'object' || error === null) {
-    return undefined;
-  }
-
-  const metadata = error as ReaderErrorMetadata;
-  if (typeof metadata.code === 'string') {
-    return metadata.code;
-  }
-  if (typeof metadata.name === 'string') {
-    return metadata.name;
-  }
-  return undefined;
-}
-
-function readerFailureCause(token: string | undefined): ForgeReadFailureCauseCode {
-  switch (token) {
-    case 'EACCES':
-    case 'EPERM':
-    case 'PermissionDeniedError':
-    case 'NotAllowedError':
-    case 'SecurityError':
-      return 'permission-denied';
-    case 'EAGAIN':
-    case 'EBUSY':
-    case 'EINTR':
-    case 'ECONNABORTED':
-    case 'ECONNREFUSED':
-    case 'ECONNRESET':
-    case 'EHOSTUNREACH':
-    case 'ENETDOWN':
-    case 'ENETUNREACH':
-    case 'ETIMEDOUT':
-    case 'EPIPE':
-    case 'ABORT_ERR':
-    case 'AbortError':
-    case 'TimeoutError':
-      return 'transient';
-    default:
-      return 'unknown';
-  }
-}
-
-function readerFailure(error: unknown) {
-  const token = readerFailureToken(error);
-  if (token === 'ENOENT') {
-    return err(
-      'forge-missing',
-      'forge.json file to exist at the game root',
-      'verify the game directory contains forge.json; if this is a new game, scaffold via the Studio UI or create a forge.json with id, name, schemaVersion fields',
-      { path: FORGE_JSON },
-    );
-  }
-
-  return err(
-    'forge-read-failed',
-    'forge.json reader to complete without refusal',
-    'retry the project reader; if the refusal persists, verify access to the game directory',
-    { path: FORGE_JSON, cause: readerFailureCause(token) },
-  );
-}
-
 // ── validateGameProject: sync pure core (JSON.parse → schema validate → 5 return paths) ──
 
 /**
@@ -198,15 +129,13 @@ export function validateGameProject(raw: string): GuidResult<GameProject, GamePr
  * Load and validate a game project manifest from the abstract async reader.
  *
  * Wraps `validateGameProject`: reads `FORGE_JSON` via `read`, then validates.
- * If `read` throws/rejects → `forge-missing` for ENOENT, otherwise
- * `forge-read-failed` with a bounded cause code.
+ * If `read` throws/rejects → `forge-missing`.
  *
  * ## Return paths (5)
  *
  * | # | Condition | ok | code |
  * |:--|:--|:--|:--|
- * | 1 | `read(FORGE_JSON)` throws / rejects with ENOENT | false | `forge-missing` |
- * | 1b | `read(FORGE_JSON)` refuses for another reason | false | `forge-read-failed` |
+ * | 1 | `read(FORGE_JSON)` throws / rejects | false | `forge-missing` |
  * | 2 | `JSON.parse` fails | false | `forge-parse-failed` |
  * | 3a | zod `.strict()` unknown fields (e.g. `scenes[]`) | false | `forge-unknown-field` |
  * | 3b | zod required field missing / wrong type | false | `forge-schema-invalid` |
@@ -228,8 +157,13 @@ export async function loadGameProject(
   let raw: string;
   try {
     raw = await read(FORGE_JSON);
-  } catch (error: unknown) {
-    return readerFailure(error);
+  } catch (_e: unknown) {
+    return err(
+      'forge-missing',
+      'forge.json file to exist at the game root',
+      'verify the game directory contains forge.json; if this is a new game, scaffold via the Studio UI or create a forge.json with id, name, schemaVersion fields',
+      { path: FORGE_JSON },
+    );
   }
 
   return validateGameProject(raw);
@@ -242,8 +176,7 @@ export async function loadGameProject(
  * (e.g. sync `ContextSlot` content functions).
  *
  * Accepts a sync `read:(path)=>string` injection (same contract shape,
- * sync return). If `read` throws → `forge-missing` for ENOENT, otherwise
- * `forge-read-failed` with a bounded cause code.
+ * sync return). If `read` throws → `forge-missing`.
  *
  * Uses the same `validateGameProject` pure core as `loadGameProject`.
  */
@@ -253,8 +186,13 @@ export function loadGameProjectSync(
   let raw: string;
   try {
     raw = read(FORGE_JSON);
-  } catch (error: unknown) {
-    return readerFailure(error);
+  } catch (_e: unknown) {
+    return err(
+      'forge-missing',
+      'forge.json file to exist at the game root',
+      'verify the game directory contains forge.json; if this is a new game, scaffold via the Studio UI or create a forge.json with id, name, schemaVersion fields',
+      { path: FORGE_JSON },
+    );
   }
 
   return validateGameProject(raw);