@zlooks.cn/tools-server 1.0.2 → 1.1.0

package/dist/transfer/contracts.d.ts

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+export declare const TRANSFER_NAMESPACE = "cn.zlooks.tools.transfer";
+export declare const transferPolicy: Readonly<{
+    roomLifetimeMs: number;
+    maxRooms: 32;
+    maxPeers: 8;
+    peerTimeoutMs: 15000;
+    pollMs: 1000;
+    requestTimeoutMs: 20000;
+    maxTextLength: 64000;
+    maxDocumentBytes: number;
+    maxClipboardLength: 8000;
+    clipboardHistory: 10;
+    maxFiles: 5;
+    maxFileBytes: number;
+    chunkBytes: number;
+    maxBufferedBytes: number;
+    connectionTimeoutMs: 30000;
+    conflictRetries: 20;
+    maxSignals: 256;
+    maxSignalHistoryBytes: number;
+}>;
+export declare const roomCodeSchema: z.ZodString;
+export declare const roomInputSchema: z.ZodObject<{
+    code: z.ZodString;
+}, z.core.$strict>;
+export declare const fileInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    size: z.ZodNumber;
+    sha256: z.ZodString;
+}, z.core.$strict>;
+export declare const peerSchema: z.ZodObject<{
+    id: z.ZodNumber;
+}, z.core.$strict>;
+export declare const signalSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    from: z.ZodNumber;
+    to: z.ZodNumber;
+    description: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<{
+            answer: "answer";
+            offer: "offer";
+        }>;
+        sdp: z.ZodString;
+    }, z.core.$strict>>;
+    candidate: z.ZodOptional<z.ZodObject<{
+        candidate: z.ZodString;
+        sdpMid: z.ZodNullable<z.ZodString>;
+        sdpMLineIndex: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type TransferSignal = z.infer<typeof signalSchema>;
+export declare const readRoomSchema: z.ZodObject<{
+    code: z.ZodString;
+    peer: z.ZodObject<{
+        id: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const snapshotSchema: z.ZodObject<{
+    expiresAt: z.ZodNumber;
+    peers: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+    }, z.core.$strict>>;
+    signals: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        from: z.ZodNumber;
+        to: z.ZodNumber;
+        description: z.ZodOptional<z.ZodObject<{
+            type: z.ZodEnum<{
+                answer: "answer";
+                offer: "offer";
+            }>;
+            sdp: z.ZodString;
+        }, z.core.$strict>>;
+        candidate: z.ZodOptional<z.ZodObject<{
+            candidate: z.ZodString;
+            sdpMid: z.ZodNullable<z.ZodString>;
+            sdpMLineIndex: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type TransferSnapshot = z.infer<typeof snapshotSchema>;
+export type TransferPeer = z.infer<typeof peerSchema>;
+export declare const transferApi: Readonly<{
+    create: "/-/cn.zlooks.tools.transfer/api/rooms/create";
+    read: "/-/cn.zlooks.tools.transfer/api/rooms/read";
+    signal: "/-/cn.zlooks.tools.transfer/api/signal";
+}>;
+export declare class TransferError extends Error {
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/transfer/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/transfer/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB,6BAA6B,CAAC;AAC7D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;EAmBzB,CAAC;AAEH,eAAO,MAAM,cAAc,aAA0C,CAAC;AACtE,eAAO,MAAM,eAAe;;kBAA2C,CAAC;AACxE,eAAO,MAAM,eAAe;;;;kBAI1B,CAAC;AACH,eAAO,MAAM,UAAU;;kBAErB,CAAC;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;kBAMsC,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAC1D,eAAO,MAAM,cAAc;;;;;kBAEzB,CAAC;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;kBAIzB,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEtD,eAAO,MAAM,WAAW;;;;EAItB,CAAC;AAEH,qBAAa,aAAc,SAAQ,KAAK;CAAG"}

package/dist/transfer/contracts.js

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+export const TRANSFER_NAMESPACE = 'cn.zlooks.tools.transfer';
+export const transferPolicy = Object.freeze({
+    roomLifetimeMs: 30 * 60 * 1_000,
+    maxRooms: 32,
+    maxPeers: 8,
+    peerTimeoutMs: 15_000,
+    pollMs: 1_000,
+    requestTimeoutMs: 20_000,
+    maxTextLength: 64_000,
+    maxDocumentBytes: 256 * 1_024,
+    maxClipboardLength: 8_000,
+    clipboardHistory: 10,
+    maxFiles: 5,
+    maxFileBytes: 20 * 1_024 * 1_024,
+    chunkBytes: 16 * 1_024,
+    maxBufferedBytes: 256 * 1_024,
+    connectionTimeoutMs: 30_000,
+    conflictRetries: 20,
+    maxSignals: 256,
+    maxSignalHistoryBytes: 192 * 1_024,
+});
+export const roomCodeSchema = z.string().regex(/^[A-Za-z0-9_-]{24}$/);
+export const roomInputSchema = z.strictObject({ code: roomCodeSchema });
+export const fileInputSchema = z.strictObject({
+    name: z.string().min(1).max(180).regex(/^[^\u0000-\u001f\u007f/\\]+$/),
+    size: z.number().int().min(0).max(transferPolicy.maxFileBytes),
+    sha256: z.string().regex(/^[a-f0-9]{64}$/),
+});
+export const peerSchema = z.strictObject({
+    id: z.number().int().min(0).max(0xffffffff),
+});
+export const signalSchema = z.strictObject({
+    id: z.uuid(), from: z.number().int().min(0).max(0xffffffff),
+    to: z.number().int().min(0).max(0xffffffff),
+    description: z.strictObject({ type: z.enum(['offer', 'answer']), sdp: z.string().max(16_000) }).optional(),
+    candidate: z.strictObject({ candidate: z.string().max(2_000), sdpMid: z.string().nullable(),
+        sdpMLineIndex: z.number().nullable() }).optional(),
+}).refine((value) => !!value.description !== !!value.candidate);
+export const readRoomSchema = roomInputSchema.extend({
+    peer: peerSchema,
+});
+export const snapshotSchema = z.strictObject({
+    expiresAt: z.number().int(),
+    peers: z.array(peerSchema).max(transferPolicy.maxPeers),
+    signals: z.array(signalSchema).max(transferPolicy.maxSignals),
+});
+export const transferApi = Object.freeze({
+    create: `/-/${TRANSFER_NAMESPACE}/api/rooms/create`,
+    read: `/-/${TRANSFER_NAMESPACE}/api/rooms/read`,
+    signal: `/-/${TRANSFER_NAMESPACE}/api/signal`,
+});
+export class TransferError extends Error {
+}
+//# sourceMappingURL=contracts.js.map

package/dist/transfer/contracts.js.map

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

package/dist/transfer/http-response.d.ts

@@ -0,0 +1,12 @@
+export declare function transferHttpResponse<T>(result: {
+    outcome: 'ok';
+    value: T;
+} | {
+    outcome: 'error';
+    message: string;
+}): {
+    status: number;
+    headers: readonly [readonly ['cache-control', 'no-store']];
+    body: import("@zlooks.cn/browser-api").BrowserApiFailure | import("@zlooks.cn/browser-api").BrowserApiSuccess<T>;
+};
+//# sourceMappingURL=http-response.d.ts.map

package/dist/transfer/http-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-response.d.ts","sourceRoot":"","sources":["../../src/transfer/http-response.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAC5C;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;;iCAItD,eAAe,EAAE,UAAU;;EAKzC"}

package/dist/transfer/http-response.js

@@ -0,0 +1,11 @@
+import { browserApiFailure, browserApiSuccess } from '@zlooks.cn/browser-api';
+export function transferHttpResponse(result) {
+    return {
+        status: result.outcome === 'ok' ? 200 : 400,
+        headers: [['cache-control', 'no-store']],
+        body: result.outcome === 'ok'
+            ? browserApiSuccess(result.value)
+            : browserApiFailure(85001, result.message),
+    };
+}
+//# sourceMappingURL=http-response.js.map

package/dist/transfer/http-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-response.js","sourceRoot":"","sources":["../../src/transfer/http-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE9E,MAAM,UAAU,oBAAoB,CAAI,MAC6B;IAEnE,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;QAC3C,OAAO,EAAE,CAAC,CAAC,eAAe,EAAE,UAAU,CAAC,CAAU;QACjD,IAAI,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI;YAC3B,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC;YACjC,CAAC,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC;KAC7C,CAAC;AACJ,CAAC"}

package/dist/transfer/micro-contract.d.ts

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+export declare const transferContract: Readonly<{
+    namespace: string;
+    operations: Readonly<{
+        create: {
+            readonly path: "/rooms/create";
+            readonly input: z.ZodObject<{}, z.core.$strict>;
+            readonly output: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                outcome: z.ZodLiteral<"ok">;
+                value: z.ZodObject<{
+                    code: z.ZodString;
+                    expiresAt: z.ZodNumber;
+                }, z.core.$strict>;
+            }, z.core.$strict>, z.ZodObject<{
+                outcome: z.ZodLiteral<"error">;
+                message: z.ZodString;
+            }, z.core.$strict>], "outcome">;
+        };
+        read: {
+            readonly path: "/rooms/read";
+            readonly input: z.ZodObject<{
+                code: z.ZodString;
+                peer: z.ZodObject<{
+                    id: z.ZodNumber;
+                }, z.core.$strict>;
+            }, z.core.$strict>;
+            readonly output: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                outcome: z.ZodLiteral<"ok">;
+                value: z.ZodObject<{
+                    expiresAt: z.ZodNumber;
+                    peers: z.ZodArray<z.ZodObject<{
+                        id: z.ZodNumber;
+                    }, z.core.$strict>>;
+                    signals: z.ZodArray<z.ZodObject<{
+                        id: z.ZodUUID;
+                        from: z.ZodNumber;
+                        to: z.ZodNumber;
+                        description: z.ZodOptional<z.ZodObject<{
+                            type: z.ZodEnum<{
+                                answer: "answer";
+                                offer: "offer";
+                            }>;
+                            sdp: z.ZodString;
+                        }, z.core.$strict>>;
+                        candidate: z.ZodOptional<z.ZodObject<{
+                            candidate: z.ZodString;
+                            sdpMid: z.ZodNullable<z.ZodString>;
+                            sdpMLineIndex: z.ZodNullable<z.ZodNumber>;
+                        }, z.core.$strict>>;
+                    }, z.core.$strict>>;
+                }, z.core.$strict>;
+            }, z.core.$strict>, z.ZodObject<{
+                outcome: z.ZodLiteral<"error">;
+                message: z.ZodString;
+            }, z.core.$strict>], "outcome">;
+        };
+        signal: {
+            readonly path: "/signal";
+            readonly input: z.ZodObject<{
+                code: z.ZodString;
+                signal: z.ZodObject<{
+                    id: z.ZodUUID;
+                    from: z.ZodNumber;
+                    to: z.ZodNumber;
+                    description: z.ZodOptional<z.ZodObject<{
+                        type: z.ZodEnum<{
+                            answer: "answer";
+                            offer: "offer";
+                        }>;
+                        sdp: z.ZodString;
+                    }, z.core.$strict>>;
+                    candidate: z.ZodOptional<z.ZodObject<{
+                        candidate: z.ZodString;
+                        sdpMid: z.ZodNullable<z.ZodString>;
+                        sdpMLineIndex: z.ZodNullable<z.ZodNumber>;
+                    }, z.core.$strict>>;
+                }, z.core.$strict>;
+            }, z.core.$strict>;
+            readonly output: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                outcome: z.ZodLiteral<"ok">;
+                value: z.ZodNull;
+            }, z.core.$strict>, z.ZodObject<{
+                outcome: z.ZodLiteral<"error">;
+                message: z.ZodString;
+            }, z.core.$strict>], "outcome">;
+        };
+    }>;
+}>;
+//# sourceMappingURL=micro-contract.d.ts.map

package/dist/transfer/micro-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"micro-contract.d.ts","sourceRoot":"","sources":["../../src/transfer/micro-contract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS3B,CAAC"}

package/dist/transfer/micro-contract.js

@@ -0,0 +1,18 @@
+import { defineMicroContract } from '@hile/micro-contract';
+import { z } from 'zod';
+import { TRANSFER_NAMESPACE, roomCodeSchema, roomInputSchema, readRoomSchema, signalSchema, snapshotSchema, } from './contracts.js';
+const result = (value) => z.discriminatedUnion('outcome', [
+    z.strictObject({ outcome: z.literal('ok'), value }),
+    z.strictObject({ outcome: z.literal('error'), message: z.string().max(200) }),
+]);
+export const transferContract = defineMicroContract({
+    namespace: TRANSFER_NAMESPACE,
+    operations: {
+        create: { path: '/rooms/create', input: z.strictObject({}),
+            output: result(z.strictObject({ code: roomCodeSchema, expiresAt: z.number() })) },
+        read: { path: '/rooms/read', input: readRoomSchema, output: result(snapshotSchema) },
+        signal: { path: '/signal', input: roomInputSchema.extend({ signal: signalSchema }),
+            output: result(z.null()) },
+    },
+});
+//# sourceMappingURL=micro-contract.js.map

package/dist/transfer/micro-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"micro-contract.js","sourceRoot":"","sources":["../../src/transfer/micro-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EACnE,YAAY,EAAE,cAAc,GAC7B,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,GAAG,CAAsB,KAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,SAAS,EAAE;IAChF,CAAC,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;IACnD,CAAC,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;CAC9E,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;IAClD,SAAS,EAAE,kBAAkB;IAC7B,UAAU,EAAE;QACV,MAAM,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC;YACxD,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE;QACnF,IAAI,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,EAAE;QACpF,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;YAChF,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE;KAC7B;CACF,CAAC,CAAC"}

package/dist/transfer/model-message.d.ts

@@ -0,0 +1,12 @@
+import { type ModelDefinition } from '@hile/model';
+import type { InvocationContext } from '@hile/context';
+export declare function runTransferModel<T extends object, R>(model: ModelDefinition<T, R>, input: T, invocation: InvocationContext): Promise<{
+    outcome: 'ok';
+    value: Awaited<R>;
+    message?: never;
+} | {
+    value?: never;
+    outcome: 'error';
+    message: string;
+}>;
+//# sourceMappingURL=model-message.d.ts.map

package/dist/transfer/model-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-message.d.ts","sourceRoot":"","sources":["../../src/transfer/model-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGvD,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EACxD,KAAK,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,iBAAiB;aAIjD,IAAI;;;;;aAGJ,OAAO;;GAE5B"}

package/dist/transfer/model-message.js

@@ -0,0 +1,14 @@
+import { loadModel } from '@hile/model';
+import { TransferError } from './contracts.js';
+export async function runTransferModel(model, input, invocation) {
+    try {
+        const value = await loadModel(model, input, invocation);
+        return { outcome: 'ok', value };
+    }
+    catch (error) {
+        if (!(error instanceof TransferError))
+            throw error;
+        return { outcome: 'error', message: error.message };
+    }
+}
+//# sourceMappingURL=model-message.js.map

package/dist/transfer/model-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-message.js","sourceRoot":"","sources":["../../src/transfer/model-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAwB,MAAM,aAAa,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAA4B,EAAE,KAAQ,EAAE,UAA6B;IAErE,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;QACxD,OAAO,EAAE,OAAO,EAAE,IAAa,EAAE,KAAK,EAAE,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,KAAK,YAAY,aAAa,CAAC;YAAE,MAAM,KAAK,CAAC;QACnD,OAAO,EAAE,OAAO,EAAE,OAAgB,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/transfer/rooms.d.ts

@@ -0,0 +1,16 @@
+import type { Redis } from 'ioredis';
+import { type TransferSignal, type TransferPeer, type TransferSnapshot } from './contracts.js';
+export declare class TransferRooms {
+    private readonly redis;
+    constructor(redis: Redis);
+    private key;
+    create(): Promise<{
+        code: string;
+        expiresAt: number;
+    }>;
+    private load;
+    private change;
+    read(code: string, peer: number | TransferPeer): Promise<TransferSnapshot>;
+    signal(code: string, value: TransferSignal): Promise<void>;
+}
+//# sourceMappingURL=rooms.d.ts.map

package/dist/transfer/rooms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rooms.d.ts","sourceRoot":"","sources":["../../src/transfer/rooms.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAEL,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAC9D,MAAM,gBAAgB,CAAC;AASxB,qBAAa,aAAa;IACL,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAzC,YAAoC,KAAK,EAAE,KAAK,EAAI;IAEpD,OAAO,CAAC,GAAG;IAKE,MAAM;;;OAclB;YAEa,IAAI;YASJ,MAAM;IAcb,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAYhF;IAEM,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,iBAahD;CACF"}

package/dist/transfer/rooms.js

@@ -0,0 +1,83 @@
+import { createHash, randomBytes } from 'node:crypto';
+import { TransferError, transferPolicy as policy, roomCodeSchema, signalSchema, } from './contracts.js';
+// Shared Redis CAS keeps pairing correct across replicas; content never enters this service.
+export class TransferRooms {
+    redis;
+    constructor(redis) {
+        this.redis = redis;
+    }
+    key(code) {
+        roomCodeSchema.parse(code);
+        return `transfer:room:${createHash('sha256').update(code).digest('hex')}`;
+    }
+    async create() {
+        const code = randomBytes(18).toString('base64url');
+        const key = this.key(code);
+        const expiresAt = Date.now() + policy.roomLifetimeMs;
+        const room = { expiresAt, signals: [], peers: [] };
+        const accepted = await this.redis.eval(`
+      redis.call('ZREMRANGEBYSCORE', KEYS[1], '-inf', ARGV[1])
+      if redis.call('ZCARD', KEYS[1]) >= tonumber(ARGV[2]) then return 0 end
+      redis.call('ZADD', KEYS[1], ARGV[3], KEYS[2])
+      redis.call('SET', KEYS[2], ARGV[4], 'PX', ARGV[5])
+      return 1
+    `, 2, 'transfer:rooms', key, Date.now(), policy.maxRooms, expiresAt, JSON.stringify(room), policy.roomLifetimeMs);
+        if (!accepted)
+            throw new TransferError('当前房间已满，请稍后重试');
+        return { code, expiresAt };
+    }
+    async load(code) {
+        const key = this.key(code);
+        const raw = await this.redis.get(key);
+        if (!raw)
+            throw new TransferError('房间不存在或已过期，请重新创建');
+        const room = JSON.parse(raw);
+        if (room.expiresAt <= Date.now())
+            throw new TransferError('房间已过期，请重新创建');
+        return { key, raw, room };
+    }
+    async change(code, edit) {
+        for (let attempt = 0; attempt < policy.conflictRetries; attempt++) {
+            const { key, raw, room } = await this.load(code);
+            const result = await edit(room);
+            const saved = await this.redis.eval(`
+        if redis.call('GET', KEYS[1]) ~= ARGV[1] then return 0 end
+        redis.call('SET', KEYS[1], ARGV[2], 'PX', ARGV[3])
+        return 1
+      `, 1, key, raw, JSON.stringify(room), Math.max(1, room.expiresAt - Date.now()));
+            if (saved)
+                return result;
+        }
+        throw new TransferError('房间操作繁忙，请重试');
+    }
+    read(code, peer) {
+        const current = typeof peer === 'number' ? { id: peer } : peer;
+        return this.change(code, (room) => {
+            room.peers = room.peers.filter((item) => item.id !== current.id && Date.now() - item.seen < policy.peerTimeoutMs);
+            if (room.peers.length >= policy.maxPeers)
+                throw new TransferError('房间连接设备已达上限');
+            room.peers.push({ ...current, seen: Date.now() });
+            return {
+                expiresAt: room.expiresAt,
+                peers: room.peers.map(({ id }) => ({ id })),
+                signals: room.signals.filter((item) => item.to === current.id),
+            };
+        });
+    }
+    signal(code, value) {
+        const signal = signalSchema.parse(value);
+        return this.change(code, (room) => {
+            if (!room.peers.some((peer) => peer.id === signal.to)
+                || !room.peers.some((peer) => peer.id === signal.from)) {
+                throw new TransferError('对方设备已离开房间');
+            }
+            if (!room.signals.some((item) => item.id === signal.id))
+                room.signals.push(signal);
+            room.signals = room.signals.slice(-policy.maxSignals);
+            while (Buffer.byteLength(JSON.stringify(room.signals)) > policy.maxSignalHistoryBytes) {
+                room.signals.shift();
+            }
+        });
+    }
+}
+//# sourceMappingURL=rooms.js.map

package/dist/transfer/rooms.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zlooks.cn/tools-server",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "type": "module",
   "private": false,
   "engines": {
@@ -17,7 +17,7 @@
   ],
   "zlooks": {
     "kind": "service",
-    "description": "84 个浏览器本地计算工具",
+    "description": "84 个本地计算工具与浏览器直连跨设备互传",
     "dependsOn": [],
     "nodeConditions": [
       "react-server"
@@ -47,8 +47,14 @@
     "@codemirror/legacy-modes": "6.5.4",
     "@codemirror/state": "6.7.2",
     "@codemirror/view": "6.43.10",
+    "@hile/context": "4.0.3",
     "@hile/core": "4.0.2",
+    "@hile/http-over-micro": "1.0.4",
+    "@hile/ioredis": "4.0.3",
+    "@hile/message-loader": "4.0.9",
     "@hile/micro": "4.0.9",
+    "@hile/micro-contract": "1.0.1",
+    "@hile/model": "4.0.5",
     "@hile/rsc": "1.0.28",
     "@hile/rsc-discovery-hile": "1.0.25",
     "@it-tools/oggen": "1.3.0",
@@ -56,6 +62,8 @@
     "@regexper/render": "1.0.0",
     "@scure/bip39": "2.4.0",
     "@sindresorhus/slugify": "3.0.1",
+    "@zlooks.cn/browser-api": "1.0.2",
+    "@zlooks.cn/infrastructure": "1.0.0",
     "@zlooks.cn/registry-config": "1.0.1",
     "@zlooks.cn/service-command": "1.0.4",
     "@zlooks.cn/ui": "1.1.9",
@@ -73,6 +81,7 @@
     "email-normalizer": "1.0.0",
     "figlet": "1.12.0",
     "ibantools": "4.5.4",
+    "ioredis": "5.11.1",
     "json5": "2.2.3",
     "jwt-decode": "3.1.2",
     "libphonenumber-js": "1.13.15",
@@ -97,7 +106,10 @@
     "uuid": "14.0.3",
     "xml-formatter": "3.7.0",
     "xml-js": "1.6.11",
+    "y-codemirror.next": "0.3.5",
+    "y-protocols": "1.0.7",
     "yaml": "2.9.1",
+    "yjs": "13.6.33",
     "zod": "4.4.3"
   },
   "devDependencies": {
@@ -119,7 +131,7 @@
     "typescript": "7.0.2",
     "vitest": "4.1.11"
   },
-  "description": "84 个浏览器本地工具的 Hile RSC 页面服务",
+  "description": "本地工具与跨设备互传的 Hile RSC 页面服务",
   "license": "GPL-3.0-only",
-  "gitHead": "a66f144a2cb25622e176d447f9e6ddb5b4eb060c"
+  "gitHead": "a3015ec3e410753dd0aaea95682d1c92618213e2"
 }