@imgly/codesign-mcp 0.1.1 → 0.1.2

package/dist/test/test/config.test.js

@@ -0,0 +1,91 @@
+import { mkdtempSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { loadConfig, resolveSecret } from '../src/config.js';
+const BASE = { IMGLY_CESDK_LICENSE: 'lic-123' };
+describe('resolveSecret', () => {
+    it('returns the plain env var when no _FILE is set', () => {
+        expect(resolveSecret('X', { X: 'v' })).toBe('v');
+    });
+    it('prefers the _FILE contents (trimmed) over the env var', () => {
+        const dir = mkdtempSync(join(tmpdir(), 'cfg-'));
+        const f = join(dir, 'secret');
+        writeFileSync(f, 'file-value\n');
+        expect(resolveSecret('X', { X: 'env-value', X_FILE: f })).toBe('file-value');
+    });
+    it('returns undefined when neither is set', () => {
+        expect(resolveSecret('X', {})).toBeUndefined();
+    });
+});
+describe('loadConfig', () => {
+    it('applies defaults (header mode, local backend, port 8080)', () => {
+        const cfg = loadConfig(BASE);
+        expect(cfg.cesdkLicense).toBe('lic-123');
+        expect(cfg.auth.mode).toBe('header');
+        expect(cfg.auth.header).toBe('X-Workspace-Id');
+        expect(cfg.workspace.backend).toBe('local');
+        expect(cfg.workspace.dir).toBe('/data');
+        expect(cfg.port).toBe(8080);
+        expect(cfg.maxEngines).toBe(8);
+        expect(cfg.buildId).toBe('dev');
+    });
+    it('reads buildId from IMGLY_BUILD_ID (the deploy-injected git SHA)', () => {
+        expect(loadConfig({ ...BASE, IMGLY_BUILD_ID: 'abc1234' }).buildId).toBe('abc1234');
+    });
+    it('throws when the license is missing', () => {
+        expect(() => loadConfig({})).toThrow(/IMGLY_CESDK_LICENSE/);
+    });
+    it('single mode requires IMGLY_WORKSPACE_ID', () => {
+        expect(() => loadConfig({ ...BASE, IMGLY_WORKSPACE_MODE: 'single' })).toThrow(/IMGLY_WORKSPACE_ID/);
+        const cfg = loadConfig({
+            ...BASE,
+            IMGLY_WORKSPACE_MODE: 'single',
+            IMGLY_WORKSPACE_ID: 'acme'
+        });
+        expect(cfg.auth.fixedWorkspaceId).toBe('acme');
+    });
+    it('s3 backend requires a bucket and reads region/endpoint', () => {
+        expect(() => loadConfig({ ...BASE, IMGLY_WORKSPACE_BACKEND: 's3' })).toThrow(/IMGLY_WORKSPACE_S3_BUCKET/);
+        const cfg = loadConfig({
+            ...BASE,
+            IMGLY_WORKSPACE_BACKEND: 's3',
+            IMGLY_WORKSPACE_S3_BUCKET: 'designs',
+            IMGLY_WORKSPACE_S3_ENDPOINT: 'https://acct.r2.cloudflarestorage.com'
+        });
+        expect(cfg.workspace.backend).toBe('s3');
+        expect(cfg.workspace.s3?.bucket).toBe('designs');
+        expect(cfg.workspace.s3?.region).toBe('auto');
+        expect(cfg.workspace.s3?.endpoint).toBe('https://acct.r2.cloudflarestorage.com');
+    });
+    it('rejects an unknown mode', () => {
+        expect(() => loadConfig({ ...BASE, IMGLY_WORKSPACE_MODE: 'bogus' })).toThrow(/IMGLY_WORKSPACE_MODE/);
+    });
+    it('leaves the gateway disabled when no key is set', () => {
+        expect(loadConfig(BASE).gateway.apiKey).toBeUndefined();
+    });
+    it('metricsEnabled defaults to false when unset', () => {
+        expect(loadConfig(BASE).metricsEnabled).toBe(false);
+    });
+    it('metricsEnabled is true for "true" or "1"', () => {
+        expect(loadConfig({ ...BASE, IMGLY_METRICS_ENABLED: 'true' }).metricsEnabled).toBe(true);
+        expect(loadConfig({ ...BASE, IMGLY_METRICS_ENABLED: '1' }).metricsEnabled).toBe(true);
+    });
+    it('metricsEnabled is false for any other explicit value', () => {
+        expect(loadConfig({ ...BASE, IMGLY_METRICS_ENABLED: 'false' }).metricsEnabled).toBe(false);
+        expect(loadConfig({ ...BASE, IMGLY_METRICS_ENABLED: 'yes' }).metricsEnabled).toBe(false);
+    });
+});
+describe('IMGLY_PUBLIC_BASE_URL', () => {
+    it('is absent by default', () => {
+        expect(loadConfig(BASE).publicBaseUrl).toBeUndefined();
+    });
+    it('is loaded with trailing slashes stripped', () => {
+        const cfg = loadConfig({
+            ...BASE,
+            IMGLY_PUBLIC_BASE_URL: 'https://codesign.example.com/'
+        });
+        expect(cfg.publicBaseUrl).toBe('https://codesign.example.com');
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/test/test/config.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.js","sourceRoot":"","sources":["../../../test/config.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdtempSync, writeFileSync } from 'node:fs';\nimport { tmpdir } from 'node:os';\nimport { join } from 'node:path';\nimport { describe, expect, it } from 'vitest';\nimport { loadConfig, resolveSecret } from '../src/config.js';\n\nconst BASE = { IMGLY_CESDK_LICENSE: 'lic-123' };\n\ndescribe('resolveSecret', () => {\n  it('returns the plain env var when no _FILE is set', () => {\n    expect(resolveSecret('X', { X: 'v' })).toBe('v');\n  });\n\n  it('prefers the _FILE contents (trimmed) over the env var', () => {\n    const dir = mkdtempSync(join(tmpdir(), 'cfg-'));\n    const f = join(dir, 'secret');\n    writeFileSync(f, 'file-value\\n');\n    expect(resolveSecret('X', { X: 'env-value', X_FILE: f })).toBe(\n      'file-value'\n    );\n  });\n\n  it('returns undefined when neither is set', () => {\n    expect(resolveSecret('X', {})).toBeUndefined();\n  });\n});\n\ndescribe('loadConfig', () => {\n  it('applies defaults (header mode, local backend, port 8080)', () => {\n    const cfg = loadConfig(BASE);\n    expect(cfg.cesdkLicense).toBe('lic-123');\n    expect(cfg.auth.mode).toBe('header');\n    expect(cfg.auth.header).toBe('X-Workspace-Id');\n    expect(cfg.workspace.backend).toBe('local');\n    expect(cfg.workspace.dir).toBe('/data');\n    expect(cfg.port).toBe(8080);\n    expect(cfg.maxEngines).toBe(8);\n    expect(cfg.buildId).toBe('dev');\n  });\n\n  it('reads buildId from IMGLY_BUILD_ID (the deploy-injected git SHA)', () => {\n    expect(loadConfig({ ...BASE, IMGLY_BUILD_ID: 'abc1234' }).buildId).toBe(\n      'abc1234'\n    );\n  });\n\n  it('throws when the license is missing', () => {\n    expect(() => loadConfig({})).toThrow(/IMGLY_CESDK_LICENSE/);\n  });\n\n  it('single mode requires IMGLY_WORKSPACE_ID', () => {\n    expect(() =>\n      loadConfig({ ...BASE, IMGLY_WORKSPACE_MODE: 'single' })\n    ).toThrow(/IMGLY_WORKSPACE_ID/);\n    const cfg = loadConfig({\n      ...BASE,\n      IMGLY_WORKSPACE_MODE: 'single',\n      IMGLY_WORKSPACE_ID: 'acme'\n    });\n    expect(cfg.auth.fixedWorkspaceId).toBe('acme');\n  });\n\n  it('s3 backend requires a bucket and reads region/endpoint', () => {\n    expect(() =>\n      loadConfig({ ...BASE, IMGLY_WORKSPACE_BACKEND: 's3' })\n    ).toThrow(/IMGLY_WORKSPACE_S3_BUCKET/);\n    const cfg = loadConfig({\n      ...BASE,\n      IMGLY_WORKSPACE_BACKEND: 's3',\n      IMGLY_WORKSPACE_S3_BUCKET: 'designs',\n      IMGLY_WORKSPACE_S3_ENDPOINT: 'https://acct.r2.cloudflarestorage.com'\n    });\n    expect(cfg.workspace.backend).toBe('s3');\n    expect(cfg.workspace.s3?.bucket).toBe('designs');\n    expect(cfg.workspace.s3?.region).toBe('auto');\n    expect(cfg.workspace.s3?.endpoint).toBe(\n      'https://acct.r2.cloudflarestorage.com'\n    );\n  });\n\n  it('rejects an unknown mode', () => {\n    expect(() =>\n      loadConfig({ ...BASE, IMGLY_WORKSPACE_MODE: 'bogus' })\n    ).toThrow(/IMGLY_WORKSPACE_MODE/);\n  });\n\n  it('leaves the gateway disabled when no key is set', () => {\n    expect(loadConfig(BASE).gateway.apiKey).toBeUndefined();\n  });\n\n  it('metricsEnabled defaults to false when unset', () => {\n    expect(loadConfig(BASE).metricsEnabled).toBe(false);\n  });\n\n  it('metricsEnabled is true for \"true\" or \"1\"', () => {\n    expect(\n      loadConfig({ ...BASE, IMGLY_METRICS_ENABLED: 'true' }).metricsEnabled\n    ).toBe(true);\n    expect(\n      loadConfig({ ...BASE, IMGLY_METRICS_ENABLED: '1' }).metricsEnabled\n    ).toBe(true);\n  });\n\n  it('metricsEnabled is false for any other explicit value', () => {\n    expect(\n      loadConfig({ ...BASE, IMGLY_METRICS_ENABLED: 'false' }).metricsEnabled\n    ).toBe(false);\n    expect(\n      loadConfig({ ...BASE, IMGLY_METRICS_ENABLED: 'yes' }).metricsEnabled\n    ).toBe(false);\n  });\n});\n\ndescribe('IMGLY_PUBLIC_BASE_URL', () => {\n  it('is absent by default', () => {\n    expect(loadConfig(BASE).publicBaseUrl).toBeUndefined();\n  });\n\n  it('is loaded with trailing slashes stripped', () => {\n    const cfg = loadConfig({\n      ...BASE,\n      IMGLY_PUBLIC_BASE_URL: 'https://codesign.example.com/'\n    });\n    expect(cfg.publicBaseUrl).toBe('https://codesign.example.com');\n  });\n});\n"]}

package/dist/test/test/engine/asset-sources.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=asset-sources.test.d.ts.map

package/dist/test/test/engine/asset-sources.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-sources.test.d.ts","sourceRoot":"","sources":["../../../../test/engine/asset-sources.test.ts"],"names":[],"mappings":""}

package/dist/test/test/engine/asset-sources.test.js

@@ -0,0 +1,100 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { ensureEngineAssetSources, resetEngineAssetSourcesForTest } from '../../src/engine/asset-sources.js';
+function makeEngine(existingSources) {
+    return {
+        asset: { findAllSources: vi.fn(() => existingSources) },
+        addDefaultAssetSources: vi.fn(async () => { }),
+        addDemoAssetSources: vi.fn(async () => { })
+    };
+}
+describe('ensureEngineAssetSources', () => {
+    beforeEach(() => {
+        resetEngineAssetSourcesForTest();
+    });
+    it('registers default + demo sources on a fresh engine', async () => {
+        const engine = makeEngine([]);
+        await ensureEngineAssetSources(engine);
+        expect(engine.addDefaultAssetSources).toHaveBeenCalledOnce();
+        expect(engine.addDefaultAssetSources).toHaveBeenCalledWith({
+            baseURL: 'https://cdn.img.ly/assets/v3',
+            excludeAssetSourceIds: ['ly.img.text']
+        });
+        expect(engine.addDemoAssetSources).toHaveBeenCalledOnce();
+        expect(engine.addDemoAssetSources).toHaveBeenCalledWith({
+            baseURL: 'https://cdn.img.ly/assets/demo/v3'
+        });
+    });
+    it('honours self-hosted manifest roots from the environment', async () => {
+        vi.stubEnv('IMGLY_DEFAULT_ASSETS_BASE_URL', 'https://assets.example.com/v3');
+        vi.stubEnv('IMGLY_DEMO_ASSETS_BASE_URL', 'https://assets.example.com/demo/v3');
+        try {
+            const engine = makeEngine([]);
+            await ensureEngineAssetSources(engine);
+            expect(engine.addDefaultAssetSources).toHaveBeenCalledWith({
+                baseURL: 'https://assets.example.com/v3',
+                excludeAssetSourceIds: ['ly.img.text']
+            });
+            expect(engine.addDemoAssetSources).toHaveBeenCalledWith({
+                baseURL: 'https://assets.example.com/demo/v3'
+            });
+        }
+        finally {
+            vi.unstubAllEnvs();
+        }
+    });
+    it('skips registration when the demo image source is already present', async () => {
+        const engine = makeEngine(['ly.img.image']);
+        await ensureEngineAssetSources(engine);
+        expect(engine.addDefaultAssetSources).not.toHaveBeenCalled();
+        expect(engine.addDemoAssetSources).not.toHaveBeenCalled();
+    });
+    it('swallows CDN failures (best-effort) without throwing', async () => {
+        const stderrSpy = vi
+            .spyOn(process.stderr, 'write')
+            .mockImplementation(() => true);
+        const engine = makeEngine([]);
+        engine.addDefaultAssetSources.mockRejectedValueOnce(new Error('offline'));
+        await expect(ensureEngineAssetSources(engine)).resolves.toBeUndefined();
+        expect(stderrSpy.mock.calls[0][0]).toContain('asset_search will see fewer sources');
+        stderrSpy.mockRestore();
+    });
+    it('concurrent calls share one in-flight registration', async () => {
+        const engine = makeEngine([]);
+        const p1 = ensureEngineAssetSources(engine);
+        const p2 = ensureEngineAssetSources(engine);
+        await Promise.all([p1, p2]);
+        expect(engine.addDefaultAssetSources).toHaveBeenCalledOnce();
+    });
+    it('total failure (sentinel absent) clears the guard so the next call retries', async () => {
+        const stderrSpy = vi
+            .spyOn(process.stderr, 'write')
+            .mockImplementation(() => true);
+        const engine = makeEngine([]);
+        engine.addDefaultAssetSources.mockRejectedValueOnce(new Error('offline'));
+        await ensureEngineAssetSources(engine);
+        await ensureEngineAssetSources(engine);
+        expect(engine.addDefaultAssetSources).toHaveBeenCalledTimes(2);
+        stderrSpy.mockRestore();
+    });
+    it('keeps the guard when demo sources land despite default-source failure', async () => {
+        const stderrSpy = vi
+            .spyOn(process.stderr, 'write')
+            .mockImplementation(() => true);
+        const sources = [];
+        const engine = {
+            asset: { findAllSources: vi.fn(() => [...sources]) },
+            addDefaultAssetSources: vi.fn(async () => {
+                throw new Error('ENOENT');
+            }),
+            addDemoAssetSources: vi.fn(async () => {
+                sources.push('ly.img.image');
+            })
+        };
+        await ensureEngineAssetSources(engine);
+        await ensureEngineAssetSources(engine);
+        expect(engine.addDefaultAssetSources).toHaveBeenCalledOnce();
+        expect(engine.addDemoAssetSources).toHaveBeenCalledOnce();
+        stderrSpy.mockRestore();
+    });
+});
+//# sourceMappingURL=asset-sources.test.js.map

package/dist/test/test/engine/asset-sources.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-sources.test.js","sourceRoot":"","sources":["../../../../test/engine/asset-sources.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC/B,MAAM,mCAAmC,CAAC;AAE3C,SAAS,UAAU,CAAC,eAAyB;IAC3C,OAAO;QACL,KAAK,EAAE,EAAE,cAAc,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,EAAE;QACvD,sBAAsB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;QAC7C,mBAAmB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,UAAU,CAAC,GAAG,EAAE;QACd,8BAA8B,EAAE,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,wBAAwB,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,oBAAoB,EAAE,CAAC;QAC7D,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,oBAAoB,CAAC;YACzD,OAAO,EAAE,8BAA8B;YACvC,qBAAqB,EAAE,CAAC,aAAa,CAAC;SACvC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,oBAAoB,EAAE,CAAC;QAC1D,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,oBAAoB,CAAC;YACtD,OAAO,EAAE,mCAAmC;SAC7C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,EAAE,CAAC,OAAO,CACR,+BAA+B,EAC/B,+BAA+B,CAChC,CAAC;QACF,EAAE,CAAC,OAAO,CACR,4BAA4B,EAC5B,oCAAoC,CACrC,CAAC;QACF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;YAC9B,MAAM,wBAAwB,CAAC,MAAM,CAAC,CAAC;YACvC,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,oBAAoB,CAAC;gBACzD,OAAO,EAAE,+BAA+B;gBACxC,qBAAqB,EAAE,CAAC,aAAa,CAAC;aACvC,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,oBAAoB,CAAC;gBACtD,OAAO,EAAE,oCAAoC;aAC9C,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,aAAa,EAAE,CAAC;QACrB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;QAC5C,MAAM,wBAAwB,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAC7D,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,SAAS,GAAG,EAAE;aACjB,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;aAC9B,kBAAkB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,CAAC,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAC1E,MAAM,MAAM,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QACxE,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAC1C,qCAAqC,CACtC,CAAC;QACF,SAAS,CAAC,WAAW,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,EAAE,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,EAAE,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,oBAAoB,EAAE,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;QACzF,MAAM,SAAS,GAAG,EAAE;aACjB,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;aAC9B,kBAAkB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,CAAC,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAC1E,MAAM,wBAAwB,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,wBAAwB,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC/D,SAAS,CAAC,WAAW,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACrF,MAAM,SAAS,GAAG,EAAE;aACjB,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;aAC9B,kBAAkB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG;YACb,KAAK,EAAE,EAAE,cAAc,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE;YACpD,sBAAsB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE;gBACvC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC,CAAC;YACF,mBAAmB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE;gBACpC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC/B,CAAC,CAAC;SACH,CAAC;QACF,MAAM,wBAAwB,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,wBAAwB,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,oBAAoB,EAAE,CAAC;QAC7D,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,oBAAoB,EAAE,CAAC;QAC1D,SAAS,CAAC,WAAW,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { beforeEach, describe, expect, it, vi } from 'vitest';\nimport {\n  ensureEngineAssetSources,\n  resetEngineAssetSourcesForTest\n} from '../../src/engine/asset-sources.js';\n\nfunction makeEngine(existingSources: string[]) {\n  return {\n    asset: { findAllSources: vi.fn(() => existingSources) },\n    addDefaultAssetSources: vi.fn(async () => {}),\n    addDemoAssetSources: vi.fn(async () => {})\n  };\n}\n\ndescribe('ensureEngineAssetSources', () => {\n  beforeEach(() => {\n    resetEngineAssetSourcesForTest();\n  });\n\n  it('registers default + demo sources on a fresh engine', async () => {\n    const engine = makeEngine([]);\n    await ensureEngineAssetSources(engine);\n    expect(engine.addDefaultAssetSources).toHaveBeenCalledOnce();\n    expect(engine.addDefaultAssetSources).toHaveBeenCalledWith({\n      baseURL: 'https://cdn.img.ly/assets/v3',\n      excludeAssetSourceIds: ['ly.img.text']\n    });\n    expect(engine.addDemoAssetSources).toHaveBeenCalledOnce();\n    expect(engine.addDemoAssetSources).toHaveBeenCalledWith({\n      baseURL: 'https://cdn.img.ly/assets/demo/v3'\n    });\n  });\n\n  it('honours self-hosted manifest roots from the environment', async () => {\n    vi.stubEnv(\n      'IMGLY_DEFAULT_ASSETS_BASE_URL',\n      'https://assets.example.com/v3'\n    );\n    vi.stubEnv(\n      'IMGLY_DEMO_ASSETS_BASE_URL',\n      'https://assets.example.com/demo/v3'\n    );\n    try {\n      const engine = makeEngine([]);\n      await ensureEngineAssetSources(engine);\n      expect(engine.addDefaultAssetSources).toHaveBeenCalledWith({\n        baseURL: 'https://assets.example.com/v3',\n        excludeAssetSourceIds: ['ly.img.text']\n      });\n      expect(engine.addDemoAssetSources).toHaveBeenCalledWith({\n        baseURL: 'https://assets.example.com/demo/v3'\n      });\n    } finally {\n      vi.unstubAllEnvs();\n    }\n  });\n\n  it('skips registration when the demo image source is already present', async () => {\n    const engine = makeEngine(['ly.img.image']);\n    await ensureEngineAssetSources(engine);\n    expect(engine.addDefaultAssetSources).not.toHaveBeenCalled();\n    expect(engine.addDemoAssetSources).not.toHaveBeenCalled();\n  });\n\n  it('swallows CDN failures (best-effort) without throwing', async () => {\n    const stderrSpy = vi\n      .spyOn(process.stderr, 'write')\n      .mockImplementation(() => true);\n    const engine = makeEngine([]);\n    engine.addDefaultAssetSources.mockRejectedValueOnce(new Error('offline'));\n    await expect(ensureEngineAssetSources(engine)).resolves.toBeUndefined();\n    expect(stderrSpy.mock.calls[0][0]).toContain(\n      'asset_search will see fewer sources'\n    );\n    stderrSpy.mockRestore();\n  });\n\n  it('concurrent calls share one in-flight registration', async () => {\n    const engine = makeEngine([]);\n    const p1 = ensureEngineAssetSources(engine);\n    const p2 = ensureEngineAssetSources(engine);\n    await Promise.all([p1, p2]);\n    expect(engine.addDefaultAssetSources).toHaveBeenCalledOnce();\n  });\n\n  it('total failure (sentinel absent) clears the guard so the next call retries', async () => {\n    const stderrSpy = vi\n      .spyOn(process.stderr, 'write')\n      .mockImplementation(() => true);\n    const engine = makeEngine([]);\n    engine.addDefaultAssetSources.mockRejectedValueOnce(new Error('offline'));\n    await ensureEngineAssetSources(engine);\n    await ensureEngineAssetSources(engine);\n    expect(engine.addDefaultAssetSources).toHaveBeenCalledTimes(2);\n    stderrSpy.mockRestore();\n  });\n\n  it('keeps the guard when demo sources land despite default-source failure', async () => {\n    const stderrSpy = vi\n      .spyOn(process.stderr, 'write')\n      .mockImplementation(() => true);\n    const sources: string[] = [];\n    const engine = {\n      asset: { findAllSources: vi.fn(() => [...sources]) },\n      addDefaultAssetSources: vi.fn(async () => {\n        throw new Error('ENOENT');\n      }),\n      addDemoAssetSources: vi.fn(async () => {\n        sources.push('ly.img.image');\n      })\n    };\n    await ensureEngineAssetSources(engine);\n    await ensureEngineAssetSources(engine);\n    expect(engine.addDefaultAssetSources).toHaveBeenCalledOnce();\n    expect(engine.addDemoAssetSources).toHaveBeenCalledOnce();\n    stderrSpy.mockRestore();\n  });\n});\n"]}

package/dist/test/test/engine/mutex.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mutex.test.d.ts.map

package/dist/test/test/engine/mutex.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.test.d.ts","sourceRoot":"","sources":["../../../../test/engine/mutex.test.ts"],"names":[],"mappings":""}

package/dist/test/test/engine/mutex.test.js

@@ -0,0 +1,63 @@
+import { describe, expect, it } from 'vitest';
+import { Mutex } from '../../src/engine/mutex.js';
+const tick = (ms = 0) => new Promise((resolve) => setTimeout(resolve, ms));
+describe('Mutex', () => {
+    it('runs sections one at a time — never two in their critical region at once', async () => {
+        const mutex = new Mutex();
+        let active = 0;
+        let maxActive = 0;
+        const section = async () => {
+            active++;
+            maxActive = Math.max(maxActive, active);
+            await tick(5); // hold the section open across an await
+            active--;
+        };
+        await Promise.all([
+            mutex.runExclusive(section),
+            mutex.runExclusive(section),
+            mutex.runExclusive(section),
+            mutex.runExclusive(section)
+        ]);
+        expect(maxActive).toBe(1);
+        expect(active).toBe(0);
+    });
+    it('preserves FIFO order', async () => {
+        const mutex = new Mutex();
+        const order = [];
+        await Promise.all([0, 1, 2, 3].map((i) => mutex.runExclusive(async () => {
+            await tick(1);
+            order.push(i);
+        })));
+        expect(order).toEqual([0, 1, 2, 3]);
+    });
+    it('returns the section result to its caller', async () => {
+        const mutex = new Mutex();
+        await expect(mutex.runExclusive(async () => 42)).resolves.toBe(42);
+    });
+    it('a throwing section rejects its caller but does not wedge the queue', async () => {
+        const mutex = new Mutex();
+        const boom = mutex.runExclusive(async () => {
+            throw new Error('boom');
+        });
+        await expect(boom).rejects.toThrow('boom');
+        // The next section must still run after a rejection.
+        await expect(mutex.runExclusive(async () => 'ok')).resolves.toBe('ok');
+    });
+    it('stays mutually exclusive under heavy interleaving (multiple yields per section)', async () => {
+        const mutex = new Mutex();
+        let active = 0;
+        let maxActive = 0;
+        const section = async () => {
+            active++;
+            maxActive = Math.max(maxActive, active);
+            await tick(0);
+            await Promise.resolve();
+            await tick(0);
+            active--;
+        };
+        await Promise.all(Array.from({ length: 12 }, () => mutex.runExclusive(section)));
+        expect(maxActive).toBe(1);
+        expect(active).toBe(0);
+    });
+});
+//# sourceMappingURL=mutex.test.js.map

package/dist/test/test/engine/mutex.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.test.js","sourceRoot":"","sources":["../../../../test/engine/mutex.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from 'vitest';\nimport { Mutex } from '../../src/engine/mutex.js';\n\nconst tick = (ms = 0): Promise<void> =>\n  new Promise((resolve) => setTimeout(resolve, ms));\n\ndescribe('Mutex', () => {\n  it('runs sections one at a time — never two in their critical region at once', async () => {\n    const mutex = new Mutex();\n    let active = 0;\n    let maxActive = 0;\n    const section = async () => {\n      active++;\n      maxActive = Math.max(maxActive, active);\n      await tick(5); // hold the section open across an await\n      active--;\n    };\n    await Promise.all([\n      mutex.runExclusive(section),\n      mutex.runExclusive(section),\n      mutex.runExclusive(section),\n      mutex.runExclusive(section)\n    ]);\n    expect(maxActive).toBe(1);\n    expect(active).toBe(0);\n  });\n\n  it('preserves FIFO order', async () => {\n    const mutex = new Mutex();\n    const order: number[] = [];\n    await Promise.all(\n      [0, 1, 2, 3].map((i) =>\n        mutex.runExclusive(async () => {\n          await tick(1);\n          order.push(i);\n        })\n      )\n    );\n    expect(order).toEqual([0, 1, 2, 3]);\n  });\n\n  it('returns the section result to its caller', async () => {\n    const mutex = new Mutex();\n    await expect(mutex.runExclusive(async () => 42)).resolves.toBe(42);\n  });\n\n  it('a throwing section rejects its caller but does not wedge the queue', async () => {\n    const mutex = new Mutex();\n    const boom = mutex.runExclusive(async () => {\n      throw new Error('boom');\n    });\n    await expect(boom).rejects.toThrow('boom');\n    // The next section must still run after a rejection.\n    await expect(mutex.runExclusive(async () => 'ok')).resolves.toBe('ok');\n  });\n\n  it('stays mutually exclusive under heavy interleaving (multiple yields per section)', async () => {\n    const mutex = new Mutex();\n    let active = 0;\n    let maxActive = 0;\n    const section = async () => {\n      active++;\n      maxActive = Math.max(maxActive, active);\n      await tick(0);\n      await Promise.resolve();\n      await tick(0);\n      active--;\n    };\n    await Promise.all(\n      Array.from({ length: 12 }, () => mutex.runExclusive(section))\n    );\n    expect(maxActive).toBe(1);\n    expect(active).toBe(0);\n  });\n});\n"]}

package/dist/test/test/engine/session.test.js

@@ -61,6 +61,21 @@ describe('EngineSession (single slot)', () => {
         expect(slot2.currentRevision).toBe('rev_abc');
     });
 });
+describe('EngineSession cold-instance reconstruction (spec §8.6)', () => {
+    it('reconstructs a cold engine by loading a staged revision scene', async () => {
+        // Regression guard: a cold session (no warm slot) must load the staged
+        // scene via loadFromString before returning the slot. This documents the
+        // edit-tool contract: populate(parent, scene) → acquire(parent) always
+        // calls loadFromString, never assumes a warm engine.
+        const { adapter } = makeFakeEngine();
+        const session = new EngineSession({ size: 1, adapter });
+        // Cold: no slots exist yet, so no warm engine.
+        await session.populate('rev-1', '<scene-for-rev-1/>');
+        const slot = await session.acquire('rev-1');
+        expect(adapter.loadFromString).toHaveBeenCalledWith(slot.engine, '<scene-for-rev-1/>');
+        expect(slot.currentRevision).toBe('rev-1');
+    });
+});
 describe('EngineSession (multi-slot sticky routing)', () => {
     function makeAdapterWithCounter() {
         let id = 0;

package/dist/test/test/engine/session.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.test.js","sourceRoot":"","sources":["../../../../test/engine/session.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it, vi } from 'vitest';\nimport { type EngineAdapter, EngineSession } from '../../src/engine/session.js';\n\nfunction makeFakeEngine(scene = 'INITIAL'): {\n  engine: { _scene: string };\n  adapter: EngineAdapter;\n} {\n  const engine = { _scene: scene };\n  const adapter: EngineAdapter = {\n    create: () => engine,\n    reset: vi.fn(async () => {\n      engine._scene = 'RESET';\n    }),\n    loadFromString: vi.fn(async (eng, s) => {\n      (eng as typeof engine)._scene = s;\n    }),\n    saveToString: vi.fn(async (eng) => (eng as typeof engine)._scene)\n  };\n  return { engine, adapter };\n}\n\ndescribe('EngineSession (single slot)', () => {\n  it('acquire(parent=null) resets the engine and sets currentRevision=null', async () => {\n    const { adapter } = makeFakeEngine();\n    const session = new EngineSession({ size: 1, adapter });\n    const slot = await session.acquire(null);\n    expect(adapter.reset).toHaveBeenCalledOnce();\n    expect(slot.currentRevision).toBeNull();\n  });\n\n  it('acquire(parent=X) loads scene X when slot currentRevision is different', async () => {\n    const { adapter } = makeFakeEngine();\n    const session = new EngineSession({ size: 1, adapter });\n    await session.populate('rev_abc', 'SCENE_ABC'); // pre-stage the loadable scene\n    const slot = await session.acquire('rev_abc');\n    expect(adapter.loadFromString).toHaveBeenCalledWith(\n      slot.engine,\n      'SCENE_ABC'\n    );\n    expect(slot.currentRevision).toBe('rev_abc');\n  });\n\n  it('acquire(parent=X) is a no-op when slot.currentRevision === X (linear edit)', async () => {\n    const { adapter } = makeFakeEngine();\n    const session = new EngineSession({ size: 1, adapter });\n    await session.populate('rev_abc', 'SCENE_ABC');\n    await session.acquire('rev_abc');\n    (adapter.loadFromString as ReturnType<typeof vi.fn>).mockClear();\n    const slot2 = await session.acquire('rev_abc');\n    expect(adapter.loadFromString).not.toHaveBeenCalled();\n    expect(slot2.currentRevision).toBe('rev_abc');\n  });\n\n  it('commit(slot, newRev) updates currentRevision (linear edit succeeded)', async () => {\n    const { adapter } = makeFakeEngine();\n    const session = new EngineSession({ size: 1, adapter });\n    const slot = await session.acquire(null);\n    session.commit(slot, 'rev_new');\n    expect(slot.currentRevision).toBe('rev_new');\n  });\n\n  it('markDirty(slot) sets currentRevision=null (failed edit forces reload next time)', async () => {\n    const { adapter } = makeFakeEngine();\n    const session = new EngineSession({ size: 1, adapter });\n    await session.populate('rev_abc', 'SCENE_ABC');\n    const slot = await session.acquire('rev_abc');\n    session.markDirty(slot);\n    expect(slot.currentRevision).toBeNull();\n    // next acquire even of the SAME parent must reload\n    await session.populate('rev_abc', 'SCENE_ABC');\n    const slot2 = await session.acquire('rev_abc');\n    expect(adapter.loadFromString).toHaveBeenCalledTimes(2);\n    expect(slot2.currentRevision).toBe('rev_abc');\n  });\n});\n\ndescribe('EngineSession (multi-slot sticky routing)', () => {\n  function makeAdapterWithCounter(): {\n    adapter: EngineAdapter;\n    createCount: () => number;\n  } {\n    let id = 0;\n    const counters = { creates: 0 };\n    const adapter: EngineAdapter = {\n      create: () => {\n        counters.creates++;\n        return { _id: id++, _scene: 'INITIAL' };\n      },\n      reset: async (eng) => {\n        (eng as { _scene: string })._scene = 'RESET';\n      },\n      loadFromString: async (eng, s) => {\n        (eng as { _scene: string })._scene = s;\n      },\n      saveToString: async (eng) => (eng as { _scene: string })._scene\n    };\n    return { adapter, createCount: () => counters.creates };\n  }\n\n  it('returns warm slot whose currentRevision matches the requested parent', async () => {\n    const { adapter, createCount } = makeAdapterWithCounter();\n    const session = new EngineSession({ size: 2, adapter });\n    await session.populate('rev_A', 'SCENE_A');\n    const slotA = await session.acquire('rev_A');\n    session.commit(slotA, 'rev_A2');\n    await session.populate('rev_B', 'SCENE_B');\n    const slotB = await session.acquire('rev_B');\n    session.commit(slotB, 'rev_B2');\n\n    expect(createCount()).toBe(2);\n    // Sticky: re-acquire rev_A2 → reuse slotA, no new create, no reload.\n    const reuse = await session.acquire('rev_A2');\n    expect(reuse.engine).toBe(slotA.engine);\n    expect(createCount()).toBe(2);\n  });\n\n  it('evicts a dirty slot before a warm slot when over cap', async () => {\n    const { adapter } = makeAdapterWithCounter();\n    const session = new EngineSession({ size: 1, adapter });\n    const slot1 = await session.acquire(null);\n    session.commit(slot1, 'rev_X');\n    session.markDirty(slot1);\n    await session.populate('rev_Y', 'SCENE_Y');\n    const slot2 = await session.acquire('rev_Y');\n    expect(slot2).toBe(slot1); // reused\n    expect(slot2.currentRevision).toBe('rev_Y');\n  });\n});\n\ndescribe('EngineSession.currentSlot', () => {\n  it('returns undefined when no slot is warm', () => {\n    const { adapter } = (function makeFakeEngine() {\n      const engine = { _scene: 'INITIAL' };\n      const adapter: EngineAdapter = {\n        create: () => engine,\n        reset: vi.fn(async () => {\n          engine._scene = 'RESET';\n        }),\n        loadFromString: vi.fn(async () => {}),\n        saveToString: vi.fn(async () => engine._scene)\n      };\n      return { adapter };\n    })();\n    const session = new EngineSession({ size: 1, adapter });\n    expect(session.currentSlot()).toBeUndefined();\n  });\n\n  it('returns the slot once it has been committed to a revision', async () => {\n    const engine = { _scene: 'INITIAL' };\n    const adapter: EngineAdapter = {\n      create: () => engine,\n      reset: vi.fn(async () => {\n        engine._scene = 'RESET';\n      }),\n      loadFromString: vi.fn(async () => {}),\n      saveToString: vi.fn(async () => engine._scene)\n    };\n    const session = new EngineSession({ size: 1, adapter });\n    const slot = await session.acquire(null);\n    expect(session.currentSlot()).toBeUndefined(); // currentRevision is null after acquire(null)\n    session.commit(slot, 'rev_X');\n    expect(session.currentSlot()).toBe(slot);\n  });\n});\n"]}
+{"version":3,"file":"session.test.js","sourceRoot":"","sources":["../../../../test/engine/session.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it, vi } from 'vitest';\nimport { type EngineAdapter, EngineSession } from '../../src/engine/session.js';\n\nfunction makeFakeEngine(scene = 'INITIAL'): {\n  engine: { _scene: string };\n  adapter: EngineAdapter;\n} {\n  const engine = { _scene: scene };\n  const adapter: EngineAdapter = {\n    create: () => engine,\n    reset: vi.fn(async () => {\n      engine._scene = 'RESET';\n    }),\n    loadFromString: vi.fn(async (eng, s) => {\n      (eng as typeof engine)._scene = s;\n    }),\n    saveToString: vi.fn(async (eng) => (eng as typeof engine)._scene)\n  };\n  return { engine, adapter };\n}\n\ndescribe('EngineSession (single slot)', () => {\n  it('acquire(parent=null) resets the engine and sets currentRevision=null', async () => {\n    const { adapter } = makeFakeEngine();\n    const session = new EngineSession({ size: 1, adapter });\n    const slot = await session.acquire(null);\n    expect(adapter.reset).toHaveBeenCalledOnce();\n    expect(slot.currentRevision).toBeNull();\n  });\n\n  it('acquire(parent=X) loads scene X when slot currentRevision is different', async () => {\n    const { adapter } = makeFakeEngine();\n    const session = new EngineSession({ size: 1, adapter });\n    await session.populate('rev_abc', 'SCENE_ABC'); // pre-stage the loadable scene\n    const slot = await session.acquire('rev_abc');\n    expect(adapter.loadFromString).toHaveBeenCalledWith(\n      slot.engine,\n      'SCENE_ABC'\n    );\n    expect(slot.currentRevision).toBe('rev_abc');\n  });\n\n  it('acquire(parent=X) is a no-op when slot.currentRevision === X (linear edit)', async () => {\n    const { adapter } = makeFakeEngine();\n    const session = new EngineSession({ size: 1, adapter });\n    await session.populate('rev_abc', 'SCENE_ABC');\n    await session.acquire('rev_abc');\n    (adapter.loadFromString as ReturnType<typeof vi.fn>).mockClear();\n    const slot2 = await session.acquire('rev_abc');\n    expect(adapter.loadFromString).not.toHaveBeenCalled();\n    expect(slot2.currentRevision).toBe('rev_abc');\n  });\n\n  it('commit(slot, newRev) updates currentRevision (linear edit succeeded)', async () => {\n    const { adapter } = makeFakeEngine();\n    const session = new EngineSession({ size: 1, adapter });\n    const slot = await session.acquire(null);\n    session.commit(slot, 'rev_new');\n    expect(slot.currentRevision).toBe('rev_new');\n  });\n\n  it('markDirty(slot) sets currentRevision=null (failed edit forces reload next time)', async () => {\n    const { adapter } = makeFakeEngine();\n    const session = new EngineSession({ size: 1, adapter });\n    await session.populate('rev_abc', 'SCENE_ABC');\n    const slot = await session.acquire('rev_abc');\n    session.markDirty(slot);\n    expect(slot.currentRevision).toBeNull();\n    // next acquire even of the SAME parent must reload\n    await session.populate('rev_abc', 'SCENE_ABC');\n    const slot2 = await session.acquire('rev_abc');\n    expect(adapter.loadFromString).toHaveBeenCalledTimes(2);\n    expect(slot2.currentRevision).toBe('rev_abc');\n  });\n});\n\ndescribe('EngineSession cold-instance reconstruction (spec §8.6)', () => {\n  it('reconstructs a cold engine by loading a staged revision scene', async () => {\n    // Regression guard: a cold session (no warm slot) must load the staged\n    // scene via loadFromString before returning the slot. This documents the\n    // edit-tool contract: populate(parent, scene) → acquire(parent) always\n    // calls loadFromString, never assumes a warm engine.\n    const { adapter } = makeFakeEngine();\n    const session = new EngineSession({ size: 1, adapter });\n    // Cold: no slots exist yet, so no warm engine.\n    await session.populate('rev-1', '<scene-for-rev-1/>');\n    const slot = await session.acquire('rev-1');\n    expect(adapter.loadFromString).toHaveBeenCalledWith(\n      slot.engine,\n      '<scene-for-rev-1/>'\n    );\n    expect(slot.currentRevision).toBe('rev-1');\n  });\n});\n\ndescribe('EngineSession (multi-slot sticky routing)', () => {\n  function makeAdapterWithCounter(): {\n    adapter: EngineAdapter;\n    createCount: () => number;\n  } {\n    let id = 0;\n    const counters = { creates: 0 };\n    const adapter: EngineAdapter = {\n      create: () => {\n        counters.creates++;\n        return { _id: id++, _scene: 'INITIAL' };\n      },\n      reset: async (eng) => {\n        (eng as { _scene: string })._scene = 'RESET';\n      },\n      loadFromString: async (eng, s) => {\n        (eng as { _scene: string })._scene = s;\n      },\n      saveToString: async (eng) => (eng as { _scene: string })._scene\n    };\n    return { adapter, createCount: () => counters.creates };\n  }\n\n  it('returns warm slot whose currentRevision matches the requested parent', async () => {\n    const { adapter, createCount } = makeAdapterWithCounter();\n    const session = new EngineSession({ size: 2, adapter });\n    await session.populate('rev_A', 'SCENE_A');\n    const slotA = await session.acquire('rev_A');\n    session.commit(slotA, 'rev_A2');\n    await session.populate('rev_B', 'SCENE_B');\n    const slotB = await session.acquire('rev_B');\n    session.commit(slotB, 'rev_B2');\n\n    expect(createCount()).toBe(2);\n    // Sticky: re-acquire rev_A2 → reuse slotA, no new create, no reload.\n    const reuse = await session.acquire('rev_A2');\n    expect(reuse.engine).toBe(slotA.engine);\n    expect(createCount()).toBe(2);\n  });\n\n  it('evicts a dirty slot before a warm slot when over cap', async () => {\n    const { adapter } = makeAdapterWithCounter();\n    const session = new EngineSession({ size: 1, adapter });\n    const slot1 = await session.acquire(null);\n    session.commit(slot1, 'rev_X');\n    session.markDirty(slot1);\n    await session.populate('rev_Y', 'SCENE_Y');\n    const slot2 = await session.acquire('rev_Y');\n    expect(slot2).toBe(slot1); // reused\n    expect(slot2.currentRevision).toBe('rev_Y');\n  });\n});\n\ndescribe('EngineSession.currentSlot', () => {\n  it('returns undefined when no slot is warm', () => {\n    const { adapter } = (function makeFakeEngine() {\n      const engine = { _scene: 'INITIAL' };\n      const adapter: EngineAdapter = {\n        create: () => engine,\n        reset: vi.fn(async () => {\n          engine._scene = 'RESET';\n        }),\n        loadFromString: vi.fn(async () => {}),\n        saveToString: vi.fn(async () => engine._scene)\n      };\n      return { adapter };\n    })();\n    const session = new EngineSession({ size: 1, adapter });\n    expect(session.currentSlot()).toBeUndefined();\n  });\n\n  it('returns the slot once it has been committed to a revision', async () => {\n    const engine = { _scene: 'INITIAL' };\n    const adapter: EngineAdapter = {\n      create: () => engine,\n      reset: vi.fn(async () => {\n        engine._scene = 'RESET';\n      }),\n      loadFromString: vi.fn(async () => {}),\n      saveToString: vi.fn(async () => engine._scene)\n    };\n    const session = new EngineSession({ size: 1, adapter });\n    const slot = await session.acquire(null);\n    expect(session.currentSlot()).toBeUndefined(); // currentRevision is null after acquire(null)\n    session.commit(slot, 'rev_X');\n    expect(session.currentSlot()).toBe(slot);\n  });\n});\n"]}

package/dist/test/test/engine/unsplash-source.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=unsplash-source.test.d.ts.map

package/dist/test/test/engine/unsplash-source.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsplash-source.test.d.ts","sourceRoot":"","sources":["../../../../test/engine/unsplash-source.test.ts"],"names":[],"mappings":""}

package/dist/test/test/engine/unsplash-source.test.js

@@ -0,0 +1,129 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { registerUnsplashSource } from '../../src/engine/unsplash-source.js';
+// Minimal engine double: registerUnsplashSource only touches engine.asset.
+function makeEngine(existingSources = []) {
+    const added = [];
+    const engine = {
+        asset: {
+            findAllSources: vi.fn(() => [
+                ...existingSources,
+                ...added.map((s) => s.id)
+            ]),
+            addSource: vi.fn((source) => added.push(source)),
+            defaultApplyAsset: vi.fn(async () => 1)
+        }
+    };
+    // registerUnsplashSource is typed against CreativeEngine; the double only
+    // implements the slice it uses.
+    return {
+        engine: engine,
+        added
+    };
+}
+function mockFetch(payload, ok = true, status = 200) {
+    const fetchMock = vi.fn(async (_url) => ({
+        ok,
+        status,
+        json: async () => payload
+    }));
+    vi.stubGlobal('fetch', fetchMock);
+    return fetchMock;
+}
+const PHOTO = {
+    id: 'abc',
+    description: 'A cat',
+    width: 800,
+    height: 600,
+    urls: { regular: 'https://img/regular.jpg', thumb: 'https://img/thumb.jpg' },
+    user: { name: 'Jane', links: { html: 'https://unsplash.com/@jane' } },
+    tags: [{ title: 'cat' }, { title: 'pet' }]
+};
+function findAssetsOf(added) {
+    return added[0].findAssets;
+}
+afterEach(() => {
+    vi.unstubAllGlobals();
+});
+describe('registerUnsplashSource', () => {
+    it('registers the unsplash source on a fresh engine', () => {
+        const { engine, added } = makeEngine();
+        registerUnsplashSource(engine);
+        expect(added).toHaveLength(1);
+        expect(added[0].id).toBe('unsplash');
+    });
+    it('is idempotent — skips when the source is already present', () => {
+        const { engine, added } = makeEngine(['unsplash']);
+        registerUnsplashSource(engine);
+        expect(added).toHaveLength(0);
+    });
+    it('searches via /search/photos when a query is set and maps the result', async () => {
+        const fetchMock = mockFetch({
+            results: [PHOTO],
+            total: 50,
+            total_pages: 5
+        });
+        const { engine, added } = makeEngine();
+        registerUnsplashSource(engine);
+        const query = {
+            query: 'cats',
+            page: 0,
+            perPage: 10,
+            locale: 'en'
+        };
+        const res = (await findAssetsOf(added)(query));
+        const url = fetchMock.mock.calls[0][0];
+        expect(url).toContain('/search/photos');
+        expect(url).toContain('query=cats');
+        expect(url).toContain('page=1'); // 0-based query → 1-based Unsplash
+        expect(url).toContain('per_page=10');
+        expect(res.assets).toHaveLength(1);
+        expect(res.assets[0]).toMatchObject({
+            id: 'abc',
+            label: 'A cat',
+            tags: ['cat', 'pet'],
+            meta: {
+                uri: 'https://img/regular.jpg',
+                thumbUri: 'https://img/thumb.jpg'
+            },
+            credits: { name: 'Jane', url: 'https://unsplash.com/@jane' }
+        });
+        expect(res.nextPage).toBe(1); // page 0 of 5 → next is 1
+    });
+    it('browses popular photos via /photos when no query is set', async () => {
+        const fetchMock = mockFetch([PHOTO, PHOTO]);
+        const { engine, added } = makeEngine();
+        registerUnsplashSource(engine);
+        const query = {
+            page: 0,
+            perPage: 2,
+            locale: 'en'
+        };
+        const res = (await findAssetsOf(added)(query));
+        const url = fetchMock.mock.calls[0][0];
+        expect(url).toContain('/photos?order_by=popular');
+        expect(res.assets).toHaveLength(2);
+        expect(res.nextPage).toBe(1); // full page → there may be more
+    });
+    it('stops paginating when a partial page comes back', async () => {
+        mockFetch([PHOTO]); // 1 < perPage(2)
+        const { engine, added } = makeEngine();
+        registerUnsplashSource(engine);
+        const res = (await findAssetsOf(added)({
+            page: 0,
+            perPage: 2,
+            locale: 'en'
+        }));
+        expect(res.nextPage).toBeUndefined();
+    });
+    it('throws when the proxy returns a non-OK status', async () => {
+        mockFetch({}, false, 502);
+        const { engine, added } = makeEngine();
+        registerUnsplashSource(engine);
+        await expect(findAssetsOf(added)({
+            page: 0,
+            perPage: 5,
+            locale: 'en'
+        })).rejects.toThrow('unsplash proxy: HTTP 502');
+    });
+});
+//# sourceMappingURL=unsplash-source.test.js.map

package/dist/test/test/engine/unsplash-source.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsplash-source.test.js","sourceRoot":"","sources":["../../../../test/engine/unsplash-source.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { afterEach, describe, expect, it, vi } from 'vitest';\nimport type {\n  AssetQueryData,\n  AssetsQueryResult,\n  AssetSource\n} from '@cesdk/engine';\nimport { registerUnsplashSource } from '../../src/engine/unsplash-source.js';\n\n// Minimal engine double: registerUnsplashSource only touches engine.asset.\nfunction makeEngine(existingSources: string[] = []) {\n  const added: AssetSource[] = [];\n  const engine = {\n    asset: {\n      findAllSources: vi.fn(() => [\n        ...existingSources,\n        ...added.map((s) => s.id)\n      ]),\n      addSource: vi.fn((source: AssetSource) => added.push(source)),\n      defaultApplyAsset: vi.fn(async () => 1)\n    }\n  };\n  // registerUnsplashSource is typed against CreativeEngine; the double only\n  // implements the slice it uses.\n  return {\n    engine: engine as unknown as Parameters<typeof registerUnsplashSource>[0],\n    added\n  };\n}\n\nfunction mockFetch(payload: unknown, ok = true, status = 200) {\n  const fetchMock = vi.fn(async (_url: string) => ({\n    ok,\n    status,\n    json: async () => payload\n  }));\n  vi.stubGlobal('fetch', fetchMock);\n  return fetchMock;\n}\n\nconst PHOTO = {\n  id: 'abc',\n  description: 'A cat',\n  width: 800,\n  height: 600,\n  urls: { regular: 'https://img/regular.jpg', thumb: 'https://img/thumb.jpg' },\n  user: { name: 'Jane', links: { html: 'https://unsplash.com/@jane' } },\n  tags: [{ title: 'cat' }, { title: 'pet' }]\n};\n\nfunction findAssetsOf(added: AssetSource[]): AssetSource['findAssets'] {\n  return added[0].findAssets;\n}\n\nafterEach(() => {\n  vi.unstubAllGlobals();\n});\n\ndescribe('registerUnsplashSource', () => {\n  it('registers the unsplash source on a fresh engine', () => {\n    const { engine, added } = makeEngine();\n    registerUnsplashSource(engine);\n    expect(added).toHaveLength(1);\n    expect(added[0].id).toBe('unsplash');\n  });\n\n  it('is idempotent — skips when the source is already present', () => {\n    const { engine, added } = makeEngine(['unsplash']);\n    registerUnsplashSource(engine);\n    expect(added).toHaveLength(0);\n  });\n\n  it('searches via /search/photos when a query is set and maps the result', async () => {\n    const fetchMock = mockFetch({\n      results: [PHOTO],\n      total: 50,\n      total_pages: 5\n    });\n    const { engine, added } = makeEngine();\n    registerUnsplashSource(engine);\n\n    const query: AssetQueryData = {\n      query: 'cats',\n      page: 0,\n      perPage: 10,\n      locale: 'en'\n    } as AssetQueryData;\n    const res = (await findAssetsOf(added)(query)) as AssetsQueryResult;\n\n    const url = fetchMock.mock.calls[0][0];\n    expect(url).toContain('/search/photos');\n    expect(url).toContain('query=cats');\n    expect(url).toContain('page=1'); // 0-based query → 1-based Unsplash\n    expect(url).toContain('per_page=10');\n\n    expect(res.assets).toHaveLength(1);\n    expect(res.assets[0]).toMatchObject({\n      id: 'abc',\n      label: 'A cat',\n      tags: ['cat', 'pet'],\n      meta: {\n        uri: 'https://img/regular.jpg',\n        thumbUri: 'https://img/thumb.jpg'\n      },\n      credits: { name: 'Jane', url: 'https://unsplash.com/@jane' }\n    });\n    expect(res.nextPage).toBe(1); // page 0 of 5 → next is 1\n  });\n\n  it('browses popular photos via /photos when no query is set', async () => {\n    const fetchMock = mockFetch([PHOTO, PHOTO]);\n    const { engine, added } = makeEngine();\n    registerUnsplashSource(engine);\n\n    const query: AssetQueryData = {\n      page: 0,\n      perPage: 2,\n      locale: 'en'\n    } as AssetQueryData;\n    const res = (await findAssetsOf(added)(query)) as AssetsQueryResult;\n\n    const url = fetchMock.mock.calls[0][0];\n    expect(url).toContain('/photos?order_by=popular');\n    expect(res.assets).toHaveLength(2);\n    expect(res.nextPage).toBe(1); // full page → there may be more\n  });\n\n  it('stops paginating when a partial page comes back', async () => {\n    mockFetch([PHOTO]); // 1 < perPage(2)\n    const { engine, added } = makeEngine();\n    registerUnsplashSource(engine);\n    const res = (await findAssetsOf(added)({\n      page: 0,\n      perPage: 2,\n      locale: 'en'\n    } as AssetQueryData)) as AssetsQueryResult;\n    expect(res.nextPage).toBeUndefined();\n  });\n\n  it('throws when the proxy returns a non-OK status', async () => {\n    mockFetch({}, false, 502);\n    const { engine, added } = makeEngine();\n    registerUnsplashSource(engine);\n    await expect(\n      findAssetsOf(added)({\n        page: 0,\n        perPage: 5,\n        locale: 'en'\n      } as AssetQueryData)\n    ).rejects.toThrow('unsplash proxy: HTTP 502');\n  });\n});\n"]}