@imgly/codesign-mcp 0.1.0 → 0.1.2

package/dist/test/test/viewer/url-builder.test.js

@@ -1,5 +1,7 @@
+import { S3Client } from '@aws-sdk/client-s3';
 import { describe, expect, it } from 'vitest';
-import { HostedStubViewerUrlBuilder, LocalViewerUrlBuilder } from '../../src/viewer/url-builder.js';
+import { LocalViewerUrlBuilder, viewerBaseFor } from '../../src/viewer/url-builder.js';
+import { PresignedR2UrlBuilder } from '../../src/viewer/presigned-r2-url-builder.js';
 describe('LocalViewerUrlBuilder', () => {
     it('builds /d/<root> design URLs against the listener base', () => {
         const b = new LocalViewerUrlBuilder({ base: 'http://127.0.0.1:8745' });
@@ -17,15 +19,80 @@ describe('LocalViewerUrlBuilder', () => {
         const b = new LocalViewerUrlBuilder({ base: 'http://127.0.0.1:8745' });
         expect(b.forResource('assets/9f2a1c.png')).toBe('http://127.0.0.1:8745/r/assets/9f2a1c.png');
     });
+    it('forDownload resolves to the same URL as forResource', async () => {
+        const b = new LocalViewerUrlBuilder({ base: 'http://127.0.0.1:8745' });
+        const relpath = 'exports/ab/cd1234/image.png';
+        await expect(b.forDownload(relpath)).resolves.toBe(b.forResource(relpath));
+    });
+});
+describe('viewerBaseFor', () => {
+    it('session mode + public base → /v/<sid> on the public origin', () => {
+        expect(viewerBaseFor({
+            publicBaseUrl: 'https://codesign.example.com',
+            port: 8080,
+            mode: 'session',
+            sessionId: 'abc-123'
+        })).toBe('https://codesign.example.com/v/abc-123');
+    });
+    it('session mode without public base → loopback /v/<sid>', () => {
+        expect(viewerBaseFor({
+            publicBaseUrl: undefined,
+            port: 8745,
+            mode: 'session',
+            sessionId: 'abc-123'
+        })).toBe('http://127.0.0.1:8745/v/abc-123');
+    });
+    it('single mode → /viewer (the fixed-workspace mount)', () => {
+        expect(viewerBaseFor({
+            publicBaseUrl: undefined,
+            port: 8745,
+            mode: 'single',
+            sessionId: 'abc-123'
+        })).toBe('http://127.0.0.1:8745/viewer');
+    });
 });
-describe('HostedStubViewerUrlBuilder', () => {
-    it('forDesign throws — Phase 2 not implemented', () => {
-        const b = new HostedStubViewerUrlBuilder();
-        expect(() => b.forDesign('abc123def456')).toThrow('Phase 2');
-    });
-    it('forPinnedRevision throws — Phase 2 not implemented', () => {
-        const b = new HostedStubViewerUrlBuilder();
-        expect(() => b.forPinnedRevision('abc123def456', '0011deadbeef')).toThrow('Phase 2');
+describe('PresignedR2UrlBuilder', () => {
+    // getSignedUrl from @aws-sdk/s3-request-presigner signs locally — no network
+    // call is made. We use dummy credentials and a fake R2 endpoint.
+    const client = new S3Client({
+        region: 'auto',
+        endpoint: 'https://accountid.r2.cloudflarestorage.com',
+        forcePathStyle: true,
+        credentials: { accessKeyId: 'test', secretAccessKey: 'test' }
+    });
+    const workspaceId = 'ws-test-001';
+    const builder = new PresignedR2UrlBuilder({
+        base: 'http://127.0.0.1:8745',
+        client,
+        bucket: 'codesign-bucket',
+        workspaceId,
+        expiresIn: 300
+    });
+    it('forDownload returns a presigned URL containing the workspace-scoped R2 key', async () => {
+        const relpath = 'exports/ab/cd1234ef/scene.scene';
+        const url = await builder.forDownload(relpath);
+        // The full key must appear as one ordered, contiguous path segment —
+        // workspaces/<workspaceId>/<relpath> — not just the fragments in any order.
+        // R2 keys aren't percent-encoded for these chars, so assert the exact path.
+        expect(url).toContain(`workspaces/${workspaceId}/${relpath}`);
+    });
+    it('forDownload URL contains X-Amz-Signature (proves it is presigned)', async () => {
+        const url = await builder.forDownload('exports/ab/cd/image.png');
+        expect(url).toContain('X-Amz-Signature');
+    });
+    it('inherits sync forResource from LocalViewerUrlBuilder unchanged', () => {
+        expect(builder.forResource('assets/9f2a1c.png')).toBe('http://127.0.0.1:8745/r/assets/9f2a1c.png');
+    });
+    it('forDownload with default expiresIn (3600) also signs', async () => {
+        const b = new PresignedR2UrlBuilder({
+            base: 'http://127.0.0.1:8745',
+            client,
+            bucket: 'codesign-bucket',
+            workspaceId: 'ws-default'
+        });
+        const url = await b.forDownload('exports/11/22/design.scene');
+        expect(url).toContain('X-Amz-Signature');
+        expect(url).toContain('ws-default');
     });
 });
 //# sourceMappingURL=url-builder.test.js.map

package/dist/test/test/viewer/url-builder.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"url-builder.test.js","sourceRoot":"","sources":["../../../../test/viewer/url-builder.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACtB,MAAM,iCAAiC,CAAC;AAEzC,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,GAAG,IAAI,qBAAqB,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CACtC,sCAAsC,CACvC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,GAAG,IAAI,qBAAqB,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAC9D,mDAAmD,CACpD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,GAAG,IAAI,qBAAqB,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,CAAC,GAAG,IAAI,qBAAqB,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAC7C,2CAA2C,CAC5C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,GAAG,IAAI,0BAA0B,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,GAAG,IAAI,0BAA0B,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,CACvE,SAAS,CACV,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from 'vitest';\nimport {\n  HostedStubViewerUrlBuilder,\n  LocalViewerUrlBuilder\n} from '../../src/viewer/url-builder.js';\n\ndescribe('LocalViewerUrlBuilder', () => {\n  it('builds /d/<root> design URLs against the listener base', () => {\n    const b = new LocalViewerUrlBuilder({ base: 'http://127.0.0.1:8745' });\n    expect(b.forDesign('abc123def456')).toBe(\n      'http://127.0.0.1:8745/d/abc123def456'\n    );\n  });\n\n  it('builds /d/<root>/<rev> pinned-revision URLs', () => {\n    const b = new LocalViewerUrlBuilder({ base: 'http://127.0.0.1:8745' });\n    expect(b.forPinnedRevision('abc123def456', '0011deadbeef')).toBe(\n      'http://127.0.0.1:8745/d/abc123def456/0011deadbeef'\n    );\n  });\n\n  it('builds the studio landing URL', () => {\n    const b = new LocalViewerUrlBuilder({ base: 'http://127.0.0.1:8745' });\n    expect(b.forStudio()).toBe('http://127.0.0.1:8745/');\n  });\n\n  it('builds /r/<relpath> resource URLs against the listener base', () => {\n    const b = new LocalViewerUrlBuilder({ base: 'http://127.0.0.1:8745' });\n    expect(b.forResource('assets/9f2a1c.png')).toBe(\n      'http://127.0.0.1:8745/r/assets/9f2a1c.png'\n    );\n  });\n});\n\ndescribe('HostedStubViewerUrlBuilder', () => {\n  it('forDesign throws — Phase 2 not implemented', () => {\n    const b = new HostedStubViewerUrlBuilder();\n    expect(() => b.forDesign('abc123def456')).toThrow('Phase 2');\n  });\n\n  it('forPinnedRevision throws — Phase 2 not implemented', () => {\n    const b = new HostedStubViewerUrlBuilder();\n    expect(() => b.forPinnedRevision('abc123def456', '0011deadbeef')).toThrow(\n      'Phase 2'\n    );\n  });\n});\n"]}
+{"version":3,"file":"url-builder.test.js","sourceRoot":"","sources":["../../../../test/viewer/url-builder.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,qBAAqB,EACrB,aAAa,EACd,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AAErF,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,GAAG,IAAI,qBAAqB,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CACtC,sCAAsC,CACvC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,GAAG,IAAI,qBAAqB,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAC9D,mDAAmD,CACpD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,GAAG,IAAI,qBAAqB,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,CAAC,GAAG,IAAI,qBAAqB,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAC7C,2CAA2C,CAC5C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,CAAC,GAAG,IAAI,qBAAqB,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,6BAA6B,CAAC;QAC9C,MAAM,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,CACJ,aAAa,CAAC;YACZ,aAAa,EAAE,8BAA8B;YAC7C,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,SAAS;SACrB,CAAC,CACH,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,CACJ,aAAa,CAAC;YACZ,aAAa,EAAE,SAAS;YACxB,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,SAAS;SACrB,CAAC,CACH,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CACJ,aAAa,CAAC;YACZ,aAAa,EAAE,SAAS;YACxB,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,SAAS;SACrB,CAAC,CACH,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,6EAA6E;IAC7E,iEAAiE;IACjE,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC;QAC1B,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,4CAA4C;QACtD,cAAc,EAAE,IAAI;QACpB,WAAW,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE;KAC9D,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,aAAa,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,qBAAqB,CAAC;QACxC,IAAI,EAAE,uBAAuB;QAC7B,MAAM;QACN,MAAM,EAAE,iBAAiB;QACzB,WAAW;QACX,SAAS,EAAE,GAAG;KACf,CAAC,CAAC;IAEH,EAAE,CAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;QAC1F,MAAM,OAAO,GAAG,iCAAiC,CAAC;QAClD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC/C,qEAAqE;QACrE,4EAA4E;QAC5E,4EAA4E;QAC5E,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,cAAc,WAAW,IAAI,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC;QACjE,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CACnD,2CAA2C,CAC5C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,CAAC,GAAG,IAAI,qBAAqB,CAAC;YAClC,IAAI,EAAE,uBAAuB;YAC7B,MAAM;YACN,MAAM,EAAE,iBAAiB;YACzB,WAAW,EAAE,YAAY;SAC1B,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,WAAW,CAAC,4BAA4B,CAAC,CAAC;QAC9D,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { S3Client } from '@aws-sdk/client-s3';\nimport { describe, expect, it } from 'vitest';\nimport {\n  LocalViewerUrlBuilder,\n  viewerBaseFor\n} from '../../src/viewer/url-builder.js';\nimport { PresignedR2UrlBuilder } from '../../src/viewer/presigned-r2-url-builder.js';\n\ndescribe('LocalViewerUrlBuilder', () => {\n  it('builds /d/<root> design URLs against the listener base', () => {\n    const b = new LocalViewerUrlBuilder({ base: 'http://127.0.0.1:8745' });\n    expect(b.forDesign('abc123def456')).toBe(\n      'http://127.0.0.1:8745/d/abc123def456'\n    );\n  });\n\n  it('builds /d/<root>/<rev> pinned-revision URLs', () => {\n    const b = new LocalViewerUrlBuilder({ base: 'http://127.0.0.1:8745' });\n    expect(b.forPinnedRevision('abc123def456', '0011deadbeef')).toBe(\n      'http://127.0.0.1:8745/d/abc123def456/0011deadbeef'\n    );\n  });\n\n  it('builds the studio landing URL', () => {\n    const b = new LocalViewerUrlBuilder({ base: 'http://127.0.0.1:8745' });\n    expect(b.forStudio()).toBe('http://127.0.0.1:8745/');\n  });\n\n  it('builds /r/<relpath> resource URLs against the listener base', () => {\n    const b = new LocalViewerUrlBuilder({ base: 'http://127.0.0.1:8745' });\n    expect(b.forResource('assets/9f2a1c.png')).toBe(\n      'http://127.0.0.1:8745/r/assets/9f2a1c.png'\n    );\n  });\n\n  it('forDownload resolves to the same URL as forResource', async () => {\n    const b = new LocalViewerUrlBuilder({ base: 'http://127.0.0.1:8745' });\n    const relpath = 'exports/ab/cd1234/image.png';\n    await expect(b.forDownload(relpath)).resolves.toBe(b.forResource(relpath));\n  });\n});\n\ndescribe('viewerBaseFor', () => {\n  it('session mode + public base → /v/<sid> on the public origin', () => {\n    expect(\n      viewerBaseFor({\n        publicBaseUrl: 'https://codesign.example.com',\n        port: 8080,\n        mode: 'session',\n        sessionId: 'abc-123'\n      })\n    ).toBe('https://codesign.example.com/v/abc-123');\n  });\n\n  it('session mode without public base → loopback /v/<sid>', () => {\n    expect(\n      viewerBaseFor({\n        publicBaseUrl: undefined,\n        port: 8745,\n        mode: 'session',\n        sessionId: 'abc-123'\n      })\n    ).toBe('http://127.0.0.1:8745/v/abc-123');\n  });\n\n  it('single mode → /viewer (the fixed-workspace mount)', () => {\n    expect(\n      viewerBaseFor({\n        publicBaseUrl: undefined,\n        port: 8745,\n        mode: 'single',\n        sessionId: 'abc-123'\n      })\n    ).toBe('http://127.0.0.1:8745/viewer');\n  });\n});\n\ndescribe('PresignedR2UrlBuilder', () => {\n  // getSignedUrl from @aws-sdk/s3-request-presigner signs locally — no network\n  // call is made. We use dummy credentials and a fake R2 endpoint.\n  const client = new S3Client({\n    region: 'auto',\n    endpoint: 'https://accountid.r2.cloudflarestorage.com',\n    forcePathStyle: true,\n    credentials: { accessKeyId: 'test', secretAccessKey: 'test' }\n  });\n  const workspaceId = 'ws-test-001';\n  const builder = new PresignedR2UrlBuilder({\n    base: 'http://127.0.0.1:8745',\n    client,\n    bucket: 'codesign-bucket',\n    workspaceId,\n    expiresIn: 300\n  });\n\n  it('forDownload returns a presigned URL containing the workspace-scoped R2 key', async () => {\n    const relpath = 'exports/ab/cd1234ef/scene.scene';\n    const url = await builder.forDownload(relpath);\n    // The full key must appear as one ordered, contiguous path segment —\n    // workspaces/<workspaceId>/<relpath> — not just the fragments in any order.\n    // R2 keys aren't percent-encoded for these chars, so assert the exact path.\n    expect(url).toContain(`workspaces/${workspaceId}/${relpath}`);\n  });\n\n  it('forDownload URL contains X-Amz-Signature (proves it is presigned)', async () => {\n    const url = await builder.forDownload('exports/ab/cd/image.png');\n    expect(url).toContain('X-Amz-Signature');\n  });\n\n  it('inherits sync forResource from LocalViewerUrlBuilder unchanged', () => {\n    expect(builder.forResource('assets/9f2a1c.png')).toBe(\n      'http://127.0.0.1:8745/r/assets/9f2a1c.png'\n    );\n  });\n\n  it('forDownload with default expiresIn (3600) also signs', async () => {\n    const b = new PresignedR2UrlBuilder({\n      base: 'http://127.0.0.1:8745',\n      client,\n      bucket: 'codesign-bucket',\n      workspaceId: 'ws-default'\n    });\n    const url = await b.forDownload('exports/11/22/design.scene');\n    expect(url).toContain('X-Amz-Signature');\n    expect(url).toContain('ws-default');\n  });\n});\n"]}

package/dist/test/test/workspace/s3.test.d.ts

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

package/dist/test/test/workspace/s3.test.d.ts.map

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

package/dist/test/test/workspace/s3.test.js

@@ -0,0 +1,153 @@
+import { describe, expect, it, vi } from 'vitest';
+import { DeleteObjectCommand, GetObjectCommand, HeadObjectCommand, ListObjectsV2Command, PutObjectCommand } from '@aws-sdk/client-s3';
+import { S3WorkspaceFS } from '../../src/workspace/s3.js';
+/** Minimal in-memory fake of the S3 `send`-based client the adapter uses. */
+function makeFakeS3(seed = {}) {
+    const store = new Map();
+    for (const [k, v] of Object.entries(seed))
+        store.set(k, new TextEncoder().encode(v));
+    const notFound = () => {
+        const err = new Error('NoSuchKey');
+        err.name = 'NoSuchKey';
+        err.$metadata = { httpStatusCode: 404 };
+        throw err;
+    };
+    const client = {
+        store,
+        send: vi.fn(async (cmd) => {
+            if (cmd instanceof PutObjectCommand) {
+                const { Key, Body } = cmd.input;
+                const bytes = typeof Body === 'string'
+                    ? new TextEncoder().encode(Body)
+                    : Body;
+                store.set(Key, bytes);
+                return {};
+            }
+            if (cmd instanceof GetObjectCommand) {
+                const bytes = store.get(cmd.input.Key);
+                if (!bytes)
+                    notFound();
+                return {
+                    Body: {
+                        transformToByteArray: async () => bytes
+                    }
+                };
+            }
+            if (cmd instanceof HeadObjectCommand) {
+                const bytes = store.get(cmd.input.Key);
+                if (!bytes)
+                    notFound();
+                return { ContentLength: bytes.byteLength, LastModified: new Date(0) };
+            }
+            if (cmd instanceof ListObjectsV2Command) {
+                const prefix = cmd.input.Prefix ?? '';
+                const delimiter = cmd.input.Delimiter;
+                const keys = [...store.keys()].filter((k) => k.startsWith(prefix));
+                const contents = [];
+                const commonPrefixes = new Set();
+                for (const k of keys) {
+                    const rest = k.slice(prefix.length);
+                    if (delimiter && rest.includes(delimiter)) {
+                        commonPrefixes.add(prefix + rest.slice(0, rest.indexOf(delimiter) + 1));
+                    }
+                    else {
+                        contents.push({ Key: k });
+                    }
+                }
+                return {
+                    Contents: contents,
+                    CommonPrefixes: [...commonPrefixes].map((Prefix) => ({ Prefix })),
+                    IsTruncated: false
+                };
+            }
+            if (cmd instanceof DeleteObjectCommand) {
+                store.delete(cmd.input.Key);
+                return {};
+            }
+            throw new Error(`fake S3: unhandled command ${cmd.constructor.name}`);
+        })
+    };
+    return client;
+}
+function makeFs(seed) {
+    const client = makeFakeS3(seed);
+    const fs = new S3WorkspaceFS({ client: client, bucket: 'b' });
+    return { fs, client };
+}
+describe('S3WorkspaceFS', () => {
+    it('writeFile then readFile round-trips utf8', async () => {
+        const { fs } = makeFs();
+        await fs.writeFile('objects/ab/cd.scene', 'hello');
+        expect(await fs.readFile('objects/ab/cd.scene', 'utf8')).toBe('hello');
+    });
+    it('readFile throws ENOENT for a missing key', async () => {
+        const { fs } = makeFs();
+        await expect(fs.readFile('missing', 'utf8')).rejects.toMatchObject({
+            code: 'ENOENT'
+        });
+    });
+    it('exists is true for a written key and false otherwise', async () => {
+        const { fs } = makeFs({ 'a/b': 'x' });
+        expect(await fs.exists('a/b')).toBe(true);
+        expect(await fs.exists('a/z')).toBe(false);
+    });
+    it('exists is true for a prefix that has children (a "directory")', async () => {
+        const { fs } = makeFs({ 'journal/root1/0001-leaf': '' });
+        expect(await fs.exists('journal')).toBe(true);
+    });
+    it('readdir returns immediate child names (dirs + files)', async () => {
+        const { fs } = makeFs({
+            'journal/root1/0001-a': '',
+            'journal/root2/0002-b': ''
+        });
+        expect((await fs.readdir('journal')).sort()).toEqual(['root1', 'root2']);
+        expect(await fs.readdir('journal/root1')).toEqual(['0001-a']);
+    });
+    it('rename copies bytes to the new key and removes the old', async () => {
+        const { fs } = makeFs({ 'a/old': 'payload' });
+        await fs.rename('a/old', 'a/new');
+        expect(await fs.exists('a/old')).toBe(false);
+        expect(await fs.readFile('a/new', 'utf8')).toBe('payload');
+    });
+    it('stat reports a file for an object and a directory for a prefix', async () => {
+        const { fs } = makeFs({ 'd/child': 'x' });
+        const fileStat = await fs.stat('d/child');
+        expect(fileStat.isFile()).toBe(true);
+        expect(fileStat.isDirectory()).toBe(false);
+        const dirStat = await fs.stat('d');
+        expect(dirStat.isDirectory()).toBe(true);
+        expect(dirStat.isFile()).toBe(false);
+    });
+    it('rm recursive deletes the prefix subtree AND the key itself', async () => {
+        const { fs } = makeFs({
+            p: 'self',
+            'p/a': '1',
+            'p/b/c': '2'
+        });
+        await fs.rm('p', { recursive: true });
+        expect(await fs.exists('p')).toBe(false);
+        expect(await fs.exists('p/a')).toBe(false);
+        expect(await fs.exists('p/b/c')).toBe(false);
+    });
+    it('retries a read-after-write 404 then succeeds (bounded)', async () => {
+        const { fs, client } = makeFs();
+        let gets = 0;
+        const realSend = client.send;
+        client.send = vi.fn(async (cmd) => {
+            if (cmd instanceof GetObjectCommand) {
+                gets += 1;
+                if (gets === 1) {
+                    const err = new Error('NoSuchKey');
+                    err.name = 'NoSuchKey';
+                    err.$metadata = { httpStatusCode: 404 };
+                    throw err;
+                }
+            }
+            return realSend(cmd);
+        });
+        client.store.set('k', new TextEncoder().encode('v'));
+        expect(await fs.readFile('k', 'utf8')).toBe('v');
+        expect(gets).toBe(2);
+    });
+});
+//# sourceMappingURL=s3.test.js.map

package/dist/test/test/workspace/s3.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.test.js","sourceRoot":"","sources":["../../../../test/workspace/s3.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it, vi } from 'vitest';\nimport {\n  DeleteObjectCommand,\n  GetObjectCommand,\n  HeadObjectCommand,\n  ListObjectsV2Command,\n  PutObjectCommand\n} from '@aws-sdk/client-s3';\nimport { S3WorkspaceFS } from '../../src/workspace/s3.js';\n\n/** Minimal in-memory fake of the S3 `send`-based client the adapter uses. */\nfunction makeFakeS3(seed: Record<string, string> = {}) {\n  const store = new Map<string, Uint8Array>();\n  for (const [k, v] of Object.entries(seed))\n    store.set(k, new TextEncoder().encode(v));\n\n  const notFound = (): never => {\n    const err = new Error('NoSuchKey') as Error & {\n      name: string;\n      $metadata: { httpStatusCode: number };\n    };\n    err.name = 'NoSuchKey';\n    err.$metadata = { httpStatusCode: 404 };\n    throw err;\n  };\n\n  const client = {\n    store,\n    send: vi.fn(async (cmd: unknown) => {\n      if (cmd instanceof PutObjectCommand) {\n        const { Key, Body } = cmd.input;\n        const bytes =\n          typeof Body === 'string'\n            ? new TextEncoder().encode(Body)\n            : (Body as Uint8Array);\n        store.set(Key as string, bytes);\n        return {};\n      }\n      if (cmd instanceof GetObjectCommand) {\n        const bytes = store.get(cmd.input.Key as string);\n        if (!bytes) notFound();\n        return {\n          Body: {\n            transformToByteArray: async () => bytes\n          }\n        };\n      }\n      if (cmd instanceof HeadObjectCommand) {\n        const bytes = store.get(cmd.input.Key as string);\n        if (!bytes) notFound();\n        return { ContentLength: bytes!.byteLength, LastModified: new Date(0) };\n      }\n      if (cmd instanceof ListObjectsV2Command) {\n        const prefix = (cmd.input.Prefix as string) ?? '';\n        const delimiter = cmd.input.Delimiter as string | undefined;\n        const keys = [...store.keys()].filter((k) => k.startsWith(prefix));\n        const contents: Array<{ Key: string }> = [];\n        const commonPrefixes = new Set<string>();\n        for (const k of keys) {\n          const rest = k.slice(prefix.length);\n          if (delimiter && rest.includes(delimiter)) {\n            commonPrefixes.add(\n              prefix + rest.slice(0, rest.indexOf(delimiter) + 1)\n            );\n          } else {\n            contents.push({ Key: k });\n          }\n        }\n        return {\n          Contents: contents,\n          CommonPrefixes: [...commonPrefixes].map((Prefix) => ({ Prefix })),\n          IsTruncated: false\n        };\n      }\n      if (cmd instanceof DeleteObjectCommand) {\n        store.delete(cmd.input.Key as string);\n        return {};\n      }\n      throw new Error(\n        `fake S3: unhandled command ${(cmd as object).constructor.name}`\n      );\n    })\n  };\n  return client;\n}\n\nfunction makeFs(seed?: Record<string, string>) {\n  const client = makeFakeS3(seed);\n  const fs = new S3WorkspaceFS({ client: client as never, bucket: 'b' });\n  return { fs, client };\n}\n\ndescribe('S3WorkspaceFS', () => {\n  it('writeFile then readFile round-trips utf8', async () => {\n    const { fs } = makeFs();\n    await fs.writeFile('objects/ab/cd.scene', 'hello');\n    expect(await fs.readFile('objects/ab/cd.scene', 'utf8')).toBe('hello');\n  });\n\n  it('readFile throws ENOENT for a missing key', async () => {\n    const { fs } = makeFs();\n    await expect(fs.readFile('missing', 'utf8')).rejects.toMatchObject({\n      code: 'ENOENT'\n    });\n  });\n\n  it('exists is true for a written key and false otherwise', async () => {\n    const { fs } = makeFs({ 'a/b': 'x' });\n    expect(await fs.exists('a/b')).toBe(true);\n    expect(await fs.exists('a/z')).toBe(false);\n  });\n\n  it('exists is true for a prefix that has children (a \"directory\")', async () => {\n    const { fs } = makeFs({ 'journal/root1/0001-leaf': '' });\n    expect(await fs.exists('journal')).toBe(true);\n  });\n\n  it('readdir returns immediate child names (dirs + files)', async () => {\n    const { fs } = makeFs({\n      'journal/root1/0001-a': '',\n      'journal/root2/0002-b': ''\n    });\n    expect((await fs.readdir('journal')).sort()).toEqual(['root1', 'root2']);\n    expect(await fs.readdir('journal/root1')).toEqual(['0001-a']);\n  });\n\n  it('rename copies bytes to the new key and removes the old', async () => {\n    const { fs } = makeFs({ 'a/old': 'payload' });\n    await fs.rename('a/old', 'a/new');\n    expect(await fs.exists('a/old')).toBe(false);\n    expect(await fs.readFile('a/new', 'utf8')).toBe('payload');\n  });\n\n  it('stat reports a file for an object and a directory for a prefix', async () => {\n    const { fs } = makeFs({ 'd/child': 'x' });\n    const fileStat = await fs.stat('d/child');\n    expect(fileStat.isFile()).toBe(true);\n    expect(fileStat.isDirectory()).toBe(false);\n    const dirStat = await fs.stat('d');\n    expect(dirStat.isDirectory()).toBe(true);\n    expect(dirStat.isFile()).toBe(false);\n  });\n\n  it('rm recursive deletes the prefix subtree AND the key itself', async () => {\n    const { fs } = makeFs({\n      p: 'self',\n      'p/a': '1',\n      'p/b/c': '2'\n    });\n    await fs.rm('p', { recursive: true });\n    expect(await fs.exists('p')).toBe(false);\n    expect(await fs.exists('p/a')).toBe(false);\n    expect(await fs.exists('p/b/c')).toBe(false);\n  });\n\n  it('retries a read-after-write 404 then succeeds (bounded)', async () => {\n    const { fs, client } = makeFs();\n    let gets = 0;\n    const realSend = client.send;\n    client.send = vi.fn(async (cmd: unknown) => {\n      if (cmd instanceof GetObjectCommand) {\n        gets += 1;\n        if (gets === 1) {\n          const err = new Error('NoSuchKey') as Error & {\n            name: string;\n            $metadata: { httpStatusCode: number };\n          };\n          err.name = 'NoSuchKey';\n          err.$metadata = { httpStatusCode: 404 };\n          throw err;\n        }\n      }\n      return realSend(cmd);\n    });\n    client.store.set('k', new TextEncoder().encode('v'));\n    expect(await fs.readFile('k', 'utf8')).toBe('v');\n    expect(gets).toBe(2);\n  });\n});\n"]}

package/dist/test/test/workspace/scoped.test.d.ts

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

package/dist/test/test/workspace/scoped.test.d.ts.map

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

package/dist/test/test/workspace/scoped.test.js

@@ -0,0 +1,59 @@
+import { describe, expect, it } from 'vitest';
+import { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';
+import { sanitizeWorkspaceId, ScopedWorkspaceFS } from '../../src/workspace/scoped.js';
+describe('sanitizeWorkspaceId', () => {
+    it('accepts a plain id and a namespaced id', () => {
+        expect(sanitizeWorkspaceId('default')).toBe('default');
+        expect(sanitizeWorkspaceId('u/usr_8842')).toBe('u/usr_8842');
+        expect(sanitizeWorkspaceId('s/abc-123')).toBe('s/abc-123');
+    });
+    it.each([
+        ['', 'empty'],
+        ['/abs', 'leading slash'],
+        ['..', 'dot-dot'],
+        ['a/../b', 'traversal segment'],
+        ['a//b', 'empty segment'],
+        ['a/', 'trailing slash'],
+        ['a\\b', 'backslash'],
+        ['a\x01b', 'control char']
+    ])('rejects %s (%s) with EINVAL', (id) => {
+        expect(() => sanitizeWorkspaceId(id)).toThrowError(expect.objectContaining({ code: 'EINVAL' }));
+    });
+});
+describe('ScopedWorkspaceFS', () => {
+    it('prefixes writes/reads under workspaces/<id>/', async () => {
+        const inner = new InMemoryWorkspaceFS();
+        const scoped = new ScopedWorkspaceFS(inner, 'u/usr_8842');
+        await scoped.writeFile('objects/ab/cd.scene', 'hello');
+        expect(await inner.readFile('workspaces/u/usr_8842/objects/ab/cd.scene', 'utf8')).toBe('hello');
+        expect(await scoped.readFile('objects/ab/cd.scene', 'utf8')).toBe('hello');
+    });
+    it('isolates two workspaces sharing one inner fs', async () => {
+        const inner = new InMemoryWorkspaceFS();
+        const a = new ScopedWorkspaceFS(inner, 'u/a');
+        const b = new ScopedWorkspaceFS(inner, 'u/b');
+        await a.writeFile('f', 'A');
+        await b.writeFile('f', 'B');
+        expect(await a.readFile('f', 'utf8')).toBe('A');
+        expect(await b.readFile('f', 'utf8')).toBe('B');
+    });
+    it('scopes readdir input and returns unprefixed names', async () => {
+        const inner = new InMemoryWorkspaceFS();
+        const scoped = new ScopedWorkspaceFS(inner, 'ws');
+        await scoped.writeFile('journal/root1/0000000000000005-abc', '');
+        expect(await scoped.readdir('journal')).toEqual(['root1']);
+    });
+    it('scopes both paths of a rename', async () => {
+        const inner = new InMemoryWorkspaceFS();
+        const scoped = new ScopedWorkspaceFS(inner, 'ws');
+        await scoped.writeFile('a', 'x');
+        await scoped.rename('a', 'b');
+        expect(await scoped.exists('a')).toBe(false);
+        expect(await scoped.readFile('b', 'utf8')).toBe('x');
+        expect(await inner.exists('workspaces/ws/b')).toBe(true);
+    });
+    it('rejects an illegal workspaceId at construction', () => {
+        expect(() => new ScopedWorkspaceFS(new InMemoryWorkspaceFS(), '../escape')).toThrowError(expect.objectContaining({ code: 'EINVAL' }));
+    });
+});
+//# sourceMappingURL=scoped.test.js.map

package/dist/test/test/workspace/scoped.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped.test.js","sourceRoot":"","sources":["../../../../test/workspace/scoped.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from 'vitest';\nimport { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';\nimport {\n  sanitizeWorkspaceId,\n  ScopedWorkspaceFS\n} from '../../src/workspace/scoped.js';\n\ndescribe('sanitizeWorkspaceId', () => {\n  it('accepts a plain id and a namespaced id', () => {\n    expect(sanitizeWorkspaceId('default')).toBe('default');\n    expect(sanitizeWorkspaceId('u/usr_8842')).toBe('u/usr_8842');\n    expect(sanitizeWorkspaceId('s/abc-123')).toBe('s/abc-123');\n  });\n\n  it.each([\n    ['', 'empty'],\n    ['/abs', 'leading slash'],\n    ['..', 'dot-dot'],\n    ['a/../b', 'traversal segment'],\n    ['a//b', 'empty segment'],\n    ['a/', 'trailing slash'],\n    ['a\\\\b', 'backslash'],\n    ['a\\x01b', 'control char']\n  ])('rejects %s (%s) with EINVAL', (id) => {\n    expect(() => sanitizeWorkspaceId(id)).toThrowError(\n      expect.objectContaining({ code: 'EINVAL' })\n    );\n  });\n});\n\ndescribe('ScopedWorkspaceFS', () => {\n  it('prefixes writes/reads under workspaces/<id>/', async () => {\n    const inner = new InMemoryWorkspaceFS();\n    const scoped = new ScopedWorkspaceFS(inner, 'u/usr_8842');\n    await scoped.writeFile('objects/ab/cd.scene', 'hello');\n    expect(\n      await inner.readFile('workspaces/u/usr_8842/objects/ab/cd.scene', 'utf8')\n    ).toBe('hello');\n    expect(await scoped.readFile('objects/ab/cd.scene', 'utf8')).toBe('hello');\n  });\n\n  it('isolates two workspaces sharing one inner fs', async () => {\n    const inner = new InMemoryWorkspaceFS();\n    const a = new ScopedWorkspaceFS(inner, 'u/a');\n    const b = new ScopedWorkspaceFS(inner, 'u/b');\n    await a.writeFile('f', 'A');\n    await b.writeFile('f', 'B');\n    expect(await a.readFile('f', 'utf8')).toBe('A');\n    expect(await b.readFile('f', 'utf8')).toBe('B');\n  });\n\n  it('scopes readdir input and returns unprefixed names', async () => {\n    const inner = new InMemoryWorkspaceFS();\n    const scoped = new ScopedWorkspaceFS(inner, 'ws');\n    await scoped.writeFile('journal/root1/0000000000000005-abc', '');\n    expect(await scoped.readdir('journal')).toEqual(['root1']);\n  });\n\n  it('scopes both paths of a rename', async () => {\n    const inner = new InMemoryWorkspaceFS();\n    const scoped = new ScopedWorkspaceFS(inner, 'ws');\n    await scoped.writeFile('a', 'x');\n    await scoped.rename('a', 'b');\n    expect(await scoped.exists('a')).toBe(false);\n    expect(await scoped.readFile('b', 'utf8')).toBe('x');\n    expect(await inner.exists('workspaces/ws/b')).toBe(true);\n  });\n\n  it('rejects an illegal workspaceId at construction', () => {\n    expect(\n      () => new ScopedWorkspaceFS(new InMemoryWorkspaceFS(), '../escape')\n    ).toThrowError(expect.objectContaining({ code: 'EINVAL' }));\n  });\n});\n"]}