@playcraft/cli 0.1.54 → 0.1.55-beta

package/templates/preview-runtime/v1/manifest.json

@@ -0,0 +1,17 @@
+{
+  "version": 1,
+  "sdkVersion": "0.0.1",
+  "protocolVersion": 1,
+  "files": {
+    "build-preview.mjs": "2bd512675d829cc07ceddcb58365a6f74d36ff93690f8d72f4bbaa1d45511c91",
+    "README.md": "6b248413bf2a3f096796b9aaf8fe77bc4aa01d862d47337be85af52a8b02e021",
+    "release-guard.mjs": "0c33d1559c68844f3760c3e754ee36ca70dc27151ef6f7ad62f29f95239679cc",
+    "runtime.d.mts": "03c2a2453ca136c7e21a4a43e3320d306d06b52cf8d46d9936c998cc98d754ad",
+    "runtime.d.ts": "03c2a2453ca136c7e21a4a43e3320d306d06b52cf8d46d9936c998cc98d754ad",
+    "runtime.mjs": "5a7efbfe4f6a7b020f112f0ef88bb4d1f9812a629ea8c2bc563f8a738d055bc5",
+    "types/adapters.d.ts": "785df9c5795e5e463ddf84f1acfea0eeebbfef631f19ddb5b49f1dabc7f0dba3",
+    "types/preview.d.ts": "1649e0a576a700263170d82addf6c0c7ed59e23767851241d054fc15928e044f",
+    "types/protocol.d.ts": "7af05fff6758df872efa3c6fd1310b5bdd65f03969dcaa361814d47881fcd45a",
+    "types/runtime.d.ts": "efcd429b24d75b06afb3f05ec3f8134efc381ede0dd59cb43ec5770e2559c77b"
+  }
+}

package/templates/preview-runtime/v1/release-guard.mjs

@@ -0,0 +1,87 @@
+import { createHash } from 'node:crypto';
+import { lstat, mkdir, readdir, readFile, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+
+const slash = value => value.replaceAll('\\', '/').replaceAll('\0', '').split('?')[0];
+const hash = value => createHash('sha256').update(value).digest('hex');
+const marker = /runtime\.parameters\.|playcraft-preview-storage:|__playcraft_preview_context__/i;
+/** A production-only Vite module boundary, separate from the development preview builder. */
+export function previewRuntimeReleaseGuard({ root = process.cwd(), previewEntries = [], reportPath = '.playcraft-editor-preview/release-report.json' } = {}) {
+  root = path.resolve(root);
+  const sdkRoot = slash(path.resolve(root, '.playcraft/preview-runtime')) + '/';
+  const entries = new Set(previewEntries.map(entry => slash(path.resolve(root, entry))));
+  const moduleIds = new Set();
+  let outputDirectory;
+  const forbidden = id => {
+    const normalized = slash(id);
+    return normalized.startsWith(sdkRoot) || entries.has(normalized) ||
+      /(?:^|\/)(?:@playcraft\/)?preview-runtime(?:\/|@|$)/.test(normalized) ||
+      /@playcraft\+preview-runtime@/.test(normalized);
+  };
+  const guard = id => { if (forbidden(id)) throw new Error('preview_runtime_in_production:' + id); };
+  async function reportDestination() {
+    const destination = path.resolve(root, reportPath);
+    const relative = path.relative(root, destination);
+    if (!relative || path.isAbsolute(relative) || relative.split(path.sep).includes('..') ||
+        destination === outputDirectory || destination.startsWith(outputDirectory + path.sep))
+      throw new Error('preview_runtime_release_report_path_invalid');
+    let current = root;
+    const segments = relative.split(path.sep);
+    for (const [index, segment] of segments.entries()) {
+      current = path.join(current, segment);
+      const stat = await lstat(current).catch(error => { if (error.code === 'ENOENT') return undefined; throw error; });
+      if (stat?.isSymbolicLink() || (stat && index < segments.length - 1 && !stat.isDirectory()))
+        throw new Error('preview_runtime_release_report_path_invalid');
+    }
+    return destination;
+  }
+  async function inspectOutput(directory, prefix = '') {
+    const artifacts = [];
+    for (const entry of await readdir(directory, { withFileTypes: true })) {
+      const file = path.join(directory, entry.name);
+      const relative = prefix + entry.name;
+      if (entry.isSymbolicLink()) throw new Error('preview_runtime_release_output_invalid');
+      if (entry.isDirectory()) artifacts.push(...await inspectOutput(file, relative + '/'));
+      else if (entry.isFile()) {
+        const bytes = await readFile(file);
+        if (marker.test(bytes.toString())) throw new Error('preview_runtime_marker_in_production:' + relative);
+        artifacts.push({ path: relative, sha256: hash(bytes) });
+      }
+    }
+    return artifacts;
+  }
+  return {
+    name: 'playcraft-preview-runtime-release-boundary',
+    enforce: 'pre',
+    apply: 'build',
+    async configResolved(config) {
+      outputDirectory = path.resolve(config.root, config.build.outDir);
+      const outputStat = await lstat(outputDirectory).catch(error => { if (error.code === 'ENOENT') return undefined; throw error; });
+      if (outputStat?.isSymbolicLink()) throw new Error('preview_runtime_release_output_invalid');
+      await reportDestination();
+    },
+    async buildStart() { await rm(await reportDestination(), { force: true }); },
+    resolveId(id) { guard(id); return null; },
+    transform(_code, id) { guard(id); return null; },
+    moduleParsed(info) { guard(info.id); moduleIds.add(info.id); },
+    generateBundle(_options, bundle) {
+      for (const id of this.getModuleIds()) { guard(id); moduleIds.add(id); }
+      for (const output of Object.values(bundle)) {
+        if (output.type === 'chunk') for (const id of Object.keys(output.modules)) guard(id);
+        const content = output.type === 'chunk' ? output.code : output.source;
+        if (marker.test(typeof content === 'string' ? content : Buffer.from(content).toString()))
+          throw new Error('preview_runtime_marker_in_production:' + output.fileName);
+      }
+    },
+    async writeBundle() {
+      const artifacts = await inspectOutput(outputDirectory);
+      const report = await reportDestination();
+      await mkdir(path.dirname(report), { recursive: true });
+      await reportDestination();
+      await writeFile(report, JSON.stringify({
+        version: 1, target: 'playable-release', previewRuntimeExcluded: true,
+        moduleIds: [...moduleIds].sort(), artifacts,
+      }, null, 2) + '\n', { flag: 'wx' });
+    },
+  };
+}

package/templates/preview-runtime/v1/runtime.d.mts

@@ -0,0 +1,3 @@
+export { connectPreviewRuntime, readWorkspacePreviewContext } from './types/preview.js';
+export type * from './types/adapters.js';
+export type * from './types/protocol.js';

package/templates/preview-runtime/v1/runtime.d.ts

@@ -0,0 +1,3 @@
+export { connectPreviewRuntime, readWorkspacePreviewContext } from './types/preview.js';
+export type * from './types/adapters.js';
+export type * from './types/protocol.js';