@workflow/world-local 5.0.0-beta.10 → 5.0.0-beta.3

package/dist/fs.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs.js","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"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","sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { EntityConflictError, WorkflowWorldError } from '@workflow/errors';\nimport type { PaginatedResponse } from '@workflow/world';\nimport { monotonicFactory } from 'ulid';\nimport { z } from 'zod';\n\nconst ulid = monotonicFactory(() => Math.random());\n\n/**\n * Truncate a possibly-untrusted value for inclusion in an error message.\n * Keeps error output actionable for developers in dev mode while limiting\n * the amount of attacker-controlled data reflected back if a `world-local`\n * backend is ever run in a context that surfaces these messages to clients.\n */\nfunction truncateForError(value: unknown): string {\n  const s = typeof value === 'string' ? value : String(value);\n  const MAX = 48;\n  return s.length > MAX ? `${s.slice(0, MAX)}…` : s;\n}\n\n/**\n * Thrown when a caller-supplied entity ID contains characters that would\n * escape the storage root (path traversal) or otherwise produce an unsafe\n * filename. Extends {@link WorkflowWorldError} so the platform's standard\n * error-to-HTTP mapping handles it alongside other world-layer errors.\n */\nexport class UnsafeEntityIdError extends WorkflowWorldError {\n  constructor(kind: string, value: string) {\n    super(\n      `Unsafe ${kind} \"${truncateForError(value)}\": must not be empty, start with \".\", or contain path separators or null bytes`\n    );\n    this.name = 'UnsafeEntityIdError';\n  }\n\n  static is(value: unknown): value is UnsafeEntityIdError {\n    return value instanceof Error && value.name === 'UnsafeEntityIdError';\n  }\n}\n\n/**\n * Validate that a string is safe to embed in a filesystem path as a single\n * path component. Rejects values that are:\n *   - empty\n *   - starting with `.` (blocks `.`, `..`, `.locks`, `.tmp`, and other\n *     hidden or reserved filenames)\n *   - containing `/`, `\\`, or a NUL byte\n *\n * This is the primary defense against path-traversal attacks where a\n * request body supplies a `runId` / `stepId` / `correlationId` containing\n * `../` sequences to read or write files outside the storage root.\n * {@link resolveWithinBase} provides a belt-and-suspenders containment\n * check at the point of `path.join` for defense in depth.\n *\n * @param kind - Human-readable label used in the error message (e.g. \"runId\")\n * @param value - The value to validate; throws {@link UnsafeEntityIdError}\n *   if the value is not safe.\n */\nexport function assertSafeEntityId(kind: string, value: string): void {\n  if (\n    value.length === 0 ||\n    value.startsWith('.') ||\n    value.includes('/') ||\n    value.includes('\\\\') ||\n    value.includes('\\0')\n  ) {\n    throw new UnsafeEntityIdError(kind, value);\n  }\n}\n\n/**\n * Join `basedir` with an entity-relative path and assert the result stays\n * inside `basedir`. Complements {@link assertSafeEntityId}: per-entry-point\n * validation is the primary defense, and this final check catches any path\n * escape that slipped past (e.g. a new call site that forgot to validate,\n * or an unusual character combination on a future filesystem). Throws\n * {@link UnsafeEntityIdError} if the joined path escapes `basedir`.\n */\nexport function resolveWithinBase(\n  basedir: string,\n  ...segments: string[]\n): string {\n  const resolvedBase = path.resolve(basedir);\n  const joined = path.resolve(basedir, ...segments);\n  if (joined !== resolvedBase && !joined.startsWith(resolvedBase + path.sep)) {\n    throw new UnsafeEntityIdError('path', segments.join('/'));\n  }\n  return joined;\n}\n\nconst isWindows = process.platform === 'win32';\n\n/**\n * Execute a filesystem operation with retry logic on Windows.\n * On Windows, file operations can fail with EPERM/EBUSY/EACCES when files\n * are briefly locked by another process or antivirus. This wrapper adds\n * exponential backoff retry logic. On non-Windows platforms, executes directly.\n */\nasync function withWindowsRetry<T>(\n  fn: () => Promise<T>,\n  maxRetries = 5\n): Promise<T> {\n  if (!isWindows) return fn();\n\n  const retryableErrors = ['EPERM', 'EBUSY', 'EACCES'];\n  const baseDelayMs = 10;\n\n  for (let attempt = 0; attempt <= maxRetries; attempt++) {\n    try {\n      return await fn();\n    } catch (error: any) {\n      const isRetryable =\n        attempt < maxRetries && retryableErrors.includes(error.code);\n      if (!isRetryable) throw error;\n      // Exponential backoff with jitter\n      const delay = baseDelayMs * 2 ** attempt + Math.random() * baseDelayMs;\n      await new Promise((resolve) => setTimeout(resolve, delay));\n    }\n  }\n  // TypeScript: unreachable, but satisfies return type\n  throw new Error('Retry loop exited unexpectedly');\n}\n\n// In-memory cache of created files to avoid expensive fs.access() calls\n// This is safe because we only write once per file path (no overwrites without explicit flag)\nconst createdFilesCache = new Set<string>();\n\n/**\n * Clear the created files cache. Useful for testing or when files are deleted externally.\n */\nexport function clearCreatedFilesCache(): void {\n  createdFilesCache.clear();\n}\n\nexport { ulidToDate } from '@workflow/world';\n\n/**\n * Regex matching a tag suffix on a fileId (after `.json` has been stripped).\n * E.g., `wrun_ABC.vitest-0` → the `.vitest-0` part.\n * Tags start with a letter and contain alphanumeric chars and hyphens.\n * Entity IDs (ULIDs, step_N, etc.) never contain dots, so the first dot\n * always marks the tag boundary.\n */\nconst TAG_PATTERN = /\\.[a-zA-Z][a-zA-Z0-9-]*$/;\n\n/**\n * Strip a tag suffix from a fileId.\n * `wrun_ABC.vitest-0` → `wrun_ABC`\n * `wrun_ABC` → `wrun_ABC` (no-op if no tag)\n */\nexport function stripTag(fileId: string): string {\n  return fileId.replace(TAG_PATTERN, '');\n}\n\n/**\n * Build the file path for an entity, with optional tag embedded in the filename.\n * `taggedPath('/data', 'runs', 'wrun_ABC', 'vitest-0')` → `/data/runs/wrun_ABC.vitest-0.json`\n * `taggedPath('/data', 'runs', 'wrun_ABC')` → `/data/runs/wrun_ABC.json`\n *\n * The `fileId` and `tag` are validated with {@link assertSafeEntityId} and\n * the result is containment-checked with {@link resolveWithinBase} to\n * prevent path-traversal attacks when values are derived from untrusted\n * request input.\n */\nexport function taggedPath(\n  basedir: string,\n  entityDir: string,\n  fileId: string,\n  tag?: string\n): string {\n  assertSafeEntityId('fileId', fileId);\n  if (tag !== undefined) assertSafeEntityId('tag', tag);\n  const filename = tag ? `${fileId}.${tag}.json` : `${fileId}.json`;\n  return resolveWithinBase(basedir, entityDir, filename);\n}\n\n/**\n * Read a JSON entity with tagged fallback.\n * When a tag is set, tries the tagged path first, then falls back to the\n * untagged path (so a tagged world can read entities written without a tag).\n */\nexport async function readJSONWithFallback<T>(\n  basedir: string,\n  entityDir: string,\n  fileId: string,\n  schema: z.ZodType<T>,\n  tag?: string\n): Promise<T | null> {\n  assertSafeEntityId('fileId', fileId);\n  if (tag !== undefined) assertSafeEntityId('tag', tag);\n  if (tag) {\n    const result = await readJSON(\n      resolveWithinBase(basedir, entityDir, `${fileId}.${tag}.json`),\n      schema\n    );\n    if (result !== null) return result;\n  }\n  return readJSON(\n    resolveWithinBase(basedir, entityDir, `${fileId}.json`),\n    schema\n  );\n}\n\n/**\n * List all filenames in a directory that have a specific tag.\n * Returns full filenames (e.g., `wrun_ABC.vitest-0.json`).\n */\nexport async function listTaggedFiles(\n  dirPath: string,\n  tag: string\n): Promise<string[]> {\n  const suffix = `.${tag}.json`;\n  try {\n    const files = await fs.readdir(dirPath);\n    return files.filter((f) => f.endsWith(suffix));\n  } catch (error) {\n    if ((error as any).code === 'ENOENT') return [];\n    throw error;\n  }\n}\n\n/**\n * List all filenames in a directory that have a specific tag and extension.\n * Returns full filenames (e.g., `stream-chnk_ABC.vitest-0.bin`).\n */\nexport async function listTaggedFilesByExtension(\n  dirPath: string,\n  tag: string,\n  extension: string\n): Promise<string[]> {\n  const suffix = `.${tag}${extension}`;\n  try {\n    const files = await fs.readdir(dirPath);\n    return files.filter((f) => f.endsWith(suffix));\n  } catch (error) {\n    if ((error as any).code === 'ENOENT') return [];\n    throw error;\n  }\n}\n\nexport async function ensureDir(dirPath: string): Promise<void> {\n  try {\n    await fs.mkdir(dirPath, { recursive: true });\n  } catch (_error) {\n    // Ignore if already exists\n  }\n}\n\ninterface WriteOptions {\n  overwrite?: boolean;\n}\n\n/**\n * Custom JSON replacer that encodes Uint8Array as base64 strings.\n * Format: { __type: 'Uint8Array', data: '<base64>' }\n */\nexport function jsonReplacer(_key: string, value: unknown): unknown {\n  if (value instanceof Uint8Array) {\n    return {\n      __type: 'Uint8Array',\n      data: Buffer.from(value).toString('base64'),\n    };\n  }\n  return value;\n}\n\n/**\n * Custom JSON reviver that decodes base64 strings back to Uint8Array.\n */\nexport function jsonReviver(_key: string, value: unknown): unknown {\n  if (\n    value !== null &&\n    typeof value === 'object' &&\n    (value as any).__type === 'Uint8Array' &&\n    typeof (value as any).data === 'string'\n  ) {\n    return new Uint8Array(Buffer.from((value as any).data, 'base64'));\n  }\n  return value;\n}\n\nexport async function writeJSON(\n  filePath: string,\n  data: any,\n  opts?: WriteOptions\n): Promise<void> {\n  return write(filePath, JSON.stringify(data, jsonReplacer, 2), opts);\n}\n\n/**\n * Writes data to a file using atomic write-rename pattern.\n *\n * Note: While this function uses temp files to avoid partial writes,\n * it does not provide protection against concurrent writes from multiple\n * processes. In a multi-writer scenario, the last writer wins.\n * For production use with multiple writers, consider using a proper\n * database or locking mechanism.\n */\nexport async function write(\n  filePath: string,\n  data: string | Buffer,\n  opts?: WriteOptions\n): Promise<void> {\n  if (!opts?.overwrite) {\n    // Fast path: check in-memory cache first to avoid expensive fs.access() calls\n    // This provides significant performance improvement when creating many files\n    if (createdFilesCache.has(filePath)) {\n      throw new EntityConflictError(\n        `File ${filePath} already exists and 'overwrite' is false`\n      );\n    }\n\n    // Slow path: check filesystem for files created before this process started\n    try {\n      await fs.access(filePath);\n      // File exists on disk, add to cache for future checks\n      createdFilesCache.add(filePath);\n      throw new EntityConflictError(\n        `File ${filePath} already exists and 'overwrite' is false`\n      );\n    } catch (error: any) {\n      // If file doesn't exist (ENOENT), continue with write\n      if (error.code !== 'ENOENT') {\n        throw error;\n      }\n    }\n  }\n\n  const tempPath = `${filePath}.tmp.${ulid()}`;\n  let tempFileCreated = false;\n  try {\n    await ensureDir(path.dirname(filePath));\n    await fs.writeFile(tempPath, data);\n    tempFileCreated = true;\n    await withWindowsRetry(() => fs.rename(tempPath, filePath));\n    // Track this file in cache so future writes know it exists\n    createdFilesCache.add(filePath);\n  } catch (error) {\n    // Only try to clean up temp file if it was actually created\n    if (tempFileCreated) {\n      await withWindowsRetry(() => fs.unlink(tempPath), 3).catch(() => {});\n    }\n    throw error;\n  }\n}\n\nexport async function readJSON<T>(\n  filePath: string,\n  decoder: z.ZodType<T>\n): Promise<T | null> {\n  try {\n    const content = await fs.readFile(filePath, 'utf-8');\n    return decoder.parse(JSON.parse(content, jsonReviver));\n  } catch (error) {\n    if ((error as any).code === 'ENOENT') return null;\n    throw error;\n  }\n}\n\nexport async function readBuffer(filePath: string): Promise<Buffer> {\n  const content = await fs.readFile(filePath);\n  return content;\n}\n\nexport async function deleteJSON(filePath: string): Promise<void> {\n  try {\n    await fs.unlink(filePath);\n  } catch (error) {\n    if ((error as any).code !== 'ENOENT') throw error;\n  }\n}\n\n/**\n * Atomically create a file using O_CREAT | O_EXCL flags.\n * Returns true if the file was created, false if it already exists.\n * This is atomic at the OS level, safe for concurrent access.\n */\nexport async function writeExclusive(\n  filePath: string,\n  data: string\n): Promise<boolean> {\n  await ensureDir(path.dirname(filePath));\n  try {\n    await fs.writeFile(filePath, data, { flag: 'wx' });\n    return true;\n  } catch (error: any) {\n    if (error.code === 'EEXIST') {\n      return false;\n    }\n    throw error;\n  }\n}\n\nexport async function listJSONFiles(dirPath: string): Promise<string[]> {\n  return listFilesByExtension(dirPath, '.json');\n}\n\nexport async function listFilesByExtension(\n  dirPath: string,\n  extension: string\n): Promise<string[]> {\n  try {\n    const files = await fs.readdir(dirPath);\n    return files\n      .filter((f) => f.endsWith(extension))\n      .map((f) => f.slice(0, -extension.length));\n  } catch (error) {\n    if ((error as any).code === 'ENOENT') return [];\n    throw error;\n  }\n}\n\ninterface PaginatedFileSystemQueryConfig<T> {\n  directory: string;\n  schema: z.ZodType<T>;\n  filePrefix?: string;\n  filter?: (item: T) => boolean;\n  sortOrder?: 'asc' | 'desc';\n  limit?: number;\n  cursor?: string;\n  getCreatedAt(filename: string): Date | null;\n  getId?(item: T): string;\n}\n// Cursor format: \"timestamp|id\" for tie-breaking\ninterface ParsedCursor {\n  timestamp: Date;\n  id: string | null;\n}\n\nfunction parseCursor(cursor: string | undefined): ParsedCursor | null {\n  if (!cursor) return null;\n\n  const parts = cursor.split('|');\n  return {\n    timestamp: new Date(parts[0]),\n    id: parts[1] || null,\n  };\n}\n\nfunction createCursor(timestamp: Date, id: string | undefined): string {\n  return id ? `${timestamp.toISOString()}|${id}` : timestamp.toISOString();\n}\n\nexport async function paginatedFileSystemQuery<T extends { createdAt: Date }>(\n  config: PaginatedFileSystemQueryConfig<T>\n): Promise<PaginatedResponse<T>> {\n  const {\n    directory,\n    schema,\n    filePrefix,\n    filter,\n    sortOrder = 'desc',\n    limit = 20,\n    cursor,\n    getCreatedAt,\n    getId,\n  } = config;\n\n  // Validate filePrefix (typically `${runId}-`) so request-derived prefixes\n  // consistently reject unsafe characters. filePrefix is only used below to\n  // filter readdir() results by prefix — it doesn't participate in path\n  // construction — but keeping the validation rule uniform across the\n  // storage layer avoids special cases and catches bad values earlier.\n  if (filePrefix !== undefined) {\n    assertSafeEntityId('filePrefix', filePrefix);\n  }\n\n  // 1. Get all JSON files in directory\n  const fileIds = await listJSONFiles(directory);\n\n  // 2. Filter by prefix if provided\n  const relevantFileIds = filePrefix\n    ? fileIds.filter((fileId) => fileId.startsWith(filePrefix))\n    : fileIds;\n\n  // 3. ULID Optimization: Filter by cursor using filename timestamps before loading JSON\n  const parsedCursor = parseCursor(cursor);\n  let candidateFileIds = relevantFileIds;\n\n  if (parsedCursor) {\n    candidateFileIds = relevantFileIds.filter((fileId) => {\n      const filenameDate = getCreatedAt(`${fileId}.json`);\n      if (filenameDate) {\n        // Use filename timestamp for cursor filtering\n        // We need to be careful here: if parsedCursor has an ID (for tie-breaking),\n        // we need to include items with the same timestamp for later ID-based filtering.\n        // If no ID, we can use strict inequality for optimization.\n        const cursorTime = parsedCursor.timestamp.getTime();\n        const fileTime = filenameDate.getTime();\n\n        if (parsedCursor.id) {\n          // Tie-breaking mode: include items at or near cursor timestamp\n          return sortOrder === 'desc'\n            ? fileTime <= cursorTime\n            : fileTime >= cursorTime;\n        } else {\n          // No tie-breaking: strict inequality\n          return sortOrder === 'desc'\n            ? fileTime < cursorTime\n            : fileTime > cursorTime;\n        }\n      }\n      // Can't extract timestamp from filename (e.g., steps use sequential IDs).\n      // Include the file and defer to JSON-based filtering below.\n      return true;\n    });\n  }\n\n  // 4. Load files individually and collect valid items\n  const validItems: T[] = [];\n\n  for (const fileId of candidateFileIds) {\n    const filePath = path.join(directory, `${fileId}.json`);\n    let item: T | null = null;\n    try {\n      item = await readJSON(filePath, schema);\n    } catch (error: unknown) {\n      // We don't expect zod errors to happen, but if the JSON does get malformed,\n      // we skip the item. Preferably, we'd have a way to mark items as malformed,\n      // so that the UI can display them as such, with richer messaging. In the meantime,\n      // we just log a warning and skip the item.\n      if (error instanceof z.ZodError) {\n        console.warn(\n          `Skipping item ${fileId} due to malformed JSON: ${error.message}`\n        );\n        continue;\n      }\n      throw error;\n    }\n\n    if (item) {\n      // Apply custom filter early if provided\n      if (filter && !filter(item)) continue;\n\n      // Double-check cursor filtering with actual createdAt from JSON\n      // (in case ULID timestamp differs from stored createdAt)\n      if (parsedCursor) {\n        const itemTime = item.createdAt.getTime();\n        const cursorTime = parsedCursor.timestamp.getTime();\n\n        if (sortOrder === 'desc') {\n          // For descending order, skip items >= cursor\n          if (itemTime > cursorTime) continue;\n          // If timestamps are equal, use ID for tie-breaking (skip if ID >= cursorId)\n          if (itemTime === cursorTime && parsedCursor.id && getId) {\n            const itemId = getId(item);\n            if (itemId >= parsedCursor.id) continue;\n          }\n        } else {\n          // For ascending order, skip items <= cursor\n          if (itemTime < cursorTime) continue;\n          // If timestamps are equal, use ID for tie-breaking (skip if ID <= cursorId)\n          if (itemTime === cursorTime && parsedCursor.id && getId) {\n            const itemId = getId(item);\n            if (itemId <= parsedCursor.id) continue;\n          }\n        }\n      }\n\n      validItems.push(item);\n    }\n  }\n\n  // 5. Sort by createdAt (and by ID for tie-breaking if getId is provided)\n  validItems.sort((a, b) => {\n    const aTime = a.createdAt.getTime();\n    const bTime = b.createdAt.getTime();\n    const timeComparison = sortOrder === 'asc' ? aTime - bTime : bTime - aTime;\n\n    // If timestamps are equal and we have getId, use ID for stable sorting\n    if (timeComparison === 0 && getId) {\n      const aId = getId(a);\n      const bId = getId(b);\n      return sortOrder === 'asc'\n        ? aId.localeCompare(bId)\n        : bId.localeCompare(aId);\n    }\n\n    return timeComparison;\n  });\n\n  // 6. Apply pagination\n  const hasMore = validItems.length > limit;\n  const items = hasMore ? validItems.slice(0, limit) : validItems;\n  const nextCursor =\n    items.length > 0\n      ? createCursor(\n          items[items.length - 1].createdAt,\n          getId?.(items[items.length - 1])\n        )\n      : null;\n\n  return {\n    data: items,\n    cursor: nextCursor,\n    hasMore,\n  };\n}\n"]}

package/dist/index.d.ts

@@ -1,12 +1,25 @@
 import type { World } from '@workflow/world';
 import type { Config } from './config.js';
+import { type DirectHandler } from './queue.js';
+export { DataDirAccessError, DataDirVersionError, ensureDataDir, initDataDir, type ParsedVersion, parseVersion, } from './init.js';
+export type { DirectHandler } from './queue.js';
+export type LocalWorld = World & {
+    /** Register a direct in-process handler for a queue prefix, bypassing HTTP. */
+    registerHandler(prefix: '__wkf_step_' | '__wkf_workflow_', handler: DirectHandler): void;
+    /** Clear all workflow data (runs, steps, events, hooks, streams). */
+    clear(): Promise<void>;
+};
 /**
- * Creates an embedded world instance that combines queue, storage, and streamer functionalities.
+ * Creates a local world instance that combines queue, storage, and streamer functionalities.
  *
  * @param args - Optional configuration object
  * @param args.dataDir - Directory for storing workflow data (default: `.workflow-data/`)
  * @param args.port - Port override for queue transport (default: auto-detected)
  * @param args.baseUrl - Full base URL override for queue transport (default: `http://localhost:{port}`)
+ * @param args.tag - Optional tag to scope files (e.g., `vitest-0`). When set, files are written
+ *   as `{id}.{tag}.json` and `clear()` only deletes files matching this tag.
+ * @throws {DataDirAccessError} If the data directory cannot be created or accessed
+ * @throws {DataDirVersionError} If the data directory version is incompatible
  */
-export declare function createEmbeddedWorld(args?: Partial<Config>): World;
+export declare function createLocalWorld(args?: Partial<Config>): LocalWorld;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAM1C;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,KAAK,CAYjE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAW1C,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAM7D,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,KAAK,aAAa,EAClB,YAAY,GACb,MAAM,WAAW,CAAC;AAEnB,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG;IAC/B,+EAA+E;IAC/E,eAAe,CACb,MAAM,EAAE,aAAa,GAAG,iBAAiB,EACzC,OAAO,EAAE,aAAa,GACrB,IAAI,CAAC;IACR,qEAAqE;IACrE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,UAAU,CA+FnE"}

package/dist/index.js

@@ -1,24 +1,101 @@
+import { promises as fs } from 'node:fs';
+import { rm } from 'node:fs/promises';
+import path from 'node:path';
+import { reenqueueActiveRuns, SPEC_VERSION_CURRENT } from '@workflow/world';
 import { config } from './config.js';
+import { clearCreatedFilesCache, deleteJSON, listTaggedFiles, listTaggedFilesByExtension, readJSON, } from './fs.js';
+import { initDataDir } from './init.js';
+import { instrumentObject } from './instrumentObject.js';
 import { createQueue } from './queue.js';
+import { hashToken } from './storage/helpers.js';
 import { createStorage } from './storage.js';
 import { createStreamer } from './streamer.js';
+// Re-export init types and utilities for consumers
+export { DataDirAccessError, DataDirVersionError, ensureDataDir, initDataDir, parseVersion, } from './init.js';
 /**
- * Creates an embedded world instance that combines queue, storage, and streamer functionalities.
+ * Creates a local world instance that combines queue, storage, and streamer functionalities.
  *
  * @param args - Optional configuration object
  * @param args.dataDir - Directory for storing workflow data (default: `.workflow-data/`)
  * @param args.port - Port override for queue transport (default: auto-detected)
  * @param args.baseUrl - Full base URL override for queue transport (default: `http://localhost:{port}`)
+ * @param args.tag - Optional tag to scope files (e.g., `vitest-0`). When set, files are written
+ *   as `{id}.{tag}.json` and `clear()` only deletes files matching this tag.
+ * @throws {DataDirAccessError} If the data directory cannot be created or accessed
+ * @throws {DataDirVersionError} If the data directory version is incompatible
  */
-export function createEmbeddedWorld(args) {
+export function createLocalWorld(args) {
     const definedArgs = args
         ? Object.fromEntries(Object.entries(args).filter(([, value]) => value !== undefined))
         : {};
     const mergedConfig = { ...config.value, ...definedArgs };
+    const tag = mergedConfig.tag;
+    const queue = createQueue(mergedConfig);
+    const storage = createStorage(mergedConfig.dataDir, tag);
     return {
-        ...createQueue(mergedConfig),
-        ...createStorage(mergedConfig.dataDir),
-        ...createStreamer(mergedConfig.dataDir),
+        specVersion: SPEC_VERSION_CURRENT,
+        ...queue,
+        ...createStorage(mergedConfig.dataDir, tag),
+        ...instrumentObject('world.streams', {
+            ...createStreamer(mergedConfig.dataDir, tag),
+            ...(mergedConfig.streamFlushIntervalMs !== undefined && {
+                streamFlushIntervalMs: mergedConfig.streamFlushIntervalMs,
+            }),
+        }),
+        async start() {
+            await initDataDir(mergedConfig.dataDir);
+            await reenqueueActiveRuns(storage.runs, queue.queue, 'world-local');
+        },
+        async close() {
+            await queue.close();
+        },
+        async clear() {
+            if (tag) {
+                // Selectively delete only files matching this tag
+                const basedir = mergedConfig.dataDir;
+                // Delete hook token constraint files BEFORE deleting the hooks,
+                // since we need to read each hook to extract its token hash.
+                // Constraint files are untagged ({sha256}.json) so listTaggedFiles
+                // won't find them — we must resolve them via the hook data.
+                const hooksDir = path.join(basedir, 'hooks');
+                const taggedHookFiles = await listTaggedFiles(hooksDir, tag);
+                const { HookSchema } = await import('@workflow/world');
+                await Promise.all(taggedHookFiles.map(async (hookFile) => {
+                    const hook = await readJSON(path.join(hooksDir, hookFile), HookSchema);
+                    if (hook?.token) {
+                        await deleteJSON(path.join(hooksDir, 'tokens', `${hashToken(hook.token)}.json`));
+                    }
+                }));
+                // Delete tagged entity files across all directories
+                const entityDirs = [
+                    'runs',
+                    'steps',
+                    'events',
+                    'hooks',
+                    'waits',
+                    'streams/runs',
+                ];
+                await Promise.all(entityDirs.map(async (dir) => {
+                    const fullDir = path.join(basedir, dir);
+                    const files = await listTaggedFiles(fullDir, tag);
+                    await Promise.all(files.map((f) => deleteJSON(path.join(fullDir, f))));
+                }));
+                // Clean up lock files used for atomic terminal-state guards
+                await fs
+                    .rm(path.join(basedir, '.locks'), { recursive: true, force: true })
+                    .catch(() => { });
+                // Delete tagged stream chunks (.{tag}.bin files)
+                const chunksDir = path.join(basedir, 'streams', 'chunks');
+                const taggedBinFiles = await listTaggedFilesByExtension(chunksDir, tag, '.bin');
+                await Promise.all(taggedBinFiles.map((f) => fs.unlink(path.join(chunksDir, f)).catch(() => { })));
+                // Clear the in-memory write cache so deleted paths are forgotten
+                clearCreatedFilesCache();
+            }
+            else {
+                await rm(mergedConfig.dataDir, { recursive: true, force: true });
+                await initDataDir(mergedConfig.dataDir);
+            }
+        },
     };
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAsB;IACxD,MAAM,WAAW,GAAG,IAAI;QACtB,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAChE;QACH,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,YAAY,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,WAAW,EAAE,CAAC;IACzD,OAAO;QACL,GAAG,WAAW,CAAC,YAAY,CAAC;QAC5B,GAAG,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC;QACtC,GAAG,cAAc,CAAC,YAAY,CAAC,OAAO,CAAC;KACxC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { promises as fs } from 'node:fs';\nimport { rm } from 'node:fs/promises';\nimport path from 'node:path';\nimport type { World } from '@workflow/world';\nimport { reenqueueActiveRuns, SPEC_VERSION_CURRENT } from '@workflow/world';\nimport type { Config } from './config.js';\nimport { config } from './config.js';\nimport {\n  clearCreatedFilesCache,\n  deleteJSON,\n  listTaggedFiles,\n  listTaggedFilesByExtension,\n  readJSON,\n} from './fs.js';\nimport { initDataDir } from './init.js';\nimport { instrumentObject } from './instrumentObject.js';\nimport { createQueue, type DirectHandler } from './queue.js';\nimport { hashToken } from './storage/helpers.js';\nimport { createStorage } from './storage.js';\nimport { createStreamer } from './streamer.js';\n\n// Re-export init types and utilities for consumers\nexport {\n  DataDirAccessError,\n  DataDirVersionError,\n  ensureDataDir,\n  initDataDir,\n  type ParsedVersion,\n  parseVersion,\n} from './init.js';\n\nexport type { DirectHandler } from './queue.js';\n\nexport type LocalWorld = World & {\n  /** Register a direct in-process handler for a queue prefix, bypassing HTTP. */\n  registerHandler(\n    prefix: '__wkf_step_' | '__wkf_workflow_',\n    handler: DirectHandler\n  ): void;\n  /** Clear all workflow data (runs, steps, events, hooks, streams). */\n  clear(): Promise<void>;\n};\n\n/**\n * Creates a local world instance that combines queue, storage, and streamer functionalities.\n *\n * @param args - Optional configuration object\n * @param args.dataDir - Directory for storing workflow data (default: `.workflow-data/`)\n * @param args.port - Port override for queue transport (default: auto-detected)\n * @param args.baseUrl - Full base URL override for queue transport (default: `http://localhost:{port}`)\n * @param args.tag - Optional tag to scope files (e.g., `vitest-0`). When set, files are written\n *   as `{id}.{tag}.json` and `clear()` only deletes files matching this tag.\n * @throws {DataDirAccessError} If the data directory cannot be created or accessed\n * @throws {DataDirVersionError} If the data directory version is incompatible\n */\nexport function createLocalWorld(args?: Partial<Config>): LocalWorld {\n  const definedArgs = args\n    ? Object.fromEntries(\n        Object.entries(args).filter(([, value]) => value !== undefined)\n      )\n    : {};\n  const mergedConfig = { ...config.value, ...definedArgs };\n  const tag = mergedConfig.tag;\n  const queue = createQueue(mergedConfig);\n  const storage = createStorage(mergedConfig.dataDir, tag);\n  return {\n    specVersion: SPEC_VERSION_CURRENT,\n    ...queue,\n    ...createStorage(mergedConfig.dataDir, tag),\n    ...instrumentObject('world.streams', {\n      ...createStreamer(mergedConfig.dataDir, tag),\n      ...(mergedConfig.streamFlushIntervalMs !== undefined && {\n        streamFlushIntervalMs: mergedConfig.streamFlushIntervalMs,\n      }),\n    }),\n    async start() {\n      await initDataDir(mergedConfig.dataDir);\n      await reenqueueActiveRuns(storage.runs, queue.queue, 'world-local');\n    },\n    async close() {\n      await queue.close();\n    },\n    async clear() {\n      if (tag) {\n        // Selectively delete only files matching this tag\n        const basedir = mergedConfig.dataDir;\n\n        // Delete hook token constraint files BEFORE deleting the hooks,\n        // since we need to read each hook to extract its token hash.\n        // Constraint files are untagged ({sha256}.json) so listTaggedFiles\n        // won't find them — we must resolve them via the hook data.\n        const hooksDir = path.join(basedir, 'hooks');\n        const taggedHookFiles = await listTaggedFiles(hooksDir, tag);\n        const { HookSchema } = await import('@workflow/world');\n        await Promise.all(\n          taggedHookFiles.map(async (hookFile) => {\n            const hook = await readJSON(\n              path.join(hooksDir, hookFile),\n              HookSchema\n            );\n            if (hook?.token) {\n              await deleteJSON(\n                path.join(hooksDir, 'tokens', `${hashToken(hook.token)}.json`)\n              );\n            }\n          })\n        );\n\n        // Delete tagged entity files across all directories\n        const entityDirs = [\n          'runs',\n          'steps',\n          'events',\n          'hooks',\n          'waits',\n          'streams/runs',\n        ];\n        await Promise.all(\n          entityDirs.map(async (dir) => {\n            const fullDir = path.join(basedir, dir);\n            const files = await listTaggedFiles(fullDir, tag);\n            await Promise.all(\n              files.map((f) => deleteJSON(path.join(fullDir, f)))\n            );\n          })\n        );\n        // Clean up lock files used for atomic terminal-state guards\n        await fs\n          .rm(path.join(basedir, '.locks'), { recursive: true, force: true })\n          .catch(() => {});\n        // Delete tagged stream chunks (.{tag}.bin files)\n        const chunksDir = path.join(basedir, 'streams', 'chunks');\n        const taggedBinFiles = await listTaggedFilesByExtension(\n          chunksDir,\n          tag,\n          '.bin'\n        );\n        await Promise.all(\n          taggedBinFiles.map((f) =>\n            fs.unlink(path.join(chunksDir, f)).catch(() => {})\n          )\n        );\n        // Clear the in-memory write cache so deleted paths are forgotten\n        clearCreatedFilesCache();\n      } else {\n        await rm(mergedConfig.dataDir, { recursive: true, force: true });\n        await initDataDir(mergedConfig.dataDir);\n      }\n    },\n  };\n}\n"]}

package/dist/init.d.ts

@@ -0,0 +1,91 @@
+interface PackageInfo {
+    name: string;
+    version: string;
+}
+/**
+ * Returns the package name and version from package.json.
+ * The result is cached after the first read.
+ *
+ * In bundled contexts where package.json cannot be read,
+ * returns 'bundled' as the version.
+ */
+export declare function getPackageInfo(): Promise<PackageInfo>;
+/**
+ * Represents a parsed semantic version with optional prerelease tag.
+ */
+export interface ParsedVersion {
+    major: number;
+    minor: number;
+    patch: number;
+    prerelease?: string;
+    raw: string;
+}
+/**
+ * Error thrown when the data directory cannot be accessed or created.
+ */
+export declare class DataDirAccessError extends Error {
+    readonly dataDir: string;
+    readonly code?: string;
+    constructor(message: string, dataDir: string, code?: string);
+}
+/**
+ * Error thrown when data directory version is incompatible.
+ */
+export declare class DataDirVersionError extends Error {
+    readonly oldVersion: ParsedVersion;
+    readonly newVersion: ParsedVersion;
+    readonly suggestedVersion?: string;
+    constructor(message: string, oldVersion: ParsedVersion, newVersion: ParsedVersion, suggestedVersion?: string);
+}
+/**
+ * Parses a version string into its components.
+ *
+ * @param versionString - Version string like "4.0.1" or "4.0.1-beta.20"
+ * @returns Parsed version object with major, minor, patch, and optional prerelease
+ */
+export declare function parseVersion(versionString: string): ParsedVersion;
+/**
+ * Formats a parsed version back to a string.
+ */
+export declare function formatVersion(version: ParsedVersion): string;
+/**
+ * Parses the version file content to extract package name and version.
+ *
+ * @param content - Content like "@workflow/world-local@4.0.1-beta.20"
+ * @returns Object with packageName and version
+ */
+export declare function parseVersionFile(content: string): {
+    packageName: string;
+    version: ParsedVersion;
+};
+/**
+ * Formats the version file content.
+ */
+export declare function formatVersionFile(packageName: string, version: ParsedVersion): string;
+/**
+ * Handles version upgrades between old and new versions.
+ * This function is called when the data directory was created with a different version.
+ *
+ * @param oldVersion - The version that created the data directory
+ * @param newVersion - The current package version
+ * @throws {DataDirVersionError} If the versions are incompatible
+ */
+export declare function upgradeVersion(oldVersion: ParsedVersion, newVersion: ParsedVersion): void;
+/**
+ * Ensures the data directory exists and is writable.
+ * Creates the directory if it doesn't exist.
+ *
+ * @param dataDir - The path to the data directory
+ * @throws {DataDirAccessError} If the directory cannot be created or accessed
+ */
+export declare function ensureDataDir(dataDir: string): Promise<void>;
+/**
+ * Initializes the data directory, ensuring it exists, is accessible,
+ * and handles version compatibility.
+ *
+ * @param dataDir - The path to the data directory
+ * @throws {DataDirAccessError} If the directory cannot be created or accessed
+ */
+export declare function initDataDir(dataDir: string): Promise<void>;
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAcA,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAgBD;;;;;;GAMG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAyB3D;AAKD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAM5D;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;gBAGjC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,EACzB,UAAU,EAAE,aAAa,EACzB,gBAAgB,CAAC,EAAE,MAAM;CAQ5B;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,CAejE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAG5D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;CACxB,CAeA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,aAAa,GACrB,MAAM,CAER;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,aAAa,EACzB,UAAU,EAAE,aAAa,GACxB,IAAI,CAIN;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkDlE;AA4DD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDhE"}

package/dist/init.js

@@ -0,0 +1,268 @@
+import { access, constants, mkdir, readFile, unlink, writeFile, } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** Package name - hardcoded since it doesn't change */
+const PACKAGE_NAME = '@workflow/world-local';
+let cachedPackageInfo = null;
+/**
+ * Get the directory path for this module.
+ * Works in ESM and falls back to a constant in CJS contexts (which shouldn't happen)
+ */
+function getModuleDir() {
+    // In bundled CJS contexts, import.meta.url may be undefined or empty
+    if (typeof import.meta.url === 'string' && import.meta.url) {
+        return path.dirname(fileURLToPath(import.meta.url));
+    }
+    return null;
+}
+/**
+ * Returns the package name and version from package.json.
+ * The result is cached after the first read.
+ *
+ * In bundled contexts where package.json cannot be read,
+ * returns 'bundled' as the version.
+ */
+export async function getPackageInfo() {
+    if (cachedPackageInfo) {
+        return cachedPackageInfo;
+    }
+    const moduleDir = getModuleDir();
+    if (moduleDir) {
+        try {
+            const content = await readFile(path.join(moduleDir, '../package.json'), 'utf-8');
+            cachedPackageInfo = JSON.parse(content);
+            return cachedPackageInfo;
+        }
+        catch {
+            // Fall through to bundled fallback
+        }
+    }
+    // Bundled context - package.json not accessible
+    cachedPackageInfo = {
+        name: PACKAGE_NAME,
+        version: 'bundled',
+    };
+    return cachedPackageInfo;
+}
+/** Filename for storing version information in the data directory */
+const VERSION_FILENAME = 'version.txt';
+/**
+ * Error thrown when the data directory cannot be accessed or created.
+ */
+export class DataDirAccessError extends Error {
+    dataDir;
+    code;
+    constructor(message, dataDir, code) {
+        super(message);
+        this.name = 'DataDirAccessError';
+        this.dataDir = dataDir;
+        this.code = code;
+    }
+}
+/**
+ * Error thrown when data directory version is incompatible.
+ */
+export class DataDirVersionError extends Error {
+    oldVersion;
+    newVersion;
+    suggestedVersion;
+    constructor(message, oldVersion, newVersion, suggestedVersion) {
+        super(message);
+        this.name = 'DataDirVersionError';
+        this.oldVersion = oldVersion;
+        this.newVersion = newVersion;
+        this.suggestedVersion = suggestedVersion;
+    }
+}
+/**
+ * Parses a version string into its components.
+ *
+ * @param versionString - Version string like "4.0.1" or "4.0.1-beta.20"
+ * @returns Parsed version object with major, minor, patch, and optional prerelease
+ */
+export function parseVersion(versionString) {
+    // Match: major.minor.patch with optional prerelease
+    const match = versionString.match(/^(\d+)\.(\d+)\.(\d+)(?:-(.+))?$/);
+    if (!match) {
+        throw new Error(`Invalid version string: "${versionString}"`);
+    }
+    return {
+        major: parseInt(match[1], 10),
+        minor: parseInt(match[2], 10),
+        patch: parseInt(match[3], 10),
+        prerelease: match[4],
+        raw: versionString,
+    };
+}
+/**
+ * Formats a parsed version back to a string.
+ */
+export function formatVersion(version) {
+    const base = `${version.major}.${version.minor}.${version.patch}`;
+    return version.prerelease ? `${base}-${version.prerelease}` : base;
+}
+/**
+ * Parses the version file content to extract package name and version.
+ *
+ * @param content - Content like "@workflow/world-local@4.0.1-beta.20"
+ * @returns Object with packageName and version
+ */
+export function parseVersionFile(content) {
+    const trimmed = content.trim();
+    const lastAtIndex = trimmed.lastIndexOf('@');
+    if (lastAtIndex <= 0) {
+        throw new Error(`Invalid version file content: "${content}"`);
+    }
+    const packageName = trimmed.substring(0, lastAtIndex);
+    const versionString = trimmed.substring(lastAtIndex + 1);
+    return {
+        packageName,
+        version: parseVersion(versionString),
+    };
+}
+/**
+ * Formats the version file content.
+ */
+export function formatVersionFile(packageName, version) {
+    return `${packageName}@${formatVersion(version)}`;
+}
+/**
+ * Handles version upgrades between old and new versions.
+ * This function is called when the data directory was created with a different version.
+ *
+ * @param oldVersion - The version that created the data directory
+ * @param newVersion - The current package version
+ * @throws {DataDirVersionError} If the versions are incompatible
+ */
+export function upgradeVersion(oldVersion, newVersion) {
+    console.log(`[world-local] Upgrading from version ${formatVersion(oldVersion)} to ${formatVersion(newVersion)}`);
+}
+/**
+ * Ensures the data directory exists and is writable.
+ * Creates the directory if it doesn't exist.
+ *
+ * @param dataDir - The path to the data directory
+ * @throws {DataDirAccessError} If the directory cannot be created or accessed
+ */
+export async function ensureDataDir(dataDir) {
+    const absolutePath = path.resolve(dataDir);
+    // Try to create the directory if it doesn't exist
+    try {
+        await mkdir(absolutePath, { recursive: true });
+    }
+    catch (error) {
+        const nodeError = error;
+        // EEXIST is fine - directory already exists
+        if (nodeError.code !== 'EEXIST') {
+            throw new DataDirAccessError(`Failed to create data directory "${absolutePath}": ${nodeError.message}`, absolutePath, nodeError.code);
+        }
+    }
+    // Verify the directory is accessible (readable)
+    try {
+        await access(absolutePath, constants.R_OK);
+    }
+    catch (error) {
+        const nodeError = error;
+        throw new DataDirAccessError(`Data directory "${absolutePath}" is not readable: ${nodeError.message}`, absolutePath, nodeError.code);
+    }
+    // Verify the directory is writable by attempting to write a temp file
+    const testFile = path.join(absolutePath, `.workflow-write-test-${Date.now()}`);
+    try {
+        await writeFile(testFile, '');
+        // Clean up test file — ENOENT during cleanup is harmless (may race
+        // with another process performing the same check concurrently)
+        await unlink(testFile).catch((e) => {
+            if (e.code !== 'ENOENT')
+                throw e;
+        });
+    }
+    catch (error) {
+        const nodeError = error;
+        throw new DataDirAccessError(`Data directory "${absolutePath}" is not writable: ${nodeError.message}`, absolutePath, nodeError.code);
+    }
+}
+/**
+ * Reads the version from the data directory's version file.
+ *
+ * @param dataDir - Path to the data directory
+ * @returns The parsed version info, or null if the file doesn't exist
+ */
+async function readVersionFile(dataDir) {
+    const versionFilePath = path.join(path.resolve(dataDir), VERSION_FILENAME);
+    try {
+        const content = await readFile(versionFilePath, 'utf-8');
+        return parseVersionFile(content);
+    }
+    catch (error) {
+        const nodeError = error;
+        if (nodeError.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+}
+/**
+ * Writes the current version to the data directory's version file.
+ *
+ * @param dataDir - Path to the data directory
+ * @param version - The version to write
+ */
+async function writeVersionFile(dataDir, version) {
+    const versionFilePath = path.join(path.resolve(dataDir), VERSION_FILENAME);
+    const packageInfo = await getPackageInfo();
+    const content = formatVersionFile(packageInfo.name, version);
+    await writeFile(versionFilePath, content);
+}
+/**
+ * Gets the suggested downgrade version based on the old version.
+ * If a specific version is suggested in the error, use that.
+ * Otherwise, suggest the previous minor version if patch is 0,
+ * or previous major version if minor is also 0.
+ */
+function getSuggestedDowngradeVersion(oldVersion, suggestedVersion) {
+    if (suggestedVersion) {
+        return suggestedVersion;
+    }
+    // Suggest the old version as the downgrade target
+    return formatVersion(oldVersion);
+}
+/**
+ * Initializes the data directory, ensuring it exists, is accessible,
+ * and handles version compatibility.
+ *
+ * @param dataDir - The path to the data directory
+ * @throws {DataDirAccessError} If the directory cannot be created or accessed
+ */
+export async function initDataDir(dataDir) {
+    // First ensure the directory exists and is accessible
+    await ensureDataDir(dataDir);
+    const packageInfo = await getPackageInfo();
+    const currentVersion = parseVersion(packageInfo.version);
+    // Read existing version file
+    const existingVersionInfo = await readVersionFile(dataDir);
+    if (existingVersionInfo === null) {
+        // New data directory - write the current version
+        await writeVersionFile(dataDir, currentVersion);
+        return;
+    }
+    const { version: oldVersion } = existingVersionInfo;
+    // Check if versions are the same (no upgrade needed)
+    if (formatVersion(oldVersion) === formatVersion(currentVersion)) {
+        return;
+    }
+    // Attempt upgrade
+    try {
+        upgradeVersion(oldVersion, currentVersion);
+        // Upgrade succeeded - write the new version
+        await writeVersionFile(dataDir, currentVersion);
+    }
+    catch (error) {
+        const suggestedVersion = error instanceof DataDirVersionError ? error.suggestedVersion : undefined;
+        const downgradeTarget = getSuggestedDowngradeVersion(oldVersion, suggestedVersion);
+        console.error(`[world-local] Failed to upgrade data directory from version ${formatVersion(oldVersion)} to ${formatVersion(currentVersion)}:`, error instanceof Error ? error.message : error);
+        console.error(`[world-local] Data is not compatible with the current version. ` +
+            `Please downgrade to ${packageInfo.name}@${downgradeTarget}`);
+        throw error;
+    }
+}
+//# sourceMappingURL=init.js.map