@motrix/mdxp 0.1.0

package/dist/schemas/selection.d.ts

@@ -0,0 +1,129 @@
+import { z } from 'zod';
+export declare const SelectionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"direct">;
+    primary: z.ZodObject<{
+        url: z.ZodURL;
+        headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        cookies: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+            domain: z.ZodString;
+            path: z.ZodDefault<z.ZodString>;
+            secure: z.ZodDefault<z.ZodBoolean>;
+            httpOnly: z.ZodDefault<z.ZodBoolean>;
+            sameSite: z.ZodDefault<z.ZodEnum<{
+                strict: "strict";
+                lax: "lax";
+                none: "none";
+                unspecified: "unspecified";
+            }>>;
+            expiresAt: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        refererPolicy: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    container: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"hls">;
+    primary: z.ZodObject<{
+        url: z.ZodURL;
+        headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        cookies: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+            domain: z.ZodString;
+            path: z.ZodDefault<z.ZodString>;
+            secure: z.ZodDefault<z.ZodBoolean>;
+            httpOnly: z.ZodDefault<z.ZodBoolean>;
+            sameSite: z.ZodDefault<z.ZodEnum<{
+                strict: "strict";
+                lax: "lax";
+                none: "none";
+                unspecified: "unspecified";
+            }>>;
+            expiresAt: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        refererPolicy: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    container: z.ZodDefault<z.ZodEnum<{
+        mp4: "mp4";
+        mkv: "mkv";
+        ts: "ts";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"dash">;
+    primary: z.ZodObject<{
+        url: z.ZodURL;
+        headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        cookies: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+            domain: z.ZodString;
+            path: z.ZodDefault<z.ZodString>;
+            secure: z.ZodDefault<z.ZodBoolean>;
+            httpOnly: z.ZodDefault<z.ZodBoolean>;
+            sameSite: z.ZodDefault<z.ZodEnum<{
+                strict: "strict";
+                lax: "lax";
+                none: "none";
+                unspecified: "unspecified";
+            }>>;
+            expiresAt: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        refererPolicy: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    container: z.ZodDefault<z.ZodEnum<{
+        mp4: "mp4";
+        mkv: "mkv";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"mux">;
+    video: z.ZodObject<{
+        url: z.ZodURL;
+        headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        cookies: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+            domain: z.ZodString;
+            path: z.ZodDefault<z.ZodString>;
+            secure: z.ZodDefault<z.ZodBoolean>;
+            httpOnly: z.ZodDefault<z.ZodBoolean>;
+            sameSite: z.ZodDefault<z.ZodEnum<{
+                strict: "strict";
+                lax: "lax";
+                none: "none";
+                unspecified: "unspecified";
+            }>>;
+            expiresAt: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        refererPolicy: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    audio: z.ZodObject<{
+        url: z.ZodURL;
+        headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        cookies: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+            domain: z.ZodString;
+            path: z.ZodDefault<z.ZodString>;
+            secure: z.ZodDefault<z.ZodBoolean>;
+            httpOnly: z.ZodDefault<z.ZodBoolean>;
+            sameSite: z.ZodDefault<z.ZodEnum<{
+                strict: "strict";
+                lax: "lax";
+                none: "none";
+                unspecified: "unspecified";
+            }>>;
+            expiresAt: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        refererPolicy: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    container: z.ZodDefault<z.ZodEnum<{
+        mp4: "mp4";
+        mkv: "mkv";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"magnet">;
+    uri: z.ZodString;
+}, z.core.$strip>], "kind">;
+export type Selection = z.infer<typeof SelectionSchema>;
+//# sourceMappingURL=selection.d.ts.map

package/dist/schemas/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../src/schemas/selection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA0B1B,CAAA;AAEF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA"}

package/dist/schemas/selection.js

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { ResourceSchema } from './resource.js';
+export const SelectionSchema = z.discriminatedUnion('kind', [
+    z.object({
+        kind: z.literal('direct'),
+        primary: ResourceSchema,
+        container: z.string().optional(),
+    }),
+    z.object({
+        kind: z.literal('hls'),
+        primary: ResourceSchema,
+        container: z.enum(['mp4', 'mkv', 'ts']).default('mp4'),
+    }),
+    z.object({
+        kind: z.literal('dash'),
+        primary: ResourceSchema,
+        container: z.enum(['mp4', 'mkv']).default('mp4'),
+    }),
+    z.object({
+        kind: z.literal('mux'),
+        video: ResourceSchema,
+        audio: ResourceSchema,
+        container: z.enum(['mp4', 'mkv']).default('mp4'),
+    }),
+    z.object({
+        kind: z.literal('magnet'),
+        uri: z.string().startsWith('magnet:?'),
+    }),
+]);
+//# sourceMappingURL=selection.js.map

package/dist/schemas/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../src/schemas/selection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAE9C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC1D,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;QACzB,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACjC,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;QACtB,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;KACvD,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACvB,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;KACjD,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;QACtB,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE,cAAc;QACrB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;KACjD,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;QACzB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;KACvC,CAAC;CACH,CAAC,CAAA"}

package/dist/schemas/stats.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+/**
+ * Aggregate global stats — mirrors the host's domain `GlobalStats` exactly.
+ * Also the payload of the `$/stats` notification.
+ */
+export declare const StatsResultSchema: z.ZodObject<{
+    totalDownloadSpeed: z.ZodNumber;
+    totalUploadSpeed: z.ZodNumber;
+    activeTasks: z.ZodNumber;
+    waitingTasks: z.ZodNumber;
+    stoppedTasks: z.ZodNumber;
+}, z.core.$strip>;
+export declare const StatsGetParamsSchema: z.ZodObject<{}, z.core.$strict>;
+export type StatsResult = z.infer<typeof StatsResultSchema>;
+export type StatsGetParams = z.infer<typeof StatsGetParamsSchema>;
+/** `$/stats` notification carries the same shape as `stats/get`'s result. */
+export type StatsUpdateParams = StatsResult;
+//# sourceMappingURL=stats.d.ts.map

package/dist/schemas/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/schemas/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;iBAM5B,CAAA;AAEF,eAAO,MAAM,oBAAoB,iCAAqB,CAAA;AAEtD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAC3D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AACjE,6EAA6E;AAC7E,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAA"}

package/dist/schemas/stats.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+/**
+ * Aggregate global stats — mirrors the host's domain `GlobalStats` exactly.
+ * Also the payload of the `$/stats` notification.
+ */
+export const StatsResultSchema = z.object({
+    totalDownloadSpeed: z.number(),
+    totalUploadSpeed: z.number(),
+    activeTasks: z.number(),
+    waitingTasks: z.number(),
+    stoppedTasks: z.number(),
+});
+export const StatsGetParamsSchema = z.strictObject({});
+//# sourceMappingURL=stats.js.map

package/dist/schemas/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../src/schemas/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC9B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;CACzB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA"}

package/dist/schemas/system.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export declare const SystemPingParamsSchema: z.ZodObject<{
+    sentAt: z.ZodNumber;
+}, z.core.$strip>;
+export declare const SystemPingResultSchema: z.ZodObject<{
+    sentAt: z.ZodNumber;
+    recvAt: z.ZodNumber;
+}, z.core.$strip>;
+export type SystemPingParams = z.infer<typeof SystemPingParamsSchema>;
+export type SystemPingResult = z.infer<typeof SystemPingResultSchema>;
+//# sourceMappingURL=system.d.ts.map

package/dist/schemas/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/schemas/system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,sBAAsB;;iBAEjC,CAAA;AAEF,eAAO,MAAM,sBAAsB;;;iBAGjC,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AACrE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA"}

package/dist/schemas/system.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export const SystemPingParamsSchema = z.object({
+    sentAt: z.number(),
+});
+export const SystemPingResultSchema = z.object({
+    sentAt: z.number(),
+    recvAt: z.number(),
+});
+//# sourceMappingURL=system.js.map

package/dist/schemas/system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/schemas/system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAA"}

package/dist/schemas/task.d.ts

@@ -0,0 +1,202 @@
+import { z } from 'zod';
+/**
+ * Control-plane task status. Richer than the lossy 4-value
+ * `$/task/progress.phase`; snake_case-aligned with the host's domain
+ * `TaskStatus` so the host-side mapper is near-identity. `metadata_ready` maps
+ * to `queued` and `removed` is filtered out of `task/list` (not a value here).
+ */
+export declare const MdxpTaskStatusSchema: z.ZodEnum<{
+    error: "error";
+    queued: "queued";
+    fetching_metadata: "fetching_metadata";
+    downloading: "downloading";
+    paused: "paused";
+    seeding: "seeding";
+    finalizing: "finalizing";
+    completed: "completed";
+}>;
+export declare const MdxpTaskTypeSchema: z.ZodEnum<{
+    magnet: "magnet";
+    http: "http";
+    ftp: "ftp";
+    bt: "bt";
+    metalink: "metalink";
+}>;
+/** BitTorrent-only public subset (omits swarm/announce/piece internals). */
+export declare const MdxpBtSchema: z.ZodObject<{
+    peers: z.ZodNumber;
+    seeds: z.ZodNumber;
+    ratio: z.ZodNumber;
+    trackers: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * First-class public task DTO — a deliberate NARROW projection of the host's
+ * ~40-field domain `DownloadTask`. Result/notification payload, so non-strict
+ * (a newer server may add fields older clients ignore). The public id is `id`,
+ * never the volatile engine gid.
+ */
+export declare const MdxpTaskSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<{
+        magnet: "magnet";
+        http: "http";
+        ftp: "ftp";
+        bt: "bt";
+        metalink: "metalink";
+    }>;
+    name: z.ZodString;
+    status: z.ZodEnum<{
+        error: "error";
+        queued: "queued";
+        fetching_metadata: "fetching_metadata";
+        downloading: "downloading";
+        paused: "paused";
+        seeding: "seeding";
+        finalizing: "finalizing";
+        completed: "completed";
+    }>;
+    progress: z.ZodNumber;
+    bytesDone: z.ZodNumber;
+    bytesTotal: z.ZodNullable<z.ZodNumber>;
+    speedBps: z.ZodNumber;
+    etaSec: z.ZodNullable<z.ZodNumber>;
+    saveDir: z.ZodString;
+    error: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodNumber;
+    finishedAt: z.ZodNullable<z.ZodNumber>;
+    finalPath: z.ZodNullable<z.ZodString>;
+    infoHash: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    bt: z.ZodOptional<z.ZodObject<{
+        peers: z.ZodNumber;
+        seeds: z.ZodNumber;
+        ratio: z.ZodNumber;
+        trackers: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Shared result for write methods that only need to ack. */
+export declare const OkResultSchema: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+}, z.core.$strip>;
+export declare const TaskListParamsSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodEnum<{
+        error: "error";
+        queued: "queued";
+        fetching_metadata: "fetching_metadata";
+        downloading: "downloading";
+        paused: "paused";
+        seeding: "seeding";
+        finalizing: "finalizing";
+        completed: "completed";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const TaskListResultSchema: z.ZodObject<{
+    tasks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodEnum<{
+            magnet: "magnet";
+            http: "http";
+            ftp: "ftp";
+            bt: "bt";
+            metalink: "metalink";
+        }>;
+        name: z.ZodString;
+        status: z.ZodEnum<{
+            error: "error";
+            queued: "queued";
+            fetching_metadata: "fetching_metadata";
+            downloading: "downloading";
+            paused: "paused";
+            seeding: "seeding";
+            finalizing: "finalizing";
+            completed: "completed";
+        }>;
+        progress: z.ZodNumber;
+        bytesDone: z.ZodNumber;
+        bytesTotal: z.ZodNullable<z.ZodNumber>;
+        speedBps: z.ZodNumber;
+        etaSec: z.ZodNullable<z.ZodNumber>;
+        saveDir: z.ZodString;
+        error: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodNumber;
+        finishedAt: z.ZodNullable<z.ZodNumber>;
+        finalPath: z.ZodNullable<z.ZodString>;
+        infoHash: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        bt: z.ZodOptional<z.ZodObject<{
+            peers: z.ZodNumber;
+            seeds: z.ZodNumber;
+            ratio: z.ZodNumber;
+            trackers: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+export declare const TaskGetParamsSchema: z.ZodObject<{
+    taskId: z.ZodString;
+}, z.core.$strict>;
+export declare const TaskGetResultSchema: z.ZodObject<{
+    task: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodEnum<{
+            magnet: "magnet";
+            http: "http";
+            ftp: "ftp";
+            bt: "bt";
+            metalink: "metalink";
+        }>;
+        name: z.ZodString;
+        status: z.ZodEnum<{
+            error: "error";
+            queued: "queued";
+            fetching_metadata: "fetching_metadata";
+            downloading: "downloading";
+            paused: "paused";
+            seeding: "seeding";
+            finalizing: "finalizing";
+            completed: "completed";
+        }>;
+        progress: z.ZodNumber;
+        bytesDone: z.ZodNumber;
+        bytesTotal: z.ZodNullable<z.ZodNumber>;
+        speedBps: z.ZodNumber;
+        etaSec: z.ZodNullable<z.ZodNumber>;
+        saveDir: z.ZodString;
+        error: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodNumber;
+        finishedAt: z.ZodNullable<z.ZodNumber>;
+        finalPath: z.ZodNullable<z.ZodString>;
+        infoHash: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        bt: z.ZodOptional<z.ZodObject<{
+            peers: z.ZodNumber;
+            seeds: z.ZodNumber;
+            ratio: z.ZodNumber;
+            trackers: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const TaskPauseParamsSchema: z.ZodObject<{
+    taskId: z.ZodString;
+}, z.core.$strict>;
+export declare const TaskResumeParamsSchema: z.ZodObject<{
+    taskId: z.ZodString;
+}, z.core.$strict>;
+export declare const TaskRemoveParamsSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    deleteFiles: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type MdxpTaskStatus = z.infer<typeof MdxpTaskStatusSchema>;
+export type MdxpTaskType = z.infer<typeof MdxpTaskTypeSchema>;
+export type MdxpTask = z.infer<typeof MdxpTaskSchema>;
+export type OkResult = z.infer<typeof OkResultSchema>;
+export type TaskListParams = z.infer<typeof TaskListParamsSchema>;
+export type TaskListResult = z.infer<typeof TaskListResultSchema>;
+export type TaskGetParams = z.infer<typeof TaskGetParamsSchema>;
+export type TaskGetResult = z.infer<typeof TaskGetResultSchema>;
+export type TaskPauseParams = z.infer<typeof TaskPauseParamsSchema>;
+export type TaskPauseResult = OkResult;
+export type TaskResumeParams = z.infer<typeof TaskResumeParamsSchema>;
+export type TaskResumeResult = OkResult;
+export type TaskRemoveParams = z.infer<typeof TaskRemoveParamsSchema>;
+export type TaskRemoveResult = OkResult;
+//# sourceMappingURL=task.d.ts.map

package/dist/schemas/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/schemas/task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;EAS/B,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;;EAM7B,CAAA;AAEF,4EAA4E;AAC5E,eAAO,MAAM,YAAY;;;;;iBAKvB,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoBzB,CAAA;AAEF,6DAA6D;AAC7D,eAAO,MAAM,cAAc;;iBAAoC,CAAA;AAG/D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;kBAI/B,CAAA;AACF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG/B,CAAA;AAGF,eAAO,MAAM,mBAAmB;;kBAE9B,CAAA;AACF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAE9B,CAAA;AAGF,eAAO,MAAM,qBAAqB;;kBAEhC,CAAA;AACF,eAAO,MAAM,sBAAsB;;kBAEjC,CAAA;AAGF,eAAO,MAAM,sBAAsB;;;kBAGjC,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AACjE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAC7D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AACrD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AACrD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AACjE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AACjE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAC/D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAC/D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AACnE,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAA;AACtC,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AACrE,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAA;AACvC,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AACrE,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAA"}

package/dist/schemas/task.js

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+/**
+ * Control-plane task status. Richer than the lossy 4-value
+ * `$/task/progress.phase`; snake_case-aligned with the host's domain
+ * `TaskStatus` so the host-side mapper is near-identity. `metadata_ready` maps
+ * to `queued` and `removed` is filtered out of `task/list` (not a value here).
+ */
+export const MdxpTaskStatusSchema = z.enum([
+    'queued',
+    'fetching_metadata',
+    'downloading',
+    'paused',
+    'seeding',
+    'finalizing',
+    'completed',
+    'error',
+]);
+export const MdxpTaskTypeSchema = z.enum([
+    'http',
+    'ftp',
+    'bt',
+    'magnet',
+    'metalink',
+]);
+/** BitTorrent-only public subset (omits swarm/announce/piece internals). */
+export const MdxpBtSchema = z.object({
+    peers: z.number(),
+    seeds: z.number(),
+    ratio: z.number(),
+    trackers: z.array(z.string()),
+});
+/**
+ * First-class public task DTO — a deliberate NARROW projection of the host's
+ * ~40-field domain `DownloadTask`. Result/notification payload, so non-strict
+ * (a newer server may add fields older clients ignore). The public id is `id`,
+ * never the volatile engine gid.
+ */
+export const MdxpTaskSchema = z.object({
+    id: z.string(),
+    type: MdxpTaskTypeSchema,
+    name: z.string(),
+    status: MdxpTaskStatusSchema,
+    /** Fraction in [0,1] — identity with the domain (DownloadTask.progress is
+     *  already completed/total). `finalPath`, by contrast, is a conditional
+     *  projection (non-null only once completed), not a blind copy. */
+    progress: z.number(),
+    bytesDone: z.number(),
+    bytesTotal: z.number().nullable(),
+    speedBps: z.number(),
+    etaSec: z.number().nullable(),
+    saveDir: z.string(),
+    error: z.string().nullable(),
+    createdAt: z.number(),
+    finishedAt: z.number().nullable(),
+    finalPath: z.string().nullable(),
+    infoHash: z.string().nullable().optional(),
+    bt: MdxpBtSchema.optional(),
+});
+/** Shared result for write methods that only need to ack. */
+export const OkResultSchema = z.object({ ok: z.literal(true) });
+// ─── task/list ────────────────────────────────────────────────
+export const TaskListParamsSchema = z.strictObject({
+    status: MdxpTaskStatusSchema.optional(),
+    limit: z.number().int().positive().optional(),
+    offset: z.number().int().nonnegative().optional(),
+});
+export const TaskListResultSchema = z.object({
+    tasks: z.array(MdxpTaskSchema),
+    total: z.number(),
+});
+// ─── task/get ─────────────────────────────────────────────────
+export const TaskGetParamsSchema = z.strictObject({
+    taskId: z.string().min(1),
+});
+export const TaskGetResultSchema = z.object({
+    task: MdxpTaskSchema.nullable(),
+});
+// ─── task/pause · task/resume ─────────────────────────────────
+export const TaskPauseParamsSchema = z.strictObject({
+    taskId: z.string().min(1),
+});
+export const TaskResumeParamsSchema = z.strictObject({
+    taskId: z.string().min(1),
+});
+// ─── task/remove ──────────────────────────────────────────────
+export const TaskRemoveParamsSchema = z.strictObject({
+    taskId: z.string().min(1),
+    deleteFiles: z.boolean().optional(),
+});
+//# sourceMappingURL=task.js.map

package/dist/schemas/task.js.map

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