@crowdedkingdoms/crowdyjs 9.0.0 → 11.0.0

package/dist/crowdy-studio/starter-projects.js

@@ -0,0 +1,102 @@
+import { projectTargets, } from './models.js';
+const SDK_VERSION = '0.1.5';
+/** Create a compile-oriented starter without introducing a raw JSON source map. */
+export function createCrowdyStudioStarterProject(options) {
+    const base = moduleName(options.name);
+    const targets = projectTargets(options.kind);
+    const metadata = {
+        name: options.name.trim() || 'Untitled mod',
+        ...(options.description?.trim()
+            ? { description: options.description.trim() }
+            : {}),
+        ...(targets.includes('SERVER')
+            ? { serverModuleName: `${base}-server` }
+            : {}),
+        ...(targets.includes('CLIENT')
+            ? { clientModuleName: `${base}-client` }
+            : {}),
+        pairingPreference: options.kind === 'FULL_STACK' ? 'REQUIRED' : 'NONE',
+    };
+    return {
+        appId: options.appId,
+        gridId: options.gridId,
+        kind: options.kind,
+        metadata,
+        files: targets.flatMap((target) => starterFiles(target, target === 'SERVER'
+            ? metadata.serverModuleName
+            : metadata.clientModuleName)),
+    };
+}
+function starterFiles(target, name) {
+    return [
+        {
+            target,
+            path: 'Cargo.toml',
+            content: `[package]
+name = "${name}"
+version = "0.1.0"
+edition = "2021"
+
+[lib]
+crate-type = ["cdylib"]
+
+[dependencies]
+crowdy-compute-sdk = "${SDK_VERSION}"
+`,
+        },
+        {
+            target,
+            path: 'src/lib.rs',
+            content: target === 'SERVER' ? serverSource() : clientSource(),
+        },
+    ];
+}
+function serverSource() {
+    return `use crowdy_compute_sdk as crowdy;
+
+fn on_init() {
+    // Runs once when this SERVER module starts on the owned grid.
+}
+
+fn on_tick(_dt_ms: u32) {
+    // Server host calls are permission checked and clamped to the owned grid.
+    // Type "crowdy::" for the platform-indexed host-call surface.
+}
+
+fn on_invoke(payload: &[u8]) -> Vec<u8> {
+    // Called by Crowdy Studio's Invoke panel or an allowed game caller.
+    payload.to_vec()
+}
+
+crowdy::register_module!(init: on_init, tick: on_tick, invoke: on_invoke);
+`;
+}
+function clientSource() {
+    return `use crowdy_compute_sdk as crowdy;
+
+fn on_init() {
+    // Runs after the hash-bound CLIENT artifact enters the browser sandbox.
+}
+
+fn on_tick(_dt_ms: u32) {
+    // Client host calls are allow-listed by PlayerCodeBroker. Presentation
+    // effects (for example HUD updates) never receive the page's app token.
+    // Type "crowdy::" for lifecycle and host-call completions.
+}
+
+fn on_invoke(payload: &[u8]) -> Vec<u8> {
+    payload.to_vec()
+}
+
+crowdy::register_module!(init: on_init, tick: on_tick, invoke: on_invoke);
+`;
+}
+function moduleName(value) {
+    const slug = value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/gu, '-')
+        .replace(/^-+|-+$/gu, '')
+        .slice(0, 48);
+    return slug || 'player-mod';
+}

package/dist/crowdy-studio/styles.d.ts

@@ -0,0 +1,2 @@
+export declare const CROWDY_STUDIO_STYLES = "\n.ck-crowdy-studio{--ck-bg:#111827;--ck-panel:#182235;--ck-line:#334155;--ck-text:#e5e7eb;--ck-muted:#94a3b8;--ck-accent:#38bdf8;display:grid;grid-template-rows:auto auto minmax(360px,1fr) minmax(150px,.36fr);min-height:680px;background:var(--ck-bg);color:var(--ck-text);font:13px/1.4 ui-sans-serif,system-ui,sans-serif;border:1px solid var(--ck-line)}\n.ck-crowdy-studio *{box-sizing:border-box}.ck-crowdy-studio button,.ck-crowdy-studio input,.ck-crowdy-studio select,.ck-crowdy-studio textarea{font:inherit}.ck-crowdy-studio button,.ck-crowdy-studio select,.ck-crowdy-studio input{background:#0f172a;color:var(--ck-text);border:1px solid var(--ck-line);border-radius:4px;padding:5px 8px}.ck-crowdy-studio button{cursor:pointer}.ck-crowdy-studio button:hover{border-color:var(--ck-accent)}.ck-crowdy-studio button:disabled{opacity:.5;cursor:not-allowed}\n.ck-crowdy-studio-toolbar,.ck-crowdy-studio-actions,.ck-crowdy-studio-tabs,.ck-crowdy-studio-panel-tabs{display:flex;align-items:center;gap:6px;padding:7px;border-bottom:1px solid var(--ck-line)}.ck-crowdy-studio-toolbar{justify-content:space-between;flex-wrap:wrap}.ck-crowdy-studio-project-tools,.ck-crowdy-studio-runtime-tools{display:flex;align-items:center;gap:6px;flex-wrap:wrap}\n.ck-crowdy-studio-save[data-state=SAVED]{color:#86efac}.ck-crowdy-studio-save[data-state=SAVING]{color:#fde68a}.ck-crowdy-studio-save[data-state=CONFLICT]{color:#fca5a5}.ck-crowdy-studio-save[data-state=OFFLINE]{color:#fdba74}\n.ck-crowdy-studio-main{display:grid;grid-template-columns:230px minmax(0,1fr) 260px;min-height:0}.ck-crowdy-studio-explorer,.ck-crowdy-studio-settings{background:var(--ck-panel);overflow:auto;padding:8px}.ck-crowdy-studio-explorer{border-right:1px solid var(--ck-line)}.ck-crowdy-studio-settings{border-left:1px solid var(--ck-line)}.ck-crowdy-studio-editor-column{display:grid;grid-template-rows:auto minmax(0,1fr);min-width:0}\n.ck-crowdy-studio-editor{min-height:0;position:relative}.ck-crowdy-studio-textarea{width:100%;height:100%;min-height:330px;resize:none;background:#0b1020;color:var(--ck-text);border:0;padding:12px;font:13px/1.5 ui-monospace,SFMono-Regular,Consolas,monospace}.ck-crowdy-studio-editor-notice{padding:4px 8px;background:#78350f;color:#ffedd5}\n.ck-crowdy-studio-section{margin-bottom:12px}.ck-crowdy-studio-section-header{display:flex;align-items:center;justify-content:space-between;color:var(--ck-muted);font-weight:700;text-transform:uppercase;font-size:11px;margin-bottom:4px}.ck-crowdy-studio-file{display:grid;grid-template-columns:minmax(0,1fr) auto auto;gap:3px;align-items:center}.ck-crowdy-studio-file>button:first-child{text-align:left;overflow:hidden;text-overflow:ellipsis;border:0;background:transparent}.ck-crowdy-studio-file>button:not(:first-child){padding:1px 4px}\n.ck-crowdy-studio-tabs{padding:4px;overflow:auto}.ck-crowdy-studio-tab[data-active=true],.ck-crowdy-studio-panel-tab[data-active=true]{border-color:var(--ck-accent);color:#bae6fd}.ck-crowdy-studio-tab{white-space:nowrap}.ck-crowdy-studio-tab span{margin-left:7px;color:var(--ck-muted)}\n.ck-crowdy-studio-settings label{display:grid;gap:3px;margin-bottom:9px;color:var(--ck-muted)}.ck-crowdy-studio-settings input,.ck-crowdy-studio-settings select{width:100%}.ck-crowdy-studio-new{display:none;gap:6px;align-items:center;width:100%;padding:7px;border-bottom:1px solid var(--ck-line)}.ck-crowdy-studio-new[data-open=true]{display:flex}.ck-crowdy-studio-new input{flex:1}\n.ck-crowdy-studio-bottom{display:grid;grid-template-rows:auto minmax(0,1fr);min-height:0;border-top:1px solid var(--ck-line)}.ck-crowdy-studio-panel{display:none;overflow:auto;padding:8px}.ck-crowdy-studio-panel[data-active=true]{display:block}.ck-crowdy-studio-panel pre{white-space:pre-wrap;margin:0;font:12px/1.5 ui-monospace,SFMono-Regular,Consolas,monospace}.ck-crowdy-studio-problem{display:grid;grid-template-columns:auto auto 1fr;gap:8px;padding:3px;border-bottom:1px solid #243247}.ck-crowdy-studio-problem[data-source=rustc]{color:#fecaca}.ck-crowdy-studio-problem[data-source=local-advisory]{color:#fde68a}\n.ck-crowdy-studio-status{color:var(--ck-muted)}.ck-crowdy-studio-invoke{display:grid;grid-template-columns:180px 1fr auto;gap:6px}.ck-crowdy-studio-invoke textarea{min-height:70px;background:#0f172a;color:var(--ck-text);border:1px solid var(--ck-line)}.ck-crowdy-studio-empty{color:var(--ck-muted);padding:8px}\n@media(max-width:900px){.ck-crowdy-studio-main{grid-template-columns:180px minmax(0,1fr)}.ck-crowdy-studio-settings{display:none}}@media(max-width:620px){.ck-crowdy-studio-main{grid-template-columns:1fr}.ck-crowdy-studio-explorer{display:none}}\n";
+//# sourceMappingURL=styles.d.ts.map

package/dist/crowdy-studio/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/crowdy-studio/styles.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,6hJAahC,CAAC"}

package/dist/crowdy-studio/styles.js

@@ -0,0 +1,14 @@
+export const CROWDY_STUDIO_STYLES = `
+.ck-crowdy-studio{--ck-bg:#111827;--ck-panel:#182235;--ck-line:#334155;--ck-text:#e5e7eb;--ck-muted:#94a3b8;--ck-accent:#38bdf8;display:grid;grid-template-rows:auto auto minmax(360px,1fr) minmax(150px,.36fr);min-height:680px;background:var(--ck-bg);color:var(--ck-text);font:13px/1.4 ui-sans-serif,system-ui,sans-serif;border:1px solid var(--ck-line)}
+.ck-crowdy-studio *{box-sizing:border-box}.ck-crowdy-studio button,.ck-crowdy-studio input,.ck-crowdy-studio select,.ck-crowdy-studio textarea{font:inherit}.ck-crowdy-studio button,.ck-crowdy-studio select,.ck-crowdy-studio input{background:#0f172a;color:var(--ck-text);border:1px solid var(--ck-line);border-radius:4px;padding:5px 8px}.ck-crowdy-studio button{cursor:pointer}.ck-crowdy-studio button:hover{border-color:var(--ck-accent)}.ck-crowdy-studio button:disabled{opacity:.5;cursor:not-allowed}
+.ck-crowdy-studio-toolbar,.ck-crowdy-studio-actions,.ck-crowdy-studio-tabs,.ck-crowdy-studio-panel-tabs{display:flex;align-items:center;gap:6px;padding:7px;border-bottom:1px solid var(--ck-line)}.ck-crowdy-studio-toolbar{justify-content:space-between;flex-wrap:wrap}.ck-crowdy-studio-project-tools,.ck-crowdy-studio-runtime-tools{display:flex;align-items:center;gap:6px;flex-wrap:wrap}
+.ck-crowdy-studio-save[data-state=SAVED]{color:#86efac}.ck-crowdy-studio-save[data-state=SAVING]{color:#fde68a}.ck-crowdy-studio-save[data-state=CONFLICT]{color:#fca5a5}.ck-crowdy-studio-save[data-state=OFFLINE]{color:#fdba74}
+.ck-crowdy-studio-main{display:grid;grid-template-columns:230px minmax(0,1fr) 260px;min-height:0}.ck-crowdy-studio-explorer,.ck-crowdy-studio-settings{background:var(--ck-panel);overflow:auto;padding:8px}.ck-crowdy-studio-explorer{border-right:1px solid var(--ck-line)}.ck-crowdy-studio-settings{border-left:1px solid var(--ck-line)}.ck-crowdy-studio-editor-column{display:grid;grid-template-rows:auto minmax(0,1fr);min-width:0}
+.ck-crowdy-studio-editor{min-height:0;position:relative}.ck-crowdy-studio-textarea{width:100%;height:100%;min-height:330px;resize:none;background:#0b1020;color:var(--ck-text);border:0;padding:12px;font:13px/1.5 ui-monospace,SFMono-Regular,Consolas,monospace}.ck-crowdy-studio-editor-notice{padding:4px 8px;background:#78350f;color:#ffedd5}
+.ck-crowdy-studio-section{margin-bottom:12px}.ck-crowdy-studio-section-header{display:flex;align-items:center;justify-content:space-between;color:var(--ck-muted);font-weight:700;text-transform:uppercase;font-size:11px;margin-bottom:4px}.ck-crowdy-studio-file{display:grid;grid-template-columns:minmax(0,1fr) auto auto;gap:3px;align-items:center}.ck-crowdy-studio-file>button:first-child{text-align:left;overflow:hidden;text-overflow:ellipsis;border:0;background:transparent}.ck-crowdy-studio-file>button:not(:first-child){padding:1px 4px}
+.ck-crowdy-studio-tabs{padding:4px;overflow:auto}.ck-crowdy-studio-tab[data-active=true],.ck-crowdy-studio-panel-tab[data-active=true]{border-color:var(--ck-accent);color:#bae6fd}.ck-crowdy-studio-tab{white-space:nowrap}.ck-crowdy-studio-tab span{margin-left:7px;color:var(--ck-muted)}
+.ck-crowdy-studio-settings label{display:grid;gap:3px;margin-bottom:9px;color:var(--ck-muted)}.ck-crowdy-studio-settings input,.ck-crowdy-studio-settings select{width:100%}.ck-crowdy-studio-new{display:none;gap:6px;align-items:center;width:100%;padding:7px;border-bottom:1px solid var(--ck-line)}.ck-crowdy-studio-new[data-open=true]{display:flex}.ck-crowdy-studio-new input{flex:1}
+.ck-crowdy-studio-bottom{display:grid;grid-template-rows:auto minmax(0,1fr);min-height:0;border-top:1px solid var(--ck-line)}.ck-crowdy-studio-panel{display:none;overflow:auto;padding:8px}.ck-crowdy-studio-panel[data-active=true]{display:block}.ck-crowdy-studio-panel pre{white-space:pre-wrap;margin:0;font:12px/1.5 ui-monospace,SFMono-Regular,Consolas,monospace}.ck-crowdy-studio-problem{display:grid;grid-template-columns:auto auto 1fr;gap:8px;padding:3px;border-bottom:1px solid #243247}.ck-crowdy-studio-problem[data-source=rustc]{color:#fecaca}.ck-crowdy-studio-problem[data-source=local-advisory]{color:#fde68a}
+.ck-crowdy-studio-status{color:var(--ck-muted)}.ck-crowdy-studio-invoke{display:grid;grid-template-columns:180px 1fr auto;gap:6px}.ck-crowdy-studio-invoke textarea{min-height:70px;background:#0f172a;color:var(--ck-text);border:1px solid var(--ck-line)}.ck-crowdy-studio-empty{color:var(--ck-muted);padding:8px}
+@media(max-width:900px){.ck-crowdy-studio-main{grid-template-columns:180px minmax(0,1fr)}.ck-crowdy-studio-settings{display:none}}@media(max-width:620px){.ck-crowdy-studio-main{grid-template-columns:1fr}.ck-crowdy-studio-explorer{display:none}}
+`;

package/dist/crowdy-studio/textarea-editor.d.ts

@@ -0,0 +1,8 @@
+import type { CrowdyStudioEditorAdapter, CrowdyStudioEditorCallbacks } from './editor.js';
+/**
+ * Target/file-aware fallback used when Monaco or the local Rust worker cannot
+ * start. It edits the active source file directly; project tabs and explorer
+ * continue to work and no JSON source blob is exposed.
+ */
+export declare function createTextareaCrowdyStudioEditor(host: HTMLElement, callbacks: CrowdyStudioEditorCallbacks): CrowdyStudioEditorAdapter;
+//# sourceMappingURL=textarea-editor.d.ts.map

package/dist/crowdy-studio/textarea-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textarea-editor.d.ts","sourceRoot":"","sources":["../../src/crowdy-studio/textarea-editor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,yBAAyB,EACzB,2BAA2B,EAC5B,MAAM,aAAa,CAAC;AAGrB;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,2BAA2B,GACrC,yBAAyB,CAwD3B"}

package/dist/crowdy-studio/textarea-editor.js

@@ -0,0 +1,71 @@
+/**
+ * Target/file-aware fallback used when Monaco or the local Rust worker cannot
+ * start. It edits the active source file directly; project tabs and explorer
+ * continue to work and no JSON source blob is exposed.
+ */
+export function createTextareaCrowdyStudioEditor(host, callbacks) {
+    const notice = document.createElement('div');
+    notice.className = 'ck-crowdy-studio-editor-notice';
+    notice.textContent =
+        'Basic editor active — Monaco or the local Rust worker was unavailable.';
+    const textarea = document.createElement('textarea');
+    textarea.className = 'ck-crowdy-studio-textarea';
+    textarea.rows = 24;
+    textarea.spellcheck = false;
+    textarea.setAttribute('aria-label', 'Project source editor');
+    host.replaceChildren(notice, textarea);
+    let active = null;
+    let disposed = false;
+    const onInput = () => {
+        if (disposed ||
+            active?.source !== 'PROJECT' ||
+            !active.target) {
+            return;
+        }
+        callbacks.onProjectFileChange(active.target, active.path, textarea.value);
+    };
+    textarea.addEventListener('input', onInput);
+    return {
+        mode: 'textarea',
+        sync(state) {
+            if (disposed)
+                return;
+            const next = state.activeFile;
+            active = next;
+            if (!next) {
+                textarea.value = '';
+                textarea.disabled = true;
+                textarea.placeholder = 'Create or open a project file';
+                delete textarea.dataset.target;
+                delete textarea.dataset.path;
+                return;
+            }
+            textarea.disabled = false;
+            textarea.readOnly = next.source !== 'PROJECT';
+            textarea.dataset.target = next.target ?? 'SHARED';
+            textarea.dataset.path = next.path;
+            const content = contentFor(state, next);
+            if (textarea.value !== content)
+                textarea.value = content;
+        },
+        layout() { },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            textarea.removeEventListener('input', onInput);
+            host.replaceChildren();
+        },
+    };
+}
+function contentFor(state, ref) {
+    if (ref.source === 'PROJECT') {
+        return (state.project?.files.find((file) => file.target === ref.target && file.path === ref.path)?.content ?? '');
+    }
+    const files = ref.source === 'PERSONAL_LIBRARY'
+        ? state.personalLibraryFiles
+        : state.commonFiles;
+    return (files.find((file) => ref.referenceId
+        ? file.id === ref.referenceId
+        : file.path === ref.path && file.target === ref.target)?.content ?? '');
+}

package/dist/domains/crowdyStudio.d.ts

@@ -0,0 +1,27 @@
+import type { GraphQLClient } from '../client.js';
+import { type CreateCrowdyStudioProjectInput, type ImportCrowdyStudioReferenceFileInput, type CrowdyStudioProject, type CrowdyStudioProjectProvider, type CrowdyStudioProjectScope, type CrowdyStudioProjectSummary, type CrowdyStudioReferenceFile, type SaveCrowdyStudioLibraryFileInput, type SaveCrowdyStudioProjectInput } from '../crowdy-studio/models.js';
+/**
+ * Schema-coupled Game API adapter for private Crowdy Studio projects and
+ * reusable files. Generated GraphQL documents and DTOs stay in this module;
+ * the controller and public project models remain transport-neutral. Mutable
+ * projects remain separate from immutable player-compute versions, and only
+ * the controller's deploy path converts target files to sourceFilesJson.
+ */
+export declare class CrowdyStudioAPI implements CrowdyStudioProjectProvider {
+    private readonly graphql;
+    private readonly baselines;
+    constructor(graphql: GraphQLClient);
+    listProjects(scope: CrowdyStudioProjectScope): Promise<CrowdyStudioProjectSummary[]>;
+    getProject(input: CrowdyStudioProjectScope & {
+        projectId: string;
+    }): Promise<CrowdyStudioProject>;
+    createProject(input: CreateCrowdyStudioProjectInput): Promise<CrowdyStudioProject>;
+    saveProject(input: SaveCrowdyStudioProjectInput): Promise<CrowdyStudioProject>;
+    listPersonalLibraryFiles(scope: CrowdyStudioProjectScope): Promise<CrowdyStudioReferenceFile[]>;
+    savePersonalLibraryFile(input: SaveCrowdyStudioLibraryFileInput): Promise<CrowdyStudioReferenceFile>;
+    listCommonFiles(scope: CrowdyStudioProjectScope): Promise<CrowdyStudioReferenceFile[]>;
+    importReferenceFile(input: ImportCrowdyStudioReferenceFileInput): Promise<CrowdyStudioProject>;
+    private remember;
+    private request;
+}
+//# sourceMappingURL=crowdyStudio.d.ts.map

package/dist/domains/crowdyStudio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crowdyStudio.d.ts","sourceRoot":"","sources":["../../src/domains/crowdyStudio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAQlD,OAAO,EAIL,KAAK,8BAA8B,EACnC,KAAK,oCAAoC,EAEzC,KAAK,mBAAmB,EAExB,KAAK,2BAA2B,EAChC,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,gCAAgC,EACrC,KAAK,4BAA4B,EAClC,MAAM,4BAA4B,CAAC;AA0BpC;;;;;;GAMG;AACH,qBAAa,eAAgB,YAAW,2BAA2B;IAGrD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;gBAEvC,OAAO,EAAE,aAAa;IAE7C,YAAY,CAChB,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,0BAA0B,EAAE,CAAC;IAUlC,UAAU,CACd,KAAK,EAAE,wBAAwB,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GACtD,OAAO,CAAC,mBAAmB,CAAC;IAQzB,aAAa,CACjB,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,mBAAmB,CAAC;IAoBzB,WAAW,CACf,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,mBAAmB,CAAC;IAwDzB,wBAAwB,CAC5B,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,yBAAyB,EAAE,CAAC;IAUjC,uBAAuB,CAC3B,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,yBAAyB,CAAC;IAc/B,eAAe,CACnB,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,yBAAyB,EAAE,CAAC;IASjC,mBAAmB,CACvB,KAAK,EAAE,oCAAoC,GAC1C,OAAO,CAAC,mBAAmB,CAAC;IAuB/B,OAAO,CAAC,QAAQ;YAKF,OAAO;CAiBtB"}

package/dist/domains/crowdyStudio.js

@@ -0,0 +1,301 @@
+import { CrowdyGraphQLError, CrowdyHttpError, CrowdyNetworkError, CrowdyTimeoutError, } from '../errors.js';
+import { CrowdyStudioOfflineError, CrowdyStudioRevisionConflictError, normalizeCrowdyStudioPath, } from '../crowdy-studio/models.js';
+import { CrowdyStudioCommonFilesDocument, CrowdyStudioImportSource, CrowdyStudioLibraryFilesDocument, CrowdyStudioLibrarySaveDocument, CrowdyStudioPairingPreference as CrowdyStudioPairingPreferenceEnum, CrowdyStudioProjectCreateDocument, CrowdyStudioProjectDocument, CrowdyStudioProjectImportFileDocument, CrowdyStudioProjectSaveDocument, CrowdyStudioProjectsDocument, } from '../generated/graphql.js';
+/**
+ * Schema-coupled Game API adapter for private Crowdy Studio projects and
+ * reusable files. Generated GraphQL documents and DTOs stay in this module;
+ * the controller and public project models remain transport-neutral. Mutable
+ * projects remain separate from immutable player-compute versions, and only
+ * the controller's deploy path converts target files to sourceFilesJson.
+ */
+export class CrowdyStudioAPI {
+    constructor(graphql) {
+        this.graphql = graphql;
+        this.baselines = new Map();
+    }
+    async listProjects(scope) {
+        const data = await this.request(CrowdyStudioProjectsDocument, {
+            appId: scope.appId,
+            includeArchived: false,
+            limit: 50,
+            offset: 0,
+        });
+        return data.crowdyStudioProjects.map(fromSummaryDto);
+    }
+    async getProject(input) {
+        const data = await this.request(CrowdyStudioProjectDocument, {
+            appId: input.appId,
+            projectId: input.projectId,
+        });
+        return this.remember(fromProjectDto(data.crowdyStudioProject, input.gridId));
+    }
+    async createProject(input) {
+        const data = await this.request(CrowdyStudioProjectCreateDocument, {
+            input: {
+                appId: input.appId,
+                gridId: input.gridId,
+                name: input.metadata.name,
+                description: input.metadata.description ?? null,
+                serverModuleName: input.metadata.serverModuleName ?? null,
+                clientModuleName: input.metadata.clientModuleName ?? null,
+                pairingPreference: toApiPairing(input.kind, input.metadata.pairingPreference),
+                sdkVersion: '0.1.5',
+                abiVersion: 0,
+                initialFiles: input.files.map(toApiFile),
+            },
+        });
+        return this.remember(fromProjectDto(data.crowdyStudioProjectCreate, input.gridId));
+    }
+    async saveProject(input) {
+        try {
+            const baseline = this.baselines.get(input.projectId) ??
+                (await this.getProject({
+                    appId: input.appId,
+                    gridId: input.gridId,
+                    projectId: input.projectId,
+                }));
+            const delta = projectFileDelta(baseline, input);
+            const data = await this.request(CrowdyStudioProjectSaveDocument, {
+                input: {
+                    appId: input.appId,
+                    projectId: input.projectId,
+                    expectedRevision: input.expectedRevisionId,
+                    gridId: input.gridId,
+                    name: input.metadata.name,
+                    description: input.metadata.description ?? null,
+                    serverModuleName: input.metadata.serverModuleName ?? null,
+                    clientModuleName: input.metadata.clientModuleName ?? null,
+                    pairingPreference: toApiPairing(projectKind(input), input.metadata.pairingPreference),
+                    upserts: delta.upserts.map(toApiFile),
+                    deletes: delta.deletes.map(({ target, path }) => ({
+                        target: target,
+                        path,
+                    })),
+                },
+            });
+            return this.remember(fromProjectDto(data.crowdyStudioProjectSave, input.gridId));
+        }
+        catch (error) {
+            if (error instanceof CrowdyGraphQLError &&
+                error.code === 'CONFLICT' &&
+                error.message.includes('CROWDY_STUDIO_REVISION_CONFLICT')) {
+                let remoteProject;
+                try {
+                    remoteProject = await this.getProject({
+                        appId: input.appId,
+                        gridId: input.gridId,
+                        projectId: input.projectId,
+                    });
+                }
+                catch {
+                    // The conflict remains actionable if the follow-up read fails.
+                }
+                throw new CrowdyStudioRevisionConflictError(error.message, remoteProject);
+            }
+            throw error;
+        }
+    }
+    async listPersonalLibraryFiles(scope) {
+        const data = await this.request(CrowdyStudioLibraryFilesDocument, {
+            appId: scope.appId,
+            includeArchived: false,
+            limit: 100,
+            offset: 0,
+        });
+        return data.crowdyStudioLibraryFiles.map(fromLibraryDto);
+    }
+    async savePersonalLibraryFile(input) {
+        const data = await this.request(CrowdyStudioLibrarySaveDocument, {
+            input: {
+                appId: input.appId,
+                title: input.title,
+                pathHint: normalizeCrowdyStudioPath(input.path),
+                target: input.target,
+                tags: input.tags ?? [],
+                content: input.content,
+            },
+        });
+        return fromLibraryDto(data.crowdyStudioLibrarySave);
+    }
+    async listCommonFiles(scope) {
+        const data = await this.request(CrowdyStudioCommonFilesDocument, {
+            appId: scope.appId,
+            limit: 100,
+            offset: 0,
+        });
+        return data.crowdyStudioCommonFiles.map(fromCommonDto);
+    }
+    async importReferenceFile(input) {
+        const data = await this.request(CrowdyStudioProjectImportFileDocument, {
+            input: {
+                appId: input.appId,
+                projectId: input.projectId,
+                expectedProjectRevision: input.expectedRevisionId,
+                source: input.source === 'PERSONAL_LIBRARY'
+                    ? CrowdyStudioImportSource.Library
+                    : CrowdyStudioImportSource.Common,
+                ...(input.source === 'PERSONAL_LIBRARY'
+                    ? { libraryFileId: input.referenceId }
+                    : { commonVersionId: input.referenceId }),
+                ...(input.destinationPath
+                    ? { destinationPath: normalizeCrowdyStudioPath(input.destinationPath) }
+                    : {}),
+            },
+        });
+        return this.remember(fromProjectDto(data.crowdyStudioProjectImportFile, input.gridId));
+    }
+    remember(project) {
+        this.baselines.set(project.projectId, cloneProject(project));
+        return project;
+    }
+    async request(document, variables) {
+        try {
+            return await this.graphql.request(document, variables);
+        }
+        catch (error) {
+            if (error instanceof CrowdyNetworkError ||
+                error instanceof CrowdyTimeoutError ||
+                (error instanceof CrowdyHttpError && error.status >= 500)) {
+                throw new CrowdyStudioOfflineError(error.message, error);
+            }
+            throw error;
+        }
+    }
+}
+function fromSummaryDto(dto) {
+    return {
+        projectId: dto.projectId,
+        name: dto.name,
+        kind: kindFromApi(dto.pairingPreference),
+        revisionId: String(dto.revision),
+        ...(dto.serverModuleName
+            ? { serverModuleName: dto.serverModuleName }
+            : {}),
+        ...(dto.clientModuleName
+            ? { clientModuleName: dto.clientModuleName }
+            : {}),
+        updatedAt: dto.updatedAt,
+    };
+}
+function fromProjectDto(dto, fallbackGridId) {
+    const files = dto.files.map((file) => ({
+        target: file.target,
+        path: normalizeCrowdyStudioPath(file.path),
+        content: file.content,
+    }));
+    return {
+        projectId: dto.projectId,
+        appId: String(dto.appId),
+        gridId: dto.gridId == null ? fallbackGridId : String(dto.gridId),
+        kind: kindFromApi(dto.pairingPreference),
+        metadata: {
+            name: dto.name,
+            ...(dto.description ? { description: dto.description } : {}),
+            ...(dto.serverModuleName
+                ? { serverModuleName: dto.serverModuleName }
+                : {}),
+            ...(dto.clientModuleName
+                ? { clientModuleName: dto.clientModuleName }
+                : {}),
+            pairingPreference: fromApiPairing(dto.pairingPreference),
+        },
+        files,
+        sdkVersion: dto.sdkVersion,
+        abiVersion: dto.abiVersion,
+        revision: {
+            id: String(dto.revision),
+            savedAt: dto.updatedAt,
+        },
+        createdAt: dto.createdAt,
+        updatedAt: dto.updatedAt,
+    };
+}
+function fromLibraryDto(dto) {
+    return {
+        id: dto.libraryFileId,
+        source: 'PERSONAL_LIBRARY',
+        title: dto.title,
+        target: dto.target,
+        path: normalizeCrowdyStudioPath(dto.pathHint),
+        content: dto.content,
+        tags: [...dto.tags],
+        updatedAt: dto.updatedAt,
+    };
+}
+function fromCommonDto(dto) {
+    return {
+        id: dto.versionId,
+        source: 'COMMON',
+        title: dto.title,
+        target: dto.target,
+        path: normalizeCrowdyStudioPath(dto.path),
+        content: dto.content,
+        tags: [...dto.tags],
+        updatedAt: dto.updatedAt,
+    };
+}
+function kindFromApi(pairing) {
+    if (pairing === CrowdyStudioPairingPreferenceEnum.ServerOnly)
+        return 'SERVER';
+    if (pairing === CrowdyStudioPairingPreferenceEnum.ClientOnly)
+        return 'CLIENT';
+    return 'FULL_STACK';
+}
+function fromApiPairing(pairing) {
+    if (pairing === CrowdyStudioPairingPreferenceEnum.Paired)
+        return 'REQUIRED';
+    if (pairing === CrowdyStudioPairingPreferenceEnum.Independent)
+        return 'OPTIONAL';
+    return 'NONE';
+}
+function toApiPairing(kind, pairing) {
+    if (kind === 'SERVER')
+        return CrowdyStudioPairingPreferenceEnum.ServerOnly;
+    if (kind === 'CLIENT')
+        return CrowdyStudioPairingPreferenceEnum.ClientOnly;
+    return pairing === 'REQUIRED'
+        ? CrowdyStudioPairingPreferenceEnum.Paired
+        : CrowdyStudioPairingPreferenceEnum.Independent;
+}
+function toApiFile(file) {
+    return {
+        target: file.target,
+        path: normalizeCrowdyStudioPath(file.path),
+        content: file.content,
+    };
+}
+function projectKind(input) {
+    const hasServer = input.files.some((file) => file.target === 'SERVER');
+    const hasClient = input.files.some((file) => file.target === 'CLIENT');
+    if (hasServer && hasClient)
+        return 'FULL_STACK';
+    if (hasServer)
+        return 'SERVER';
+    return 'CLIENT';
+}
+function projectFileDelta(baseline, input) {
+    const previous = new Map(baseline.files.map((file) => [
+        `${file.target}:${normalizeCrowdyStudioPath(file.path)}`,
+        file,
+    ]));
+    const current = new Map(input.files.map((file) => [
+        `${file.target}:${normalizeCrowdyStudioPath(file.path)}`,
+        file,
+    ]));
+    const upserts = input.files.filter((file) => {
+        const before = previous.get(`${file.target}:${normalizeCrowdyStudioPath(file.path)}`);
+        return !before || before.content !== file.content;
+    });
+    const deletes = baseline.files
+        .filter((file) => !current.has(`${file.target}:${normalizeCrowdyStudioPath(file.path)}`))
+        .map((file) => ({ target: file.target, path: file.path }));
+    return { upserts, deletes };
+}
+function cloneProject(project) {
+    return {
+        ...project,
+        metadata: { ...project.metadata },
+        files: project.files.map((file) => ({ ...file })),
+        revision: { ...project.revision },
+    };
+}

package/dist/domains/playerCompute.d.ts

@@ -77,7 +77,7 @@ export declare class PlayerComputeAPI {
     /**
      * Fetch a client artifact and decode its bytes to an ArrayBuffer plus the
      * broker inputs (content hash for side-load verification, per-dispatch fuel
-     * budget). Convenience over {@link artifact} for the live-coding client
+     * budget). Convenience over {@link artifact} for the Crowdy Studio CLIENT
      * deploy loop.
      */
     artifactBytes(variables: PlayerComputeArtifactQueryVariables): Promise<{

package/dist/domains/playerCompute.js

@@ -116,7 +116,7 @@ export class PlayerComputeAPI {
     /**
      * Fetch a client artifact and decode its bytes to an ArrayBuffer plus the
      * broker inputs (content hash for side-load verification, per-dispatch fuel
-     * budget). Convenience over {@link artifact} for the live-coding client
+     * budget). Convenience over {@link artifact} for the Crowdy Studio CLIENT
      * deploy loop.
      */
     async artifactBytes(variables) {