@clowder-ai/collective-connector 0.0.0-stage → 0.1.0-alpha.8

package/dist/business/connector/artifact-media-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-media-client.d.ts","sourceRoot":"","sources":["../../../src/business/connector/artifact-media-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EACL,KAAK,gCAAgC,EACrC,KAAK,0BAA0B,EAShC,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAGpF,KAAK,WAAW,GAAG,IAAI,CAAC,0BAA0B,EAAE,mBAAmB,GAAG,cAAc,GAAG,cAAc,CAAC,CAAC;AAC3G,KAAK,WAAW,GAAG,CACjB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,KAC3D,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AACtC,qBAAa,6BAA6B;IAEtC,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,OAAO,KAAK;IAEpC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAMxD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,0BAA0B,EAAE,MAAM,EAAE,WAAW;;;;;;;;;;;;;;IA+C7F,OAAO,CACX,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,gCAAgC,EAC3C,MAAM,EAAE,6BAA6B,EACrC,MAAM,EAAE,WAAW;CA8BtB"}

package/dist/business/connector/artifact-media-client.js

@@ -0,0 +1,98 @@
+import { Readable } from 'node:stream';
+import { collectiveMediaBufferBytes, collectiveMediaDescriptorHeader, collectiveMediaDescriptorSchema, collectiveMediaErrorHeader, collectiveMediaOperationSchema, collectiveMediaReadRequestSchema, collectiveMediaResponseHeaders, collectiveMediaResponseLength, } from '../contracts/index.js';
+import { z } from 'zod';
+import { ConnectorTransportError } from './service-client.js';
+export class CollectiveArtifactMediaClient {
+    json;
+    fetchImpl;
+    constructor(json, fetchImpl) {
+        this.json = json;
+        this.fetchImpl = fetchImpl;
+    }
+    async poll(url, credential, input) {
+        return z
+            .object({ operations: z.array(collectiveMediaOperationSchema).max(2) })
+            .strict()
+            .parse(await this.json(url, '/api/artifacts/media/poll', { method: 'POST', credential, body: input })).operations;
+    }
+    async read(url, credential, unsafe, signal) {
+        const input = collectiveMediaReadRequestSchema.parse(unsafe), controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 12000);
+        timer.unref();
+        let response;
+        try {
+            response = await this.fetchImpl(`${new URL(url).origin}/api/artifacts/media/read`, {
+                method: 'POST',
+                redirect: 'error',
+                headers: { authorization: `Bearer ${credential}`, 'content-type': 'application/json' },
+                body: JSON.stringify(input),
+                signal: AbortSignal.any([signal, controller.signal]),
+            });
+        }
+        catch {
+            throw new ConnectorTransportError('Media owner is unreachable', 503, 'ARTIFACT_OWNER_UNAVAILABLE');
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        if (!response.ok && response.status !== 416)
+            await mediaTransportError(response);
+        try {
+            const encoded = response.headers.get(collectiveMediaDescriptorHeader);
+            if (!encoded || encoded.length > 4096 || !response.body)
+                throw new Error('Missing media descriptor');
+            const descriptor = collectiveMediaDescriptorSchema.parse(JSON.parse(decodeURIComponent(encoded)));
+            if (descriptor.ownerRevision !== input.ownerRevision ||
+                descriptor.status !== response.status ||
+                Object.entries(collectiveMediaResponseHeaders(descriptor)).some(([name, value]) => response.headers.get(name) !== value))
+                throw new Error('Media descriptor mismatch');
+            // Node 20 declarations and DOM declarations model the same WHATWG stream
+            // with different generic variance; the runtime is the Node fetch stream.
+            const body = Readable.fromWeb(response.body, { highWaterMark: collectiveMediaBufferBytes });
+            // Cancellation may arrive before the Host attaches its pipeline. Consumers still observe stream.errored.
+            body.on('error', () => { });
+            body.once('close', () => controller.abort());
+            return { descriptor, body };
+        }
+        catch (error) {
+            await response.body?.cancel().catch(() => { });
+            throw error;
+        }
+    }
+    async respond(url, credential, coordinates, operation, result, signal) {
+        const query = new URLSearchParams({ ...coordinates, relayRef: operation.relayRef });
+        const headers = { authorization: `Bearer ${credential}` };
+        let body;
+        if (result.status === 'ok') {
+            headers[collectiveMediaDescriptorHeader] = encodeURIComponent(JSON.stringify(collectiveMediaDescriptorSchema.parse(result.descriptor)));
+            headers['content-type'] = 'application/octet-stream';
+            headers['content-length'] = String(collectiveMediaResponseLength(result.descriptor));
+            body = Readable.toWeb(result.body, {
+                strategy: { highWaterMark: collectiveMediaBufferBytes, size: (chunk) => chunk.byteLength },
+            });
+        }
+        else {
+            headers[collectiveMediaErrorHeader] = result.error.code;
+            headers['content-length'] = '0';
+        }
+        const init = {
+            method: 'POST',
+            redirect: 'error',
+            headers,
+            signal,
+            duplex: 'half',
+            ...(body ? { body } : {}),
+        };
+        const response = await this.fetchImpl(`${new URL(url).origin}/api/artifacts/media/respond?${query}`, init);
+        if (!response.ok)
+            await mediaTransportError(response);
+        await response.body?.cancel();
+    }
+}
+async function mediaTransportError(response) {
+    const payload = z
+        .object({ error: z.object({ code: z.string(), message: z.string() }) })
+        .safeParse(await response.json().catch(() => null));
+    throw new ConnectorTransportError(payload.success ? payload.data.error.message : 'Media transport failed', response.status, payload.success ? payload.data.error.code : 'ARTIFACT_OWNER_UNAVAILABLE');
+}
+//# sourceMappingURL=artifact-media-client.js.map

package/dist/business/connector/artifact-media-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-media-client.js","sourceRoot":"","sources":["../../../src/business/connector/artifact-media-client.ts"],"names":[],"mappings":"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"}

package/dist/business/connector/artifact-media-owner-port.d.ts

@@ -0,0 +1,17 @@
+import type { Readable } from 'node:stream';
+import type { CollectiveArtifactConstraint, CollectiveArtifactMediaOperation, CollectiveMediaDescriptor } from '../contracts/index.js';
+import type { CollectiveArtifactOwnerResult } from './artifact-owner-client.js';
+export type CollectiveArtifactMediaResult = Extract<CollectiveArtifactOwnerResult, {
+    status: 'error';
+}> | {
+    status: 'ok';
+    descriptor: CollectiveMediaDescriptor;
+    body: Readable;
+};
+/** No bytes cross a JSON owner operation, Channel event, outbox, custody stage or persistent Connector state. */
+export interface CollectiveArtifactMediaReadPort {
+    read(operation: CollectiveArtifactMediaOperation, authority: {
+        reauthorize(): Promise<CollectiveArtifactConstraint>;
+    }, signal: AbortSignal): Promise<CollectiveArtifactMediaResult>;
+}
+//# sourceMappingURL=artifact-media-owner-port.d.ts.map

package/dist/business/connector/artifact-media-owner-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-media-owner-port.d.ts","sourceRoot":"","sources":["../../../src/business/connector/artifact-media-owner-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EACV,4BAA4B,EAC5B,gCAAgC,EAChC,yBAAyB,EAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAEhF,MAAM,MAAM,6BAA6B,GACrC,OAAO,CAAC,6BAA6B,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,GAC3D;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,yBAAyB,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAC5E,iHAAiH;AACjH,MAAM,WAAW,+BAA+B;IAC9C,IAAI,CACF,SAAS,EAAE,gCAAgC,EAC3C,SAAS,EAAE;QAAE,WAAW,IAAI,OAAO,CAAC,4BAA4B,CAAC,CAAA;KAAE,EACnE,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,6BAA6B,CAAC,CAAC;CAC3C"}

package/dist/business/connector/artifact-media-owner-port.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=artifact-media-owner-port.js.map

package/dist/business/connector/artifact-media-owner-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-media-owner-port.js","sourceRoot":"","sources":["../../../src/business/connector/artifact-media-owner-port.ts"],"names":[],"mappings":""}

package/dist/business/connector/artifact-media-relay.d.ts

@@ -0,0 +1,39 @@
+import type { Readable } from 'node:stream';
+import { type CollectiveMediaReadRequest } from '../contracts/index.js';
+import type { CollectiveArtifactMediaReadPort } from './artifact-media-owner-port.js';
+import type { ConnectorPersistence } from './persistence.js';
+import { type CollectiveServiceClient } from './service-client.js';
+/** Tracked streaming jobs release the ordinary authority lock; slow media cannot stop Channel/Work synchronization. */
+export declare class ConnectorArtifactMediaRelay {
+    private readonly persistence;
+    private readonly service;
+    private owner;
+    private readonly jobs;
+    private readonly readers;
+    private readonly polls;
+    private generation;
+    private closed;
+    constructor(persistence: ConnectorPersistence, service: CollectiveServiceClient);
+    setOwner(owner: CollectiveArtifactMediaReadPort | undefined, enabled: boolean): void;
+    stop(): Promise<void>;
+    readAdmission(): () => void;
+    sync(connectionId: string): Promise<void>;
+    prepareRead(connectionId: string, ownerUserId: string, input: Omit<CollectiveMediaReadRequest, 'serviceInstanceId' | 'collectiveId' | 'connectionId'>, signal: AbortSignal, assertAdmission: () => void): () => Promise<{
+        descriptor: {
+            status: 200 | 206 | 416;
+            mediaType: "image/png" | "video/mp4";
+            byteLength: number;
+            contentRef: string;
+            ownerRevision: number;
+            blobDigest: string;
+            ownerReceiptRef: string;
+            start?: number | undefined;
+            end?: number | undefined;
+        };
+        body: Readable;
+    }>;
+    private poll;
+    private deliver;
+    private connection;
+}
+//# sourceMappingURL=artifact-media-relay.d.ts.map

package/dist/business/connector/artifact-media-relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-media-relay.d.ts","sourceRoot":"","sources":["../../../src/business/connector/artifact-media-relay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAEL,KAAK,0BAA0B,EAEhC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,+BAA+B,EAAiC,MAAM,gCAAgC,CAAC;AACrH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,KAAK,uBAAuB,EAA2B,MAAM,qBAAqB,CAAC;AAG5F,uHAAuH;AACvH,qBAAa,2BAA2B;IAWpC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAX1B,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAGjB;IACJ,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IACrE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAC1D,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,MAAM,CAAS;gBAEJ,WAAW,EAAE,oBAAoB,EACjC,OAAO,EAAE,uBAAuB;IAEnD,QAAQ,CAAC,KAAK,EAAE,+BAA+B,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO;IAKvE,IAAI;IAWV,aAAa;IASb,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASzC,WAAW,CACT,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,IAAI,CAAC,0BAA0B,EAAE,mBAAmB,GAAG,cAAc,GAAG,cAAc,CAAC,EAC9F,MAAM,EAAE,WAAW,EACnB,eAAe,EAAE,MAAM,IAAI;;;;;;;;;;;;;;YAyDf,IAAI;YA6BJ,OAAO;IAoDrB,OAAO,CAAC,UAAU;CAMnB"}

package/dist/business/connector/artifact-media-relay.js

@@ -0,0 +1,185 @@
+import { collectiveMediaRelaySlots, } from '../contracts/index.js';
+import { ConnectorTransportError } from './service-client.js';
+import { workCoordinates } from './work-policy-custody.js';
+/** Tracked streaming jobs release the ordinary authority lock; slow media cannot stop Channel/Work synchronization. */
+export class ConnectorArtifactMediaRelay {
+    persistence;
+    service;
+    owner;
+    jobs = new Map();
+    readers = new Map();
+    polls = new Map();
+    generation = 0;
+    closed = false;
+    constructor(persistence, service) {
+        this.persistence = persistence;
+        this.service = service;
+    }
+    setOwner(owner, enabled) {
+        void this.stop();
+        this.owner = owner;
+        this.closed = !enabled;
+    }
+    async stop() {
+        this.closed = true;
+        this.generation++;
+        const readers = [...this.readers];
+        for (const [reader] of readers)
+            reader.abort();
+        for (const job of this.jobs.values())
+            job.controller.abort();
+        await Promise.allSettled([
+            ...readers.map(([, done]) => done),
+            ...[...this.jobs.values()].map((job) => job.promise),
+        ]);
+    }
+    readAdmission() {
+        const generation = this.generation;
+        const assertCurrent = () => {
+            if (this.closed || generation !== this.generation)
+                throw new ConnectorTransportError('Media read admission is stopped', 503, 'ARTIFACT_MEDIA_STOPPED');
+        };
+        assertCurrent();
+        return assertCurrent;
+    }
+    sync(connectionId) {
+        const current = this.polls.get(connectionId);
+        if (current)
+            return current;
+        const job = this.poll(connectionId).finally(() => {
+            if (this.polls.get(connectionId) === job)
+                this.polls.delete(connectionId);
+        });
+        this.polls.set(connectionId, job);
+        return job;
+    }
+    prepareRead(connectionId, ownerUserId, input, signal, assertAdmission) {
+        assertAdmission();
+        const current = () => {
+            const connection = this.connection(connectionId);
+            if (this.persistence.snapshot().hostRoutes[connectionId]?.localOwnerUserId !== ownerUserId)
+                throw new ConnectorTransportError('This Host Human does not own the paired Cafe', 403, 'ARTIFACT_ACCESS_DENIED');
+            return connection;
+        };
+        const initial = current();
+        return async () => {
+            assertAdmission();
+            signal.throwIfAborted();
+            const connection = current();
+            if (connection.endpointCredential !== initial.endpointCredential)
+                throw new ConnectorTransportError('Cafe authority changed', 403, 'ARTIFACT_ACCESS_DENIED');
+            if (this.readers.size >= collectiveMediaRelaySlots)
+                throw new ConnectorTransportError('Media streams are busy', 429, 'ARTIFACT_BUSY');
+            const controller = new AbortController();
+            let finish = () => { };
+            const done = new Promise((resolve) => {
+                finish = resolve;
+            });
+            this.readers.set(controller, done);
+            const release = () => {
+                this.readers.delete(controller);
+                controller.abort();
+                finish();
+            };
+            let body;
+            try {
+                const opened = await this.service.media.read(connection.serviceUrl, connection.endpointCredential, { ...input, ...workCoordinates(connection) }, AbortSignal.any([signal, controller.signal]));
+                body = opened.body;
+                assertAdmission();
+                signal.throwIfAborted();
+                const fresh = current();
+                if (fresh.endpointCredential !== initial.endpointCredential)
+                    throw new ConnectorTransportError('Cafe authority changed', 403, 'ARTIFACT_ACCESS_DENIED');
+                body.once('close', release);
+                if (body.closed)
+                    release();
+                return opened;
+            }
+            catch (error) {
+                body?.destroy();
+                release();
+                throw error;
+            }
+        };
+    }
+    async poll(connectionId) {
+        const owner = this.owner;
+        const generation = this.generation;
+        if (this.closed ||
+            !owner ||
+            this.jobs.size >= 8 ||
+            [...this.jobs.values()].filter((job) => job.connectionId === connectionId).length >= 4)
+            return;
+        const connection = this.connection(connectionId), coordinates = workCoordinates(connection);
+        let operations;
+        try {
+            operations = await this.service.media.poll(connection.serviceUrl, connection.endpointCredential, coordinates);
+        }
+        catch (error) {
+            if (error instanceof ConnectorTransportError && error.statusCode === 404)
+                return;
+            throw error;
+        }
+        if (this.closed || generation !== this.generation || owner !== this.owner)
+            return;
+        for (const operation of operations) {
+            if (this.jobs.has(operation.relayRef) || this.jobs.size >= 8)
+                continue;
+            const controller = new AbortController();
+            const promise = this.deliver(connectionId, owner, operation, controller.signal)
+                .catch(() => { })
+                .finally(() => this.jobs.delete(operation.relayRef));
+            this.jobs.set(operation.relayRef, { connectionId, controller, promise });
+        }
+    }
+    async deliver(connectionId, owner, operation, signal) {
+        const connection = this.connection(connectionId), coordinates = workCoordinates(connection);
+        let result;
+        const reauthorize = async () => {
+            signal.throwIfAborted();
+            if (this.connection(connectionId).endpointCredential !== connection.endpointCredential)
+                throw new ConnectorTransportError('Cafe authority changed', 403, 'ARTIFACT_ACCESS_DENIED');
+            return this.service.artifacts.reauthorize(connection.serviceUrl, connection.endpointCredential, coordinates, {
+                ...operation,
+                requestId: operation.relayRef,
+                payload: {},
+            });
+        };
+        try {
+            await reauthorize();
+            result = await owner.read(operation, { reauthorize }, signal);
+            try {
+                await reauthorize();
+            }
+            catch (error) {
+                if (result.status === 'ok')
+                    result.body.destroy();
+                throw error;
+            }
+        }
+        catch (error) {
+            result = {
+                status: 'error',
+                error: {
+                    code: error instanceof ConnectorTransportError && error.statusCode === 403
+                        ? 'access_denied'
+                        : 'owner_unavailable',
+                },
+            };
+        }
+        try {
+            await this.service.media.respond(connection.serviceUrl, connection.endpointCredential, coordinates, operation, result, signal);
+        }
+        catch {
+            if (result.status === 'ok')
+                result.body.destroy();
+        }
+    }
+    connection(id) {
+        const connection = this.persistence.snapshot().connections[id];
+        if (!connection || connection.authorityStatus !== 'connected' || !connection.endpointCredential)
+            throw new ConnectorTransportError('Cafe authority is unavailable', 403, 'ARTIFACT_ACCESS_DENIED');
+        return { ...connection, endpointCredential: connection.endpointCredential };
+    }
+}
+//# sourceMappingURL=artifact-media-relay.js.map

package/dist/business/connector/artifact-media-relay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-media-relay.js","sourceRoot":"","sources":["../../../src/business/connector/artifact-media-relay.ts"],"names":[],"mappings":"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"}