@numa-tech/numa 1.18.0 → 1.20.0

package/dist/oss/web-page.js.map

@@ -1 +1 @@
-{"version":3,"file":"web-page.js","sourceRoot":"","sources":["../../src/oss/web-page.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;eAgBvB,CAAC;AAEhB,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAA;;;CAGpC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAiN9B,CAAC"}
+{"version":3,"file":"web-page.js","sourceRoot":"","sources":["../../src/oss/web-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEjE,iGAAiG;AACjG,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAA;;;;4PAIsN,gBAAgB;;;;;mOAKzC,gBAAgB;;;;;;;;;;;;;2BAaxN,aAAa;eACzB,CAAC;AAEhB,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDpC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAqlB9B,CAAC"}

package/dist/oss/web-service.d.ts

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import type { TransferStatus } from './transfer-types.js';
+declare const identitySchema: z.ZodObject<{
+    serviceId: z.ZodString;
+    pid: z.ZodNumber;
+    startedAt: z.ZodString;
+}, z.core.$strip>;
+declare const recordSchema: z.ZodObject<{
+    serviceId: z.ZodString;
+    pid: z.ZodNumber;
+    startedAt: z.ZodString;
+    version: z.ZodLiteral<1>;
+    origin: z.ZodString;
+    token: z.ZodString;
+}, z.core.$strict>;
+declare const infoSchema: z.ZodObject<{
+    serviceId: z.ZodString;
+    pid: z.ZodNumber;
+    startedAt: z.ZodString;
+    tasks: z.ZodRecord<z.ZodEnum<{
+        cancelled: "cancelled";
+        cancelling: "cancelling";
+        completed: "completed";
+        failed: "failed";
+        paused: "paused";
+        pausing: "pausing";
+        queued: "queued";
+        running: "running";
+    }>, z.ZodNumber>;
+    stopping: z.ZodBoolean;
+    activeOperations: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type OssWebServiceRecord = z.infer<typeof recordSchema>;
+export type OssWebServiceInfo = z.infer<typeof infoSchema>;
+export declare function serviceInfo(identity: z.infer<typeof identitySchema>, jobs: {
+    status: TransferStatus;
+}[], stopping: boolean, activeOperations?: number): OssWebServiceInfo;
+/** This token controls only the loopback service; no cloud credentials are persisted. */
+export declare function writeWebService(directory: string, record: OssWebServiceRecord): Promise<void>;
+export declare function removeWebService(directory: string, serviceId: string): Promise<void>;
+export declare function discoverWebService(directory: string): Promise<{
+    url: string;
+    service: OssWebServiceInfo;
+} | undefined>;
+export {};

package/dist/oss/web-service.js

@@ -0,0 +1,107 @@
+import { constants } from 'node:fs';
+import { open, rename, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { z } from 'zod';
+const statuses = ['queued', 'running', 'pausing', 'paused', 'cancelling', 'cancelled', 'completed', 'failed'];
+const count = z.number().int().nonnegative().safe();
+const identitySchema = z.object({ serviceId: z.string().uuid(), pid: count.positive(), startedAt: z.string().datetime() });
+const recordSchema = identitySchema.extend({ version: z.literal(1), origin: z.string(), token: z.string().regex(/^[A-Za-z0-9_-]{43}$/u) }).strict();
+const infoSchema = identitySchema.extend({ tasks: z.record(z.enum(statuses), count), stopping: z.boolean(), activeOperations: count.optional() });
+export function serviceInfo(identity, jobs, stopping, activeOperations = 0) {
+    const tasks = Object.fromEntries(statuses.map(status => [status, 0]));
+    for (const job of jobs)
+        tasks[job.status]++;
+    return { ...identity, tasks, stopping, activeOperations };
+}
+async function privateText(path, maximum) {
+    const file = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW);
+    try {
+        const info = await file.stat();
+        if (!info.isFile() || info.size > maximum
+            || (process.platform !== 'win32' && ((info.mode & 0o077) !== 0 || info.uid !== process.getuid())))
+            throw new Error('Invalid local service record');
+        return await file.readFile('utf8');
+    }
+    finally {
+        await file.close();
+    }
+}
+/** This token controls only the loopback service; no cloud credentials are persisted. */
+export async function writeWebService(directory, record) {
+    const temporary = join(directory, `.service-${randomUUID()}.tmp`);
+    const file = await open(temporary, 'wx', 0o600);
+    try {
+        await file.writeFile(JSON.stringify(recordSchema.parse(record)));
+        await file.sync();
+        await file.close();
+        await rename(temporary, join(directory, 'service.json'));
+    }
+    finally {
+        await file.close().catch(() => { });
+        await rm(temporary, { force: true });
+    }
+}
+export async function removeWebService(directory, serviceId) {
+    const path = join(directory, 'service.json');
+    let record;
+    try {
+        record = recordSchema.parse(JSON.parse(await privateText(path, 4096)));
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return;
+        throw error;
+    }
+    if (record.serviceId === serviceId)
+        await rm(path, { force: true });
+}
+export async function discoverWebService(directory) {
+    try {
+        const lockPid = Number((await privateText(join(directory, 'queue.lock'), 100)).trim());
+        const record = recordSchema.parse(JSON.parse(await privateText(join(directory, 'service.json'), 4096)));
+        if (record.pid !== lockPid)
+            return undefined;
+        process.kill(record.pid, 0);
+        if (!/^http:\/\/127\.0\.0\.1:\d+$/u.test(record.origin))
+            return undefined;
+        const origin = new URL(record.origin);
+        if (origin.origin !== record.origin || !origin.port || Number(origin.port) < 1)
+            return undefined;
+        const response = await fetch(record.origin + '/api/service', {
+            headers: { Authorization: `Bearer ${record.token}` }, redirect: 'error', signal: AbortSignal.timeout(2000)
+        });
+        if (!response.ok || !response.body) {
+            await response.body?.cancel();
+            return undefined;
+        }
+        const reader = response.body.getReader();
+        const chunks = [];
+        let size = 0;
+        try {
+            for (;;) {
+                const chunk = await reader.read();
+                if (chunk.done)
+                    break;
+                size += chunk.value.length;
+                if (size > 16384)
+                    return undefined;
+                chunks.push(chunk.value);
+            }
+        }
+        finally {
+            await reader.cancel().catch(() => { });
+        }
+        const { service } = z.object({ ok: z.literal(true), service: infoSchema }).parse(JSON.parse(Buffer.concat(chunks).toString('utf8')));
+        if (service.pid !== record.pid || service.serviceId !== record.serviceId || service.startedAt !== record.startedAt || service.stopping)
+            return undefined;
+        // Recheck ownership after the network call so a process replacement cannot be attached accidentally.
+        if (Number((await privateText(join(directory, 'queue.lock'), 100)).trim()) !== record.pid)
+            return undefined;
+        return { url: `${record.origin}/#token=${record.token}`, service };
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=web-service.js.map

package/dist/oss/web-service.js.map

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

package/dist/oss/web.d.ts

@@ -1,19 +1,35 @@
 import { OssClient } from "./client.js";
 import { OssTransferClient } from "./transfers.js";
 import type { AccessGrant } from "./schemas.js";
+import { type LocalPicker } from "./local-picker.js";
+import type { TransferWorker } from "./transfer-types.js";
+import { type OssWebServiceInfo } from "./web-service.js";
 export interface OssWebOptions {
     grantId: number;
     port?: number;
     openBrowser?: boolean;
+    browserOpen?: (url: string) => Promise<unknown>;
     client?: Pick<OssClient, "listGrants" | "issueSession">;
     transfer?: OssTransferClient;
+    picker?: LocalPicker;
+    taskDirectory?: string;
+    taskNamespace?: string;
+    taskWorker?: TransferWorker;
     now?: () => number;
 }
 export interface OssWebHandle {
     url: string;
     browserOpened: boolean;
+    reused?: boolean;
+    service?: OssWebServiceInfo;
     close(): Promise<void>;
     waitUntilClosed(): Promise<void>;
 }
+/** Resolve the current identity before Grant selection, without issuing STS or creating a queue/server. */
+export declare function openExistingOssWeb(options: Pick<OssWebOptions, "openBrowser" | "browserOpen"> & {
+    client: Pick<OssClient, "listGrants">;
+    taskDirectory: string;
+    taskNamespace: string;
+}): Promise<OssWebHandle | undefined>;
 export declare function readyWebGrants(grants: AccessGrant[]): AccessGrant[];
 export declare function startOssWeb(options: OssWebOptions): Promise<OssWebHandle>;