@kumwe/studio-testkit 0.1.0-alpha.7 → 0.1.0-beta.2

package/dist/host-testbed.js

@@ -1,547 +1 @@
-import { validateExternalUrl } from '@kumwe/studio-core';
-import { STUDIO_CONTRACT_VERSION, STUDIO_WIRE_PROTOCOL_VERSION, } from '@kumwe/studio-protocol';
-export class TestbedHostError extends Error {
-    error;
-    constructor(error) {
-        super(error.message.defaultMessage ?? error.message.key);
-        this.name = 'TestbedHostError';
-        this.error = error;
-    }
-}
-export function createHostRequestContextFixture(options = {}) {
-    return {
-        ...(options.expectedRevision === undefined
-            ? {}
-            : { expectedRevision: options.expectedRevision }),
-        ...(options.idempotencyKey === undefined ? {} : { idempotencyKey: options.idempotencyKey }),
-        ...(options.locale === undefined ? {} : { locale: options.locale }),
-        operationId: options.operationId ?? 'studio.test/operation',
-        protocolVersion: options.protocolVersion ?? STUDIO_WIRE_PROTOCOL_VERSION,
-        requestId: options.requestId ?? 'requests/test-1',
-        resourceContextKey: options.resourceContextKey ?? 'contexts/test',
-        sessionGeneration: options.sessionGeneration ?? 'session-r1',
-    };
-}
-/**
- * The permissions this reference host gates artifact mutations behind. A host
- * chooses its own names; what the contract fixes is that a mutation is
- * authorized and that a withheld permission is refused as `forbidden`.
- */
-const SAVE_PERMISSION = 'studio.permission/save';
-const PUBLISH_PERMISSION = 'studio.permission/publish';
-/** Deterministic bounds the reference host authorizes uploads within. */
-const UPLOAD_CHUNK_BYTES = 5_242_880;
-const UPLOAD_MAXIMUM_BYTES = 52_428_800;
-const GRANT_EXPIRY = '2030-01-01T00:00:00Z';
-export function createTestbedHost(options = {}) {
-    const artifactStore = new Map();
-    for (const seeded of options.documents ?? []) {
-        const document = cloneValue(seeded);
-        const revision = `${document.id}-r1`;
-        document.revision = revision;
-        artifactStore.set(document.id, { document, revision, serial: 1 });
-    }
-    const mediaAssets = cloneValue(options.mediaAssets ?? []);
-    const resources = cloneValue(options.resources ?? []);
-    const messageBundles = new Map(Object.entries(cloneValue(options.messages ?? {})));
-    const recoveryStore = new Map();
-    const telemetryEvents = [];
-    const injectedFailures = [];
-    const renderCallback = options.render ?? defaultRender;
-    const uploadGrants = new Map();
-    const acceptedUploads = new Map();
-    let uploadSerial = 0;
-    let permissions = (options.permissions ?? []).slice();
-    let generationSerial = 1;
-    let connected = true;
-    let correlationSerial = 0;
-    let importSerial = 0;
-    function currentGeneration() {
-        return `session-r${generationSerial}`;
-    }
-    function createError(category, defaultMessage, extras = {}) {
-        correlationSerial += 1;
-        return {
-            category,
-            contractVersion: STUDIO_CONTRACT_VERSION,
-            correlationId: `testbed-correlation-${correlationSerial}`,
-            kind: 'host-error',
-            message: { defaultMessage, key: `studio.testbed/${category}` },
-            retryable: extras.retryable ?? (category === 'rate-limited' || category === 'unavailable'),
-            ...(extras.revision === undefined ? {} : { revision: extras.revision }),
-        };
-    }
-    function fail(category, defaultMessage, extras = {}) {
-        throw new TestbedHostError(createError(category, defaultMessage, extras));
-    }
-    function guard(portName, operation, context) {
-        if (!connected) {
-            fail('unavailable', 'The testbed host is disconnected.');
-        }
-        const index = injectedFailures.findIndex((entry) => entry.portName === portName && entry.operation === operation);
-        if (index >= 0) {
-            const injected = injectedFailures[index];
-            injectedFailures.splice(index, 1);
-            if (injected !== undefined) {
-                fail(injected.category, 'The testbed injected this failure.');
-            }
-        }
-        if (!isNonEmptyString(context.requestId) ||
-            !isNonEmptyString(context.operationId) ||
-            !isNonEmptyString(context.resourceContextKey) ||
-            !isNonEmptyString(context.sessionGeneration)) {
-            fail('invalid-request', 'The request context is structurally invalid.');
-        }
-        if (context.protocolVersion !== STUDIO_WIRE_PROTOCOL_VERSION) {
-            fail('incompatible', 'The request protocol version is not supported by this testbed.');
-        }
-        if (context.sessionGeneration !== currentGeneration()) {
-            fail('invalid-request', 'The session generation is no longer valid.');
-        }
-    }
-    function run(portName, operation, context, body) {
-        try {
-            guard(portName, operation, context);
-            return Promise.resolve(body());
-        }
-        catch (error) {
-            if (error instanceof TestbedHostError) {
-                return Promise.reject(error);
-            }
-            return Promise.reject(new TestbedHostError(createError('internal', 'The testbed operation failed unexpectedly.')));
-        }
-    }
-    /**
-     * The authorization gate a production host applies to every mutation. Reads
-     * are authorized by the resolved request context; mutations additionally
-     * require the host-declared permission for the operation, and a withheld
-     * permission is refused without disclosing whether the artifact exists.
-     */
-    function requireArtifactPermission(permission) {
-        if (!permissions.includes(permission)) {
-            fail('forbidden', 'The session does not hold the permission this operation requires.');
-        }
-    }
-    function requireStored(id) {
-        const stored = artifactStore.get(id);
-        if (stored === undefined) {
-            fail('not-found', 'The requested artifact is not available.');
-        }
-        return stored;
-    }
-    function ensureExpectedRevision(stored, context) {
-        if (context.expectedRevision !== stored.revision) {
-            fail('conflict', 'The stored artifact revision differs from the expected revision.', {
-                revision: stored.revision,
-            });
-        }
-    }
-    function advanceRevision(stored) {
-        stored.serial += 1;
-        stored.revision = `${stored.document.id}-r${stored.serial}`;
-        stored.document.revision = stored.revision;
-        return stored.revision;
-    }
-    function setStatus(id, context, status) {
-        requireArtifactPermission(PUBLISH_PERMISSION);
-        const stored = requireStored(id);
-        ensureExpectedRevision(stored, context);
-        stored.document.status = status;
-        return { revision: advanceRevision(stored), value: null };
-    }
-    function resolveStart(cursor) {
-        if (cursor === undefined) {
-            return 0;
-        }
-        const start = decodeCursor(cursor);
-        if (start === undefined) {
-            fail('invalid-request', 'The pagination cursor is not valid.');
-        }
-        return start;
-    }
-    function ensureLimit(limit) {
-        if (!Number.isSafeInteger(limit) || limit < 1 || limit > 100) {
-            fail('invalid-request', 'The limit must be an integer between 1 and 100.');
-        }
-    }
-    const host = {
-        artifact: {
-            dependencies(reference, context) {
-                return run('artifact', 'dependencies', context, () => ({ value: [] }));
-            },
-            load(reference, context) {
-                return run('artifact', 'load', context, () => {
-                    const stored = requireStored(reference.id);
-                    return { revision: stored.revision, value: cloneValue(stored.document) };
-                });
-            },
-            publish(reference, context) {
-                return run('artifact', 'publish', context, () => setStatus(reference.id, context, 'published'));
-            },
-            save(document, context) {
-                return run('artifact', 'save', context, () => {
-                    requireArtifactPermission(SAVE_PERMISSION);
-                    const stored = requireStored(document.id);
-                    ensureExpectedRevision(stored, context);
-                    stored.document = cloneValue(document);
-                    return { revision: advanceRevision(stored), value: null };
-                });
-            },
-            unpublish(reference, context) {
-                return run('artifact', 'unpublish', context, () => setStatus(reference.id, context, 'draft'));
-            },
-        },
-        localization: {
-            messages(locale, namespaces, context) {
-                return run('localization', 'messages', context, () => {
-                    const bundle = messageBundles.get(locale);
-                    if (bundle === undefined) {
-                        fail('not-found', 'The requested locale is not available.');
-                    }
-                    const value = {};
-                    for (const [key, message] of Object.entries(bundle)) {
-                        const qualifiedKey = key;
-                        if (namespaces.some((namespace) => qualifiedKey === namespace || qualifiedKey.startsWith(`${namespace}.`))) {
-                            value[qualifiedKey] = message;
-                        }
-                    }
-                    return { value };
-                });
-            },
-        },
-        media: {
-            abortUpload(uploadId, context) {
-                return run('media', 'abort-upload', context, () => {
-                    if (!uploadGrants.delete(uploadId)) {
-                        fail('not-found', 'The requested upload is not available.');
-                    }
-                    return { value: null };
-                });
-            },
-            authorizeUpload(request, context) {
-                return run('media', 'authorize-upload', context, () => {
-                    assertUploadRequest(request);
-                    uploadSerial += 1;
-                    const uploadId = `uploads/testbed-${String(uploadSerial)}`;
-                    const grant = {
-                        expiresAt: GRANT_EXPIRY,
-                        headers: { 'X-Upload-Session': uploadId },
-                        method: 'PUT',
-                        plan: {
-                            chunkBytes: UPLOAD_CHUNK_BYTES,
-                            maximumBytes: UPLOAD_MAXIMUM_BYTES,
-                            resumable: true,
-                        },
-                        uploadId,
-                        url: `https://uploads.testbed.invalid/${uploadId}`,
-                    };
-                    uploadGrants.set(uploadId, { grant, request: cloneValue(request) });
-                    return { value: cloneValue(grant) };
-                });
-            },
-            completeUpload(uploadId, context) {
-                return run('media', 'complete-upload', context, () => {
-                    const pending = uploadGrants.get(uploadId);
-                    if (pending === undefined) {
-                        fail('not-found', 'The requested upload is not available.');
-                    }
-                    uploadGrants.delete(uploadId);
-                    // The host verifies what it received; a declared media type is
-                    // never trusted, so acceptance lands in `processing`.
-                    const accepted = {
-                        id: `assets/${uploadId.replace('uploads/', '')}`,
-                        revision: `${uploadId}-r1`,
-                        state: 'processing',
-                    };
-                    acceptedUploads.set(accepted.id, accepted);
-                    return { revision: accepted.revision, value: cloneValue(accepted) };
-                });
-            },
-            get(assetId, context) {
-                return run('media', 'get', context, () => {
-                    const asset = mediaAssets.find((entry) => entry.id === assetId);
-                    const result = asset === undefined
-                        ? { value: null }
-                        : { revision: asset.revision, value: cloneValue(asset) };
-                    return result;
-                });
-            },
-            list(query, context) {
-                return run('media', 'list', context, () => {
-                    ensureLimit(query.limit);
-                    const search = query.search?.toLowerCase();
-                    const filtered = mediaAssets.filter((asset) => {
-                        if (query.mediaTypes !== undefined && !query.mediaTypes.includes(asset.mediaType)) {
-                            return false;
-                        }
-                        return search === undefined || asset.filename.toLowerCase().includes(search);
-                    });
-                    const start = resolveStart(query.cursor);
-                    const nextIndex = start + query.limit;
-                    return {
-                        value: {
-                            assets: cloneValue(filtered.slice(start, nextIndex)),
-                            ...(nextIndex < filtered.length ? { nextCursor: encodeCursor(nextIndex) } : {}),
-                        },
-                    };
-                });
-            },
-            importExternal(url, context) {
-                return run('media', 'import-external', context, () => {
-                    const verdict = validateExternalUrl(url);
-                    if (!verdict.ok) {
-                        // The stable reason is disclosed; the candidate never is.
-                        fail('validation-failed', `The external media candidate was refused: ${verdict.reason}.`);
-                    }
-                    importSerial += 1;
-                    const accepted = {
-                        id: `assets/imported-${String(importSerial)}`,
-                        revision: `imports/testbed-${String(importSerial)}-r1`,
-                        state: 'processing',
-                    };
-                    acceptedUploads.set(accepted.id, accepted);
-                    return { revision: accepted.revision, value: cloneValue(accepted) };
-                });
-            },
-            uploadStatus(assetId, context) {
-                return run('media', 'upload-status', context, () => {
-                    const accepted = acceptedUploads.get(assetId);
-                    if (accepted === undefined) {
-                        fail('not-found', 'The requested asset is not available.');
-                    }
-                    return { revision: accepted.revision, value: cloneValue(accepted) };
-                });
-            },
-        },
-        permission: {
-            explain(operation, context) {
-                return run('permission', 'explain', context, () => {
-                    const explanation = permissions.includes(operation)
-                        ? { allowed: true }
-                        : {
-                            allowed: false,
-                            reason: {
-                                defaultMessage: 'The session does not hold this permission.',
-                                key: 'studio.testbed/permission-denied',
-                            },
-                        };
-                    return { value: explanation };
-                });
-            },
-            refresh(context) {
-                return run('permission', 'refresh', context, () => ({
-                    value: { permissions: permissions.slice(), sessionGeneration: currentGeneration() },
-                }));
-            },
-        },
-        preview: {
-            cancel(draftDigest, context) {
-                return run('preview', 'cancel', context, () => ({ value: null }));
-            },
-            render(payload, context) {
-                return run('preview', 'render', context, () => ({
-                    value: cloneValue(renderCallback(cloneValue(payload))),
-                }));
-            },
-        },
-        recovery: {
-            discard(context) {
-                return run('recovery', 'discard', context, () => {
-                    recoveryStore.delete(context.resourceContextKey);
-                    return { value: null };
-                });
-            },
-            load(context) {
-                return run('recovery', 'load', context, () => {
-                    const envelope = recoveryStore.get(context.resourceContextKey);
-                    const result = envelope === undefined ? { value: null } : { value: cloneValue(envelope) };
-                    return result;
-                });
-            },
-            store(envelope, context) {
-                return run('recovery', 'store', context, () => {
-                    recoveryStore.set(context.resourceContextKey, cloneValue(envelope));
-                    return { value: null };
-                });
-            },
-        },
-        resource: {
-            search(query, context) {
-                return run('resource', 'search', context, () => {
-                    ensureLimit(query.limit);
-                    const search = query.search?.toLowerCase();
-                    const filtered = resources.filter((hit) => {
-                        if (hit.resourceType !== query.resourceType) {
-                            return false;
-                        }
-                        return (search === undefined ||
-                            (hit.label.defaultMessage?.toLowerCase().includes(search) ?? false));
-                    });
-                    const start = resolveStart(query.cursor);
-                    const nextIndex = start + query.limit;
-                    return {
-                        value: {
-                            items: cloneValue(filtered.slice(start, nextIndex)),
-                            ...(nextIndex < filtered.length ? { nextCursor: encodeCursor(nextIndex) } : {}),
-                        },
-                    };
-                });
-            },
-        },
-        telemetry: {
-            emit(event, context) {
-                return run('telemetry', 'emit', context, () => {
-                    if (event.attributes !== undefined) {
-                        for (const attribute of Object.values(event.attributes)) {
-                            if (!isJsonPrimitiveValue(attribute)) {
-                                fail('invalid-request', 'Telemetry attribute values must be JSON primitives.');
-                            }
-                        }
-                    }
-                    telemetryEvents.push(cloneValue(event));
-                    return { value: null };
-                });
-            },
-        },
-    };
-    const controls = {
-        disconnect() {
-            connected = false;
-        },
-        failNext(portName, operation, category) {
-            injectedFailures.push({ category, operation, portName });
-        },
-        importExternalMedia(candidate, context) {
-            return run('media', 'import-external', context, () => {
-                const verdict = validateExternalUrl(candidate);
-                if (!verdict.ok) {
-                    fail('validation-failed', `The external media source is not allowed by the URL policy (${verdict.reason}).`);
-                }
-                importSerial += 1;
-                const id = `media/import-${importSerial}`;
-                const revision = `${id}-r1`;
-                mediaAssets.push({
-                    byteSize: 0,
-                    contractVersion: STUDIO_CONTRACT_VERSION,
-                    filename: `import-${importSerial}`,
-                    id,
-                    kind: 'media-asset',
-                    mediaKind: 'other',
-                    mediaType: 'application/octet-stream',
-                    metadata: {},
-                    revision,
-                    state: 'processing',
-                });
-                return { revision, value: { id, revision, state: 'processing' } };
-            });
-        },
-        reconnect() {
-            connected = true;
-        },
-        revisionOf(id) {
-            return artifactStore.get(id)?.revision;
-        },
-        get sessionGeneration() {
-            return currentGeneration();
-        },
-        setPermissions(next) {
-            permissions = next.slice();
-            generationSerial += 1;
-        },
-        get telemetryEvents() {
-            return cloneValue(telemetryEvents);
-        },
-    };
-    return { controls, host };
-}
-function defaultRender(payload) {
-    return { diagnostics: [], draftDigest: payload.draftDigest, markers: [] };
-}
-function isNonEmptyString(value) {
-    return typeof value === 'string' && value.length > 0;
-}
-function isJsonPrimitiveValue(value) {
-    return (value === null ||
-        typeof value === 'boolean' ||
-        typeof value === 'string' ||
-        (typeof value === 'number' && Number.isFinite(value)));
-}
-const CURSOR_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
-function encodeCursor(index) {
-    const text = `index:${index}`;
-    let encoded = '';
-    for (let position = 0; position < text.length; position += 3) {
-        const first = text.charCodeAt(position);
-        const second = position + 1 < text.length ? text.charCodeAt(position + 1) : undefined;
-        const third = position + 2 < text.length ? text.charCodeAt(position + 2) : undefined;
-        const chunk = (first << 16) | ((second ?? 0) << 8) | (third ?? 0);
-        encoded += CURSOR_ALPHABET.charAt((chunk >> 18) & 0x3f);
-        encoded += CURSOR_ALPHABET.charAt((chunk >> 12) & 0x3f);
-        encoded += second === undefined ? '=' : CURSOR_ALPHABET.charAt((chunk >> 6) & 0x3f);
-        encoded += third === undefined ? '=' : CURSOR_ALPHABET.charAt(chunk & 0x3f);
-    }
-    return encoded;
-}
-function decodeCursor(cursor) {
-    if (cursor.length === 0 || cursor.length % 4 !== 0) {
-        return undefined;
-    }
-    const paddingLength = cursor.endsWith('==') ? 2 : cursor.endsWith('=') ? 1 : 0;
-    const body = cursor.slice(0, cursor.length - paddingLength);
-    let bits = 0;
-    let bitCount = 0;
-    let text = '';
-    for (const character of body) {
-        const sextet = CURSOR_ALPHABET.indexOf(character);
-        if (sextet < 0) {
-            return undefined;
-        }
-        bits = (bits << 6) | sextet;
-        bitCount += 6;
-        if (bitCount >= 8) {
-            bitCount -= 8;
-            text += String.fromCharCode((bits >> bitCount) & 0xff);
-        }
-    }
-    const match = /^index:(0|[1-9][0-9]*)$/u.exec(text);
-    const digits = match?.[1];
-    if (digits === undefined || digits.length > 9) {
-        return undefined;
-    }
-    return Number(digits);
-}
-function cloneValue(value) {
-    return JSON.parse(JSON.stringify(value));
-}
-/**
- * The policy gate that runs before any byte moves: a declared upload larger
- * than the host's bound, or one carrying a filename the canonical shape
- * refuses, is rejected at authorization rather than after a transfer.
- */
-function assertUploadRequest(request) {
-    if (request.byteSize > UPLOAD_MAXIMUM_BYTES) {
-        throw new TestbedHostError({
-            category: 'limit-exceeded',
-            contractVersion: STUDIO_CONTRACT_VERSION,
-            kind: 'host-error',
-            message: {
-                defaultMessage: 'The declared upload exceeds the accepted size.',
-                key: 'studio.testbed/limit-exceeded',
-            },
-            retryable: false,
-        });
-    }
-    if (request.filename.includes('/') || request.filename.includes('\\')) {
-        throw new TestbedHostError({
-            category: 'validation-failed',
-            contractVersion: STUDIO_CONTRACT_VERSION,
-            kind: 'host-error',
-            message: {
-                defaultMessage: 'The declared filename is not a canonical display name.',
-                key: 'studio.testbed/validation-failed',
-            },
-            retryable: false,
-        });
-    }
-}
-//# sourceMappingURL=host-testbed.js.map
+import{canonicalStringify as e,validateExternalUrl as t}from"@kumwe/studio-core";import{HostPortFailure as n,STUDIO_CONTRACT_VERSION as r,STUDIO_STALE_SESSION_GENERATION_DIAGNOSTIC_CODE as i,STUDIO_WIRE_PROTOCOL_VERSION as a}from"@kumwe/studio-protocol";export class TestbedHostError extends n{constructor(e){super(e),this.name=`TestbedHostError`}}export function createHostRequestContextFixture(e={}){return{...e.expectedRevision===void 0?{}:{expectedRevision:e.expectedRevision},...e.idempotencyKey===void 0?{}:{idempotencyKey:e.idempotencyKey},...e.locale===void 0?{}:{locale:e.locale},operationId:e.operationId??`studio.test/operation`,protocolVersion:e.protocolVersion??a,requestId:e.requestId??`requests/test-1`,resourceContextKey:e.resourceContextKey??`contexts/test`,sessionGeneration:e.sessionGeneration??`session-r1`}}const c=52428800;export function createTestbedHost(n={}){let s=new Map;for(let e of n.documents??[]){let t=m(e);if(s.has(t.id))throw TypeError(`Testbed artifact ${t.id} is duplicated.`);let n=t.revision;s.set(t.id,{document:t,revision:n,serial:te(t.id,n)})}let l=m(n.mediaAssets??[]),f=m(n.resources??[]),_=m(n.authoring?.targets??[]),v=m(n.authoring?.types??[]),y=m(n.authoring?.starts??[]),b=m(n.authoring?.plans??[]),x=m(n.authoring?.saves??[]),S=[];g(`target`,_.map(e=>e.request)),g(`start`,y.map(e=>e.request)),g(`plan`,b.map(e=>e.intent)),g(`save`,x.map(e=>e.request)),g(`type`,v.map(e=>({reference:e.definition,resourceContextKey:e.resourceContextKey,targetId:e.targetId})));let ae=new Map(Object.entries(m(n.messages??{}))),C=new Map,oe=[],w=[],se=n.render??u,T=new Map,E=new Map,D=[],O=new Map,k=new Map;for(let e of n.rateLimits??[]){if(!Number.isSafeInteger(e.maximumRequests)||e.maximumRequests<1||e.maximumRequests>1e3||!Number.isSafeInteger(e.windowMilliseconds)||e.windowMilliseconds<1||e.windowMilliseconds>864e5)throw RangeError(`Testbed rate limits require positive safe-integer bounds.`);if(O.has(e.operationId))throw TypeError(`Testbed rate limit ${e.operationId} is duplicated.`);O.set(e.operationId,{...e})}let A=new Map,j=new Map,M=0,N=(n.permissions??[]).slice(),P=n.sessionGeneration??`session-r1`;if(!d(P)||P.length>200)throw TypeError(`The testbed session generation must be a non-empty bounded revision.`);let F=te(`session`,P),I=!0,L=0,R=0,z=n.initialClockMilliseconds??0;if(!Number.isSafeInteger(z)||z<0)throw RangeError(`The testbed logical clock must be a non-negative safe integer.`);function B(){return P}function V(e,t,n={}){return L+=1,{category:e,contractVersion:r,correlationId:`testbed-correlation-${L}`,kind:`host-error`,message:{defaultMessage:t,key:`studio.testbed/${e}`},retryable:n.retryable??(e===`rate-limited`||e===`unavailable`),...n.diagnostics===void 0?{}:{diagnostics:m(n.diagnostics)},...n.retryAfterMilliseconds===void 0?{}:{retryAfterMilliseconds:n.retryAfterMilliseconds},...n.revision===void 0?{}:{revision:n.revision}}}function H(e,t,n={}){throw new TestbedHostError(V(e,t,n))}function U(e,t,r){I||H(`unavailable`,`The testbed host is disconnected.`),(!d(r.requestId)||!d(r.operationId)||!d(r.resourceContextKey)||!d(r.sessionGeneration))&&H(`invalid-request`,`The request context is structurally invalid.`),r.protocolVersion!==a&&H(`incompatible`,`The request protocol version is not supported by this testbed.`),r.sessionGeneration!==B()&&H(`invalid-request`,`The session generation is no longer valid.`,{diagnostics:[{code:i,message:{defaultMessage:`The request belongs to an obsolete Studio session generation.`,key:i},severity:`blocking`}]});let o=`studio.operation/${e}.${t}`;r.operationId!==o&&(n.allowTestOperationId!==!0||r.operationId!==`studio.test/operation`)&&H(`invalid-request`,`The request operation identifier does not match the invoked port.`)}function W(e,t,n){let r=w.findIndex(n=>n.portName===e&&n.operation===t);if(r>=0){let e=w[r];w.splice(r,1),e!==void 0&&H(e.category,`The testbed injected this failure.`)}let i=O.get(n.operationId);if(i===void 0)return;let a=k.get(n.operationId);(a===void 0||z>=a.startedAtMilliseconds+i.windowMilliseconds)&&(a={requestCount:0,startedAtMilliseconds:z},k.set(n.operationId,a)),a.requestCount>=i.maximumRequests&&H(`rate-limited`,`The operation has reached its deterministic request bound.`,{retryAfterMilliseconds:a.startedAtMilliseconds+i.windowMilliseconds-z}),a.requestCount+=1}async function G(e){try{return await e()}catch(e){throw e instanceof TestbedHostError?e:new TestbedHostError(V(`internal`,`The testbed operation failed unexpectedly.`))}}function K(e,t,n,r){try{return U(e,t,n),W(e,t,n),G(r)}catch(e){return G(()=>{throw e})}}function q(t,n,r,i,a){try{U(t,n,i);let o=i.idempotencyKey;if(o===void 0)return W(t,n,i),G(a);let s=e({idempotencyKey:o,operationId:i.operationId,resourceContextKey:i.resourceContextKey,sessionGeneration:i.sessionGeneration}),c=e({argument:r,context:{...i.expectedRevision===void 0?{}:{expectedRevision:i.expectedRevision},...i.locale===void 0?{}:{locale:i.locale},protocolVersion:i.protocolVersion}}),l=T.get(s);if(l!==void 0)return l.fingerprint!==c&&H(`invalid-request`,`The idempotency key was already accepted for another intent.`),l.promise.then(e=>m(e));W(t,n,i);let u=G(a).then(e=>m(e));return T.set(s,{fingerprint:c,promise:u}),u.catch(()=>{T.get(s)?.promise===u&&T.delete(s)}),u.then(e=>m(e))}catch(e){return G(()=>{throw e})}}function ce(e){N.includes(e)||H(`forbidden`,`The session does not hold the permission this operation requires.`)}function J(e){let t=s.get(e);return t===void 0&&H(`not-found`,`The requested artifact is not available.`),t}function le(e,t){t.expectedRevision!==e.revision&&H(`conflict`,`The stored artifact revision differs from the expected revision.`,{revision:e.revision})}function ue(e){return e.serial+=1,e.revision=`${e.document.id}-r${e.serial}`,e.document.revision=e.revision,e.revision}function de(e,t,n){ce(`studio.permission/publish`);let r=J(e);return le(r,t),r.document.status=n,{revision:ue(r),value:null}}function Y(e){if(e===void 0)return 0;let t=re(e);return t===void 0&&H(`invalid-request`,`The pagination cursor is not valid.`),t}function X(e){(!Number.isSafeInteger(e)||e<1||e>100)&&H(`invalid-request`,`The limit must be an integer between 1 and 100.`)}function Z(e,t){S.push({argument:m(t),operation:e})}function Q(e,t){e!==t.resourceContextKey&&H(`invalid-request`,`The contextual authoring request does not match the authoritative resource context.`)}function $(t,n,r){let i=e(n),a=t.find(t=>e(r(t))===i);return a===void 0&&H(`not-found`,`The requested contextual authoring fixture is not available.`),a}return{controls:{advanceClock(e){if(!Number.isSafeInteger(e)||e<0)throw RangeError(`Testbed clock advances must be non-negative safe integers.`);let t=z+e;if(!Number.isSafeInteger(t))throw RangeError(`The testbed logical clock cannot exceed the safe-integer bound.`);z=t},get authoringOperations(){return m(S)},artifactStatus(e){return s.get(e)?.document.status},disconnect(){I=!1},failNext(e,t,n){w.push({category:n,operation:t,portName:e})},importExternalMedia(e,n){return K(`media`,`import-external`,n,()=>{let n=t(e);n.ok||H(`validation-failed`,`The external media source is not allowed by the URL policy (${n.reason}).`),R+=1;let i=`media/import-${R}`,a=`${i}-r1`;return l.push({byteSize:0,contractVersion:r,filename:`import-${R}`,id:i,kind:`media-asset`,mediaKind:`other`,mediaType:`application/octet-stream`,metadata:{},revision:a,state:`processing`}),{revision:a,value:{id:i,revision:a,state:`processing`}}})},reconnect(){I=!0},recoveryEnvelope(e){let t=C.get(e);return t===void 0?void 0:m(t)},revisionOf(e){return s.get(e)?.revision},get pendingPreviewRenders(){return E.size},get previewDeliveries(){return D.slice()},get sessionGeneration(){return B()},setPermissions(e){N=e.slice(),F+=1,P=`session-r${F}`},get telemetryEvents(){return m(oe)}},host:{artifact:{dependencies(e,t){return K(`artifact`,`dependencies`,t,()=>({value:[]}))},load(e,t){return K(`artifact`,`load`,t,()=>{let t=J(e.id);return{revision:t.revision,value:m(t.document)}})},publish(e,t){return q(`artifact`,`publish`,e,t,()=>de(e.id,t,`published`))},save(e,t){return q(`artifact`,`save`,e,t,()=>{ce(`studio.permission/save`);let n=J(e.id);return le(n,t),n.document=m(e),{revision:ue(n),value:null}})},unpublish(e,t){return q(`artifact`,`unpublish`,e,t,()=>de(e.id,t,`draft`))}},authoring:{listTypes(e,t){return K(`authoring`,`list-types`,t,()=>{Q(e.resourceContext.key,t),X(e.limit),Z(`list-types`,e);let n=e.search?.toLowerCase(),r=v.filter(r=>r.targetId===e.targetId&&r.resourceContextKey===t.resourceContextKey&&(n===void 0||r.definition.id.toLowerCase().includes(n)||(r.definition.label.defaultMessage?.toLowerCase().includes(n)??!1))).sort((e,t)=>h(e.definition.id,t.definition.id)||h(e.definition.version,t.definition.version)||h(e.definition.revision,t.definition.revision)),i=Y(e.cursor),a=i+e.limit;return{value:{items:r.slice(i,a).map(({definition:e})=>({blueprint:m(e.blueprint),label:m(e.label),model:m(e.model),reference:{id:e.id,revision:e.revision,version:e.version}})),...a<r.length?{nextCursor:p(a)}:{}}}})},planSave(e,t){return K(`authoring`,`plan-save`,t,()=>{let n=$(b,e,e=>e.intent);return Q(n.resourceContextKey,t),Z(`plan-save`,e),{value:m(n.plan)}})},resolveTarget(e,t){return K(`authoring`,`resolve-target`,t,()=>(Q(e.resourceContext.key,t),Z(`resolve-target`,e),{value:m($(_,e,e=>e.request).resolution)}))},saveAsNewType(e,t){return q(`authoring`,`save-as-new-type`,e,t,()=>{let n=$(x,e,e=>e.request);return n.request.kind!==`authoring-save-as-new-type-request`&&H(`not-found`,`The requested contextual save fixture is not available.`),Q(n.resourceContextKey,t),Z(`save-as-new-type`,e),{value:m(n.result)}})},saveItem(e,t){return q(`authoring`,`save-item`,e,t,()=>{let n=$(x,e,e=>e.request);return n.request.kind!==`authoring-save-item-request`&&H(`not-found`,`The requested contextual save fixture is not available.`),Q(n.resourceContextKey,t),Z(`save-item`,e),{value:m(n.result)}})},saveNewTypeVersion(e,t){return q(`authoring`,`save-new-type-version`,e,t,()=>{let n=$(x,e,e=>e.request);return n.request.kind!==`authoring-save-new-type-version-request`&&H(`not-found`,`The requested contextual save fixture is not available.`),Q(n.resourceContextKey,t),Z(`save-new-type-version`,e),{value:m(n.result)}})},start(e,t){return q(`authoring`,`start`,e,t,()=>(Q(e.resourceContext.key,t),Z(`start`,e),{value:m($(y,e,e=>e.request).session)}))}},localization:{messages(e,t,n){return K(`localization`,`messages`,n,()=>{let n=ae.get(e);n===void 0&&H(`not-found`,`The requested locale is not available.`);let r={};for(let[e,i]of Object.entries(n)){let n=e;t.some(e=>n===e||n.startsWith(`${e}.`))&&(r[n]=i)}return{value:r}})}},media:{abortUpload(e,t){return q(`media`,`abort-upload`,e,t,()=>(A.delete(e)||H(`not-found`,`The requested upload is not available.`),{value:null}))},authorizeUpload(e,t){return q(`media`,`authorize-upload`,e,t,()=>{ie(e),M+=1;let t=`uploads/testbed-${String(M)}`,n={expiresAt:`2030-01-01T00:00:00Z`,headers:{"X-Upload-Session":t},method:`PUT`,plan:{chunkBytes:5242880,maximumBytes:c,resumable:!0},uploadId:t,url:`https://uploads.testbed.invalid/${t}`};return A.set(t,{grant:n,request:m(e)}),{value:m(n)}})},completeUpload(e,t){return q(`media`,`complete-upload`,e,t,()=>{A.get(e)===void 0&&H(`not-found`,`The requested upload is not available.`),A.delete(e);let t={id:`assets/${e.replace(`uploads/`,``)}`,revision:`${e}-r1`,state:`processing`};return j.set(t.id,t),{revision:t.revision,value:m(t)}})},get(e,t){return K(`media`,`get`,t,()=>{let t=l.find(t=>t.id===e);return t===void 0?{value:null}:{revision:t.revision,value:m(t)}})},list(e,t){return K(`media`,`list`,t,()=>{X(e.limit);let t=e.search?.toLowerCase(),n=l.filter(n=>e.mediaTypes!==void 0&&!e.mediaTypes.includes(n.mediaType)?!1:t===void 0||n.filename.toLowerCase().includes(t)),r=Y(e.cursor),i=r+e.limit;return{value:{assets:m(n.slice(r,i)),...i<n.length?{nextCursor:p(i)}:{}}}})},importExternal(e,n){return q(`media`,`import-external`,e,n,()=>{let n=t(e);n.ok||H(`validation-failed`,`The external media candidate was refused: ${n.reason}.`),R+=1;let r={id:`assets/imported-${String(R)}`,revision:`imports/testbed-${String(R)}-r1`,state:`processing`};return j.set(r.id,r),{revision:r.revision,value:m(r)}})},uploadStatus(e,t){return K(`media`,`upload-status`,t,()=>{let t=j.get(e);return t===void 0&&H(`not-found`,`The requested asset is not available.`),{revision:t.revision,value:m(t)}})}},model:{get(e,t){return K(`model`,`get`,t,()=>{let t=J(e.id);return(t.document.kind!==`content-model`||t.document.version!==e.version||`revision`in e&&e.revision!==t.revision)&&H(`not-found`,`The requested model projection is not available.`),{revision:t.revision,value:m(t.document)}})},list(e){return K(`model`,`list`,e,()=>({value:[...s.values()].filter(e=>e.document.kind===`content-model`).map(e=>m(e.document)).sort((e,t)=>h(e.id,t.id)||h(e.version,t.version)||h(e.revision,t.revision))}))}},permission:{explain(e,t){return K(`permission`,`explain`,t,()=>({value:N.includes(e)?{allowed:!0}:{allowed:!1,reason:{defaultMessage:`The session does not hold this permission.`,key:`studio.testbed/permission-denied`}}}))},refresh(e){return K(`permission`,`refresh`,e,()=>({value:{permissions:N.slice(),sessionGeneration:B()}}))}},preview:{cancel(e,t){return K(`preview`,`cancel`,t,()=>(E.get(ee(e,t))?.cancel(),{value:null}))},render(e,t){return K(`preview`,`render`,t,async()=>{let n=ee(e.draftDigest,t);E.has(n)&&H(`invalid-request`,`A render for this draft is already in flight.`);let r=()=>void 0,i=new Promise((e,t)=>{r=()=>{t(new TestbedHostError(V(`cancelled`,`The in-flight preview render was cancelled.`,{retryable:!1})))}});E.set(n,{cancel:r});try{let t=await Promise.race([Promise.resolve(se(m(e))),i]);return(t.draftDigest!==e.draftDigest||t.requestId!==e.requestId)&&H(`internal`,`The preview renderer returned a result for a different render attempt.`),D.push(e.draftDigest),{value:m(t)}}finally{E.delete(n)}})}},recovery:{discard(e){return q(`recovery`,`discard`,null,e,()=>(C.delete(e.resourceContextKey),{value:null}))},load(e){return K(`recovery`,`load`,e,()=>{let t=C.get(e.resourceContextKey);return t===void 0?{value:null}:{value:m(t)}})},store(e,t){return q(`recovery`,`store`,e,t,()=>(C.set(t.resourceContextKey,m(e)),{value:null}))}},resource:{search(e,t){return K(`resource`,`search`,t,()=>{X(e.limit);let t=e.search?.toLowerCase(),n=f.filter(n=>n.resourceType===e.resourceType?t===void 0||(n.label.defaultMessage?.toLowerCase().includes(t)??!1):!1),r=Y(e.cursor),i=r+e.limit;return{value:{items:m(n.slice(r,i)),...i<n.length?{nextCursor:p(i)}:{}}}})}},telemetry:{emit(e,t){return q(`telemetry`,`emit`,e,t,()=>{if(e.attributes!==void 0)for(let t of Object.values(e.attributes))ne(t)||H(`invalid-request`,`Telemetry attribute values must be JSON primitives.`);return oe.push(m(e)),{value:null}})}}}}}function u(e){return{diagnostics:[],draftDigest:e.draftDigest,markerMap:{},markers:[],requestId:e.requestId}}function ee(e,t){return`${t.sessionGeneration}\u0000${t.resourceContextKey}\u0000${e}`}function te(e,t){let n=`${e}-r`;if(!t.startsWith(n))return 0;let r=t.slice(n.length),i=Number(r);return Number.isSafeInteger(i)&&i>=0&&String(i)===r?i:0}function d(e){return typeof e==`string`&&e.length>0}function ne(e){return e===null||typeof e==`boolean`||typeof e==`string`||typeof e==`number`&&Number.isFinite(e)}const f=`ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/`;function p(e){let t=`index:${e}`,n=``;for(let e=0;e<t.length;e+=3){let r=t.charCodeAt(e),i=e+1<t.length?t.charCodeAt(e+1):void 0,a=e+2<t.length?t.charCodeAt(e+2):void 0,o=r<<16|(i??0)<<8|(a??0);n+=f.charAt(o>>18&63),n+=f.charAt(o>>12&63),n+=i===void 0?`=`:f.charAt(o>>6&63),n+=a===void 0?`=`:f.charAt(o&63)}return n}function re(e){if(e.length===0||e.length%4!=0)return;let t=e.endsWith(`==`)?2:+!!e.endsWith(`=`),n=e.slice(0,e.length-t),r=0,i=0,a=``;for(let e of n){let t=f.indexOf(e);if(t<0)return;r=r<<6|t,i+=6,i>=8&&(i-=8,a+=String.fromCharCode(r>>i&255))}let o=/^index:(0|[1-9][0-9]*)$/u.exec(a)?.[1];if(!(o===void 0||o.length>9))return Number(o)}function m(e){return JSON.parse(JSON.stringify(e))}function h(e,t){return e<t?-1:+(e>t)}function g(t,n){let r=new Set;for(let i of n){let n=e(i);if(r.has(n))throw TypeError(`Testbed contextual authoring ${t} fixture is duplicated.`);r.add(n)}}function ie(e){if(e.byteSize>c)throw new TestbedHostError({category:`limit-exceeded`,contractVersion:r,kind:`host-error`,message:{defaultMessage:`The declared upload exceeds the accepted size.`,key:`studio.testbed/limit-exceeded`},retryable:!1});if(e.filename.includes(`/`)||e.filename.includes(`\\`))throw new TestbedHostError({category:`validation-failed`,contractVersion:r,kind:`host-error`,message:{defaultMessage:`The declared filename is not a canonical display name.`,key:`studio.testbed/validation-failed`},retryable:!1})}

package/dist/http-authoring-contract.d.ts

@@ -0,0 +1,3 @@
+/** Compatibility re-export of the canonical contextual HTTP route binding. */
+export { AUTHORING_HTTP_OPERATIONS, AUTHORING_HTTP_OPERATIONS_BY_ROUTE, AUTHORING_HTTP_SCHEMA_ID, type AuthoringHttpOperationContract, type AuthoringHttpOperationRegistry, type AuthoringHttpRoute, type HttpSchemaValidator, } from '@kumwe/studio-core';
+//# sourceMappingURL=http-authoring-contract.d.ts.map

package/dist/http-authoring-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-authoring-contract.d.ts","sourceRoot":"","sources":["../src/http-authoring-contract.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO,EACL,yBAAyB,EACzB,kCAAkC,EAClC,wBAAwB,EACxB,KAAK,8BAA8B,EACnC,KAAK,8BAA8B,EACnC,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC"}

package/dist/http-authoring-contract.js

@@ -0,0 +1 @@
+export{AUTHORING_HTTP_OPERATIONS,AUTHORING_HTTP_OPERATIONS_BY_ROUTE,AUTHORING_HTTP_SCHEMA_ID}from"@kumwe/studio-core";