@dreamboard-games/sdk 0.5.0-alpha.0 → 0.5.0-alpha.2

package/dist/chunk-HUK4234C.js

@@ -1,166 +0,0 @@
-import {
-  generateWorkspaceArtifacts
-} from "./chunk-KGV2EUNN.js";
-import {
-  WORKSPACE_CODEGEN_OWNERSHIP
-} from "./chunk-HIH6Y4FA.js";
-
-// src/authoring/materialize-workspace.ts
-import { createHash, randomUUID } from "crypto";
-import { mkdir, readFile, rename, rm, stat, writeFile } from "fs/promises";
-import path from "path";
-import { pathToFileURL } from "url";
-import { build } from "esbuild";
-var authoritativePaths = new Set(
-  WORKSPACE_CODEGEN_OWNERSHIP.dynamic.generatedFiles
-);
-async function materializeWorkspace(options) {
-  const projectRoot = path.resolve(options.projectRoot ?? process.cwd());
-  const manifestPath = resolveProjectPath(projectRoot, options.manifestPath);
-  if (!await isFile(manifestPath)) {
-    throw new Error(`Manifest source does not exist: ${manifestPath}.`);
-  }
-  const manifest = await loadManifest({ manifestPath, projectRoot });
-  const artifacts = generateWorkspaceArtifacts(manifest);
-  const emittedAuthoritative = new Set(
-    artifacts.filter(({ ownership }) => ownership === "authoritative").map(({ path: artifactPath }) => artifactPath)
-  );
-  assertExactAuthoritativeInventory(emittedAuthoritative);
-  let seededFiles = 0;
-  const records = [];
-  for (const artifact of artifacts) {
-    const destination = resolveProjectPath(projectRoot, artifact.path);
-    if (artifact.ownership === "seed") {
-      if (!options.writeMissingSeeds || await isFile(destination)) {
-        continue;
-      }
-    }
-    await mkdir(path.dirname(destination), { recursive: true });
-    if (artifact.ownership === "authoritative") {
-      await writeAuthoritativeFile(destination, artifact.content);
-    } else {
-      await writeFile(destination, artifact.content);
-    }
-    if (artifact.ownership === "seed") {
-      seededFiles += 1;
-      continue;
-    }
-    const bytes = await readFile(destination);
-    const actual = createHash("sha256").update(bytes).digest("hex");
-    if (actual !== artifact.contentSha256) {
-      throw new Error(
-        `Generated ${artifact.path} digest does not match its declared digest.`
-      );
-    }
-    records.push({
-      path: artifact.path,
-      ownership: "authoritative",
-      sha256: `sha256:${actual}`
-    });
-  }
-  records.sort(
-    (left, right) => left.path < right.path ? -1 : left.path > right.path ? 1 : 0
-  );
-  return {
-    schemaVersion: 1,
-    projectRoot,
-    authoritativeFiles: records.length,
-    seededFiles,
-    artifacts: records,
-    digest: `sha256:${createHash("sha256").update(JSON.stringify(records)).digest("hex")}`
-  };
-}
-async function loadManifest(options) {
-  const typesEntry = await resolveCurrentSdkTypesFacade();
-  const entryPath = path.join(
-    options.projectRoot,
-    "node_modules/.cache/dreamboard-workspace-compiler",
-    `manifest-${process.pid}-${randomUUID()}.mjs`
-  );
-  await mkdir(path.dirname(entryPath), { recursive: true });
-  try {
-    const result = await build({
-      entryPoints: [options.manifestPath],
-      outfile: entryPath,
-      absWorkingDir: options.projectRoot,
-      bundle: true,
-      format: "esm",
-      platform: "node",
-      target: "node24",
-      alias: {
-        "@dreamboard-games/sdk/types": typesEntry
-      },
-      sourcemap: "inline",
-      logLevel: "silent"
-    });
-    void result;
-    const loaded = await import(pathToFileURL(entryPath).href);
-    const manifest = loaded.manifest ?? loaded.default;
-    if (!manifest || typeof manifest !== "object") {
-      throw new Error("Manifest source must export a manifest object.");
-    }
-    return manifest;
-  } finally {
-    await rm(entryPath, { force: true });
-  }
-}
-async function resolveCurrentSdkTypesFacade() {
-  const candidates = [
-    path.resolve(import.meta.dirname, "../types.ts"),
-    path.resolve(import.meta.dirname, "types.js")
-  ];
-  for (const candidate of candidates) {
-    if (await isFile(candidate)) return candidate;
-  }
-  throw new Error(
-    `Could not resolve the current @dreamboard-games/sdk/types facade from ${import.meta.dirname}.`
-  );
-}
-async function writeAuthoritativeFile(destination, content) {
-  const temporaryPath = path.join(
-    path.dirname(destination),
-    `.${path.basename(destination)}.${process.pid}.${randomUUID()}.tmp`
-  );
-  try {
-    await writeFile(temporaryPath, content);
-    await rename(temporaryPath, destination);
-  } finally {
-    await rm(temporaryPath, { force: true });
-  }
-}
-function assertExactAuthoritativeInventory(emitted) {
-  const missing = [...authoritativePaths].filter(
-    (value) => !emitted.has(value)
-  );
-  const unexpected = [...emitted].filter(
-    (value) => !authoritativePaths.has(value)
-  );
-  if (missing.length > 0 || unexpected.length > 0) {
-    throw new Error(
-      `SDK workspace ownership mismatch (missing: ${missing.join(", ") || "none"}; unexpected: ${unexpected.join(", ") || "none"}).`
-    );
-  }
-}
-function resolveProjectPath(projectRoot, value) {
-  if (typeof value !== "string" || value.length === 0 || path.isAbsolute(value) || value.split(/[\\/]+/).some((segment) => segment === "..")) {
-    throw new Error(`Workspace path must be project-relative: ${value}.`);
-  }
-  const resolved = path.resolve(projectRoot, value);
-  if (!resolved.startsWith(`${projectRoot}${path.sep}`)) {
-    throw new Error(`Workspace path escapes the project root: ${value}.`);
-  }
-  return resolved;
-}
-async function isFile(filePath) {
-  return stat(filePath).then((value) => value.isFile()).catch((error) => {
-    if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
-      return false;
-    }
-    throw error;
-  });
-}
-
-export {
-  materializeWorkspace
-};
-//# sourceMappingURL=chunk-HUK4234C.js.map

package/dist/chunk-HUK4234C.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/authoring/materialize-workspace.ts"],"sourcesContent":["import { createHash, randomUUID } from \"node:crypto\";\nimport { mkdir, readFile, rename, rm, stat, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { WORKSPACE_CODEGEN_OWNERSHIP } from \"@dreamboard-games/workspace-codegen\";\nimport { build } from \"esbuild\";\nimport { generateWorkspaceArtifacts } from \"./adapter.js\";\n\nexport type MaterializeWorkspaceOptions = {\n  readonly manifestPath: string;\n  readonly projectRoot?: string;\n  /** Scaffolding-only. Existing build/test paths leave seed files untouched. */\n  readonly writeMissingSeeds?: boolean;\n};\n\nexport type MaterializedWorkspaceResult = {\n  readonly schemaVersion: 1;\n  readonly projectRoot: string;\n  readonly authoritativeFiles: number;\n  readonly seededFiles: number;\n  readonly artifacts: readonly {\n    readonly path: string;\n    readonly ownership: \"authoritative\";\n    readonly sha256: `sha256:${string}`;\n  }[];\n  readonly digest: `sha256:${string}`;\n};\n\ntype ManifestModule = {\n  readonly default?: unknown;\n  readonly manifest?: unknown;\n};\n\nconst authoritativePaths = new Set(\n  WORKSPACE_CODEGEN_OWNERSHIP.dynamic.generatedFiles,\n);\n\n/**\n * Materialize SDK-owned workspace contracts from authored manifest source.\n * Authoritative files are always replaced. Seed files are untouched unless a\n * scaffolding caller explicitly opts in. No test state or projection artifact\n * is emitted.\n */\nexport async function materializeWorkspace(\n  options: MaterializeWorkspaceOptions,\n): Promise<MaterializedWorkspaceResult> {\n  const projectRoot = path.resolve(options.projectRoot ?? process.cwd());\n  const manifestPath = resolveProjectPath(projectRoot, options.manifestPath);\n  if (!(await isFile(manifestPath))) {\n    throw new Error(`Manifest source does not exist: ${manifestPath}.`);\n  }\n  const manifest = await loadManifest({ manifestPath, projectRoot });\n  const artifacts = generateWorkspaceArtifacts(manifest);\n  const emittedAuthoritative = new Set(\n    artifacts\n      .filter(({ ownership }) => ownership === \"authoritative\")\n      .map(({ path: artifactPath }) => artifactPath),\n  );\n  assertExactAuthoritativeInventory(emittedAuthoritative);\n\n  let seededFiles = 0;\n  const records: Array<{\n    readonly path: string;\n    readonly ownership: \"authoritative\";\n    readonly sha256: `sha256:${string}`;\n  }> = [];\n  for (const artifact of artifacts) {\n    const destination = resolveProjectPath(projectRoot, artifact.path);\n    if (artifact.ownership === \"seed\") {\n      if (!options.writeMissingSeeds || (await isFile(destination))) {\n        continue;\n      }\n    }\n    await mkdir(path.dirname(destination), { recursive: true });\n    if (artifact.ownership === \"authoritative\") {\n      await writeAuthoritativeFile(destination, artifact.content);\n    } else {\n      await writeFile(destination, artifact.content);\n    }\n    if (artifact.ownership === \"seed\") {\n      seededFiles += 1;\n      continue;\n    }\n    const bytes = await readFile(destination);\n    const actual = createHash(\"sha256\").update(bytes).digest(\"hex\");\n    if (actual !== artifact.contentSha256) {\n      throw new Error(\n        `Generated ${artifact.path} digest does not match its declared digest.`,\n      );\n    }\n    records.push({\n      path: artifact.path,\n      ownership: \"authoritative\",\n      sha256: `sha256:${actual}`,\n    });\n  }\n  records.sort((left, right) =>\n    left.path < right.path ? -1 : left.path > right.path ? 1 : 0,\n  );\n  return {\n    schemaVersion: 1,\n    projectRoot,\n    authoritativeFiles: records.length,\n    seededFiles,\n    artifacts: records,\n    digest: `sha256:${createHash(\"sha256\")\n      .update(JSON.stringify(records))\n      .digest(\"hex\")}`,\n  };\n}\n\nasync function loadManifest(options: {\n  readonly manifestPath: string;\n  readonly projectRoot: string;\n}): Promise<unknown> {\n  const typesEntry = await resolveCurrentSdkTypesFacade();\n  const entryPath = path.join(\n    options.projectRoot,\n    \"node_modules/.cache/dreamboard-workspace-compiler\",\n    `manifest-${process.pid}-${randomUUID()}.mjs`,\n  );\n  await mkdir(path.dirname(entryPath), { recursive: true });\n  try {\n    const result = await build({\n      entryPoints: [options.manifestPath],\n      outfile: entryPath,\n      absWorkingDir: options.projectRoot,\n      bundle: true,\n      format: \"esm\",\n      platform: \"node\",\n      target: \"node24\",\n      alias: {\n        \"@dreamboard-games/sdk/types\": typesEntry,\n      },\n      sourcemap: \"inline\",\n      logLevel: \"silent\",\n    });\n    void result;\n    const loaded = (await import(\n      pathToFileURL(entryPath).href\n    )) as ManifestModule;\n    const manifest = loaded.manifest ?? loaded.default;\n    if (!manifest || typeof manifest !== \"object\") {\n      throw new Error(\"Manifest source must export a manifest object.\");\n    }\n    return manifest;\n  } finally {\n    await rm(entryPath, { force: true });\n  }\n}\n\nasync function resolveCurrentSdkTypesFacade(): Promise<string> {\n  const candidates = [\n    path.resolve(import.meta.dirname, \"../types.ts\"),\n    path.resolve(import.meta.dirname, \"types.js\"),\n  ];\n  for (const candidate of candidates) {\n    if (await isFile(candidate)) return candidate;\n  }\n  throw new Error(\n    `Could not resolve the current @dreamboard-games/sdk/types facade from ${import.meta.dirname}.`,\n  );\n}\n\nasync function writeAuthoritativeFile(\n  destination: string,\n  content: string,\n): Promise<void> {\n  const temporaryPath = path.join(\n    path.dirname(destination),\n    `.${path.basename(destination)}.${process.pid}.${randomUUID()}.tmp`,\n  );\n  try {\n    await writeFile(temporaryPath, content);\n    await rename(temporaryPath, destination);\n  } finally {\n    await rm(temporaryPath, { force: true });\n  }\n}\n\nfunction assertExactAuthoritativeInventory(emitted: ReadonlySet<string>): void {\n  const missing = [...authoritativePaths].filter(\n    (value) => !emitted.has(value),\n  );\n  const unexpected = [...emitted].filter(\n    (value) => !authoritativePaths.has(value),\n  );\n  if (missing.length > 0 || unexpected.length > 0) {\n    throw new Error(\n      `SDK workspace ownership mismatch (missing: ${missing.join(\", \") || \"none\"}; unexpected: ${unexpected.join(\", \") || \"none\"}).`,\n    );\n  }\n}\n\nfunction resolveProjectPath(projectRoot: string, value: string): string {\n  if (\n    typeof value !== \"string\" ||\n    value.length === 0 ||\n    path.isAbsolute(value) ||\n    value.split(/[\\\\/]+/).some((segment) => segment === \"..\")\n  ) {\n    throw new Error(`Workspace path must be project-relative: ${value}.`);\n  }\n  const resolved = path.resolve(projectRoot, value);\n  if (!resolved.startsWith(`${projectRoot}${path.sep}`)) {\n    throw new Error(`Workspace path escapes the project root: ${value}.`);\n  }\n  return resolved;\n}\n\nasync function isFile(filePath: string): Promise<boolean> {\n  return stat(filePath)\n    .then((value) => value.isFile())\n    .catch((error: unknown) => {\n      if (\n        typeof error === \"object\" &&\n        error !== null &&\n        \"code\" in error &&\n        error.code === \"ENOENT\"\n      ) {\n        return false;\n      }\n      throw error;\n    });\n}\n"],"mappings":"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","names":[]}