@motrix/mdxp 0.3.0 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/schemas/download-add.d.ts +6 -0
- package/dist/schemas/download-add.d.ts.map +1 -1
- package/dist/schemas/download-add.js +5 -0
- package/dist/schemas/download-add.js.map +1 -1
- package/dist/schemas/task.d.ts +3 -0
- package/dist/schemas/task.d.ts.map +1 -1
- package/dist/schemas/task.js +4 -0
- package/dist/schemas/task.js.map +1 -1
- package/package.json +1 -1
- package/src/schemas/download-add.ts +5 -0
- package/src/schemas/task.ts +4 -0
|
@@ -4,6 +4,8 @@ import { z } from 'zod';
|
|
|
4
4
|
* `download/submit`. Discriminated on `kind`; strict variants so an agent's
|
|
5
5
|
* typo is loudly rejected rather than silently dropped. The host maps this onto
|
|
6
6
|
* its native taskCreateRequest in Spec 4.
|
|
7
|
+
* `idempotencyKey` (8-128 chars) marks one logical add for host-side dedup so
|
|
8
|
+
* a client may safely retry a lost response — same contract as download/submit.
|
|
7
9
|
*/
|
|
8
10
|
export declare const DownloadAddParamsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
9
11
|
kind: z.ZodLiteral<"url">;
|
|
@@ -16,17 +18,20 @@ export declare const DownloadAddParamsSchema: z.ZodDiscriminatedUnion<[z.ZodObje
|
|
|
16
18
|
}, z.core.$strip>>>;
|
|
17
19
|
connections: z.ZodOptional<z.ZodNumber>;
|
|
18
20
|
proxy: z.ZodOptional<z.ZodString>;
|
|
21
|
+
idempotencyKey: z.ZodOptional<z.ZodString>;
|
|
19
22
|
}, z.core.$strict>, z.ZodObject<{
|
|
20
23
|
kind: z.ZodLiteral<"magnet">;
|
|
21
24
|
saveDir: z.ZodString;
|
|
22
25
|
uri: z.ZodString;
|
|
23
26
|
selectedFiles: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
|
|
27
|
+
idempotencyKey: z.ZodOptional<z.ZodString>;
|
|
24
28
|
}, z.core.$strict>, z.ZodObject<{
|
|
25
29
|
kind: z.ZodLiteral<"torrent">;
|
|
26
30
|
saveDir: z.ZodString;
|
|
27
31
|
base64: z.ZodString;
|
|
28
32
|
selectedFiles: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
|
|
29
33
|
displayName: z.ZodOptional<z.ZodString>;
|
|
34
|
+
idempotencyKey: z.ZodOptional<z.ZodString>;
|
|
30
35
|
}, z.core.$strict>], "kind">;
|
|
31
36
|
/** Result is the created task snapshot so callers render without polling. */
|
|
32
37
|
export declare const DownloadAddResultSchema: z.ZodObject<{
|
|
@@ -66,6 +71,7 @@ export declare const DownloadAddResultSchema: z.ZodObject<{
|
|
|
66
71
|
ratio: z.ZodNumber;
|
|
67
72
|
trackers: z.ZodArray<z.ZodString>;
|
|
68
73
|
}, z.core.$strip>>;
|
|
74
|
+
errorCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
69
75
|
}, z.core.$strip>;
|
|
70
76
|
export type DownloadAddParams = z.infer<typeof DownloadAddParamsSchema>;
|
|
71
77
|
export type DownloadAddResult = z.infer<typeof DownloadAddResultSchema>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"download-add.d.ts","sourceRoot":"","sources":["../../src/schemas/download-add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAmBvB
|
|
1
|
+
{"version":3,"file":"download-add.d.ts","sourceRoot":"","sources":["../../src/schemas/download-add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAmBvB;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;4BA0BlC,CAAA;AAEF,6EAA6E;AAC7E,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAiB,CAAA;AAErD,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AACvE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA"}
|
|
@@ -19,6 +19,8 @@ const safeDownloadUrl = z
|
|
|
19
19
|
* `download/submit`. Discriminated on `kind`; strict variants so an agent's
|
|
20
20
|
* typo is loudly rejected rather than silently dropped. The host maps this onto
|
|
21
21
|
* its native taskCreateRequest in Spec 4.
|
|
22
|
+
* `idempotencyKey` (8-128 chars) marks one logical add for host-side dedup so
|
|
23
|
+
* a client may safely retry a lost response — same contract as download/submit.
|
|
22
24
|
*/
|
|
23
25
|
export const DownloadAddParamsSchema = z.discriminatedUnion('kind', [
|
|
24
26
|
z.strictObject({
|
|
@@ -29,12 +31,14 @@ export const DownloadAddParamsSchema = z.discriminatedUnion('kind', [
|
|
|
29
31
|
headers: z.array(HttpHeaderSchema).optional(),
|
|
30
32
|
connections: z.number().int().min(1).max(128).optional(),
|
|
31
33
|
proxy: z.string().optional(),
|
|
34
|
+
idempotencyKey: z.string().min(8).max(128).optional(),
|
|
32
35
|
}),
|
|
33
36
|
z.strictObject({
|
|
34
37
|
kind: z.literal('magnet'),
|
|
35
38
|
saveDir: z.string().min(1),
|
|
36
39
|
uri: z.string().startsWith('magnet:?'),
|
|
37
40
|
selectedFiles: z.array(z.number().int().nonnegative()).optional(),
|
|
41
|
+
idempotencyKey: z.string().min(8).max(128).optional(),
|
|
38
42
|
}),
|
|
39
43
|
z.strictObject({
|
|
40
44
|
kind: z.literal('torrent'),
|
|
@@ -42,6 +46,7 @@ export const DownloadAddParamsSchema = z.discriminatedUnion('kind', [
|
|
|
42
46
|
base64: z.string().min(1),
|
|
43
47
|
selectedFiles: z.array(z.number().int().nonnegative()).optional(),
|
|
44
48
|
displayName: z.string().optional(),
|
|
49
|
+
idempotencyKey: z.string().min(8).max(128).optional(),
|
|
45
50
|
}),
|
|
46
51
|
]);
|
|
47
52
|
/** Result is the created task snapshot so callers render without polling. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"download-add.js","sourceRoot":"","sources":["../../src/schemas/download-add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE1C,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AAE1E;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG,4BAA4B,CAAA;AACtD,MAAM,eAAe,GAAG,CAAC;KACtB,MAAM,EAAE;KACR,GAAG,EAAE;KACL,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;IACxC,OAAO,EAAE,gEAAgE;CAC1E,CAAC,CAAA;AAEJ
|
|
1
|
+
{"version":3,"file":"download-add.js","sourceRoot":"","sources":["../../src/schemas/download-add.ts"],"names":[],"mappings":"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"}
|
package/dist/schemas/task.d.ts
CHANGED
|
@@ -72,6 +72,7 @@ export declare const MdxpTaskSchema: z.ZodObject<{
|
|
|
72
72
|
ratio: z.ZodNumber;
|
|
73
73
|
trackers: z.ZodArray<z.ZodString>;
|
|
74
74
|
}, z.core.$strip>>;
|
|
75
|
+
errorCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
75
76
|
}, z.core.$strip>;
|
|
76
77
|
/** Shared result for write methods that only need to ack. */
|
|
77
78
|
export declare const OkResultSchema: z.ZodObject<{
|
|
@@ -129,6 +130,7 @@ export declare const TaskListResultSchema: z.ZodObject<{
|
|
|
129
130
|
ratio: z.ZodNumber;
|
|
130
131
|
trackers: z.ZodArray<z.ZodString>;
|
|
131
132
|
}, z.core.$strip>>;
|
|
133
|
+
errorCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
132
134
|
}, z.core.$strip>>;
|
|
133
135
|
total: z.ZodNumber;
|
|
134
136
|
}, z.core.$strip>;
|
|
@@ -173,6 +175,7 @@ export declare const TaskGetResultSchema: z.ZodObject<{
|
|
|
173
175
|
ratio: z.ZodNumber;
|
|
174
176
|
trackers: z.ZodArray<z.ZodString>;
|
|
175
177
|
}, z.core.$strip>>;
|
|
178
|
+
errorCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
176
179
|
}, z.core.$strip>>;
|
|
177
180
|
}, z.core.$strip>;
|
|
178
181
|
export declare const TaskPauseParamsSchema: z.ZodObject<{
|
|
@@ -1 +1 @@
|
|
|
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
|
|
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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwBzB,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
CHANGED
|
@@ -55,6 +55,10 @@ export const MdxpTaskSchema = z.object({
|
|
|
55
55
|
finalPath: z.string().nullable(),
|
|
56
56
|
infoHash: z.string().nullable().optional(),
|
|
57
57
|
bt: MdxpBtSchema.optional(),
|
|
58
|
+
/** Open set of `DL_*` values (host's `DownloadErrorCode`); the host may add
|
|
59
|
+
* new codes over time, so consumers MUST tolerate an unrecognized string
|
|
60
|
+
* here rather than reject it — adding a value is not a breaking change. */
|
|
61
|
+
errorCode: z.string().nullish(),
|
|
58
62
|
});
|
|
59
63
|
/** Shared result for write methods that only need to ack. */
|
|
60
64
|
export const OkResultSchema = z.object({ ok: z.literal(true) });
|
package/dist/schemas/task.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/schemas/task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC;IACzC,QAAQ;IACR,mBAAmB;IACnB,aAAa;IACb,QAAQ;IACR,SAAS;IACT,YAAY;IACZ,WAAW;IACX,OAAO;CACR,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC;IACvC,MAAM;IACN,KAAK;IACL,IAAI;IACJ,QAAQ;IACR,UAAU;CACX,CAAC,CAAA;AAEF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC9B,CAAC,CAAA;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,kBAAkB;IACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,oBAAoB;IAC5B;;uEAEmE;IACnE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC1C,EAAE,EAAE,YAAY,CAAC,QAAQ,EAAE;
|
|
1
|
+
{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/schemas/task.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -22,6 +22,8 @@ const safeDownloadUrl = z
|
|
|
22
22
|
* `download/submit`. Discriminated on `kind`; strict variants so an agent's
|
|
23
23
|
* typo is loudly rejected rather than silently dropped. The host maps this onto
|
|
24
24
|
* its native taskCreateRequest in Spec 4.
|
|
25
|
+
* `idempotencyKey` (8-128 chars) marks one logical add for host-side dedup so
|
|
26
|
+
* a client may safely retry a lost response — same contract as download/submit.
|
|
25
27
|
*/
|
|
26
28
|
export const DownloadAddParamsSchema = z.discriminatedUnion('kind', [
|
|
27
29
|
z.strictObject({
|
|
@@ -32,12 +34,14 @@ export const DownloadAddParamsSchema = z.discriminatedUnion('kind', [
|
|
|
32
34
|
headers: z.array(HttpHeaderSchema).optional(),
|
|
33
35
|
connections: z.number().int().min(1).max(128).optional(),
|
|
34
36
|
proxy: z.string().optional(),
|
|
37
|
+
idempotencyKey: z.string().min(8).max(128).optional(),
|
|
35
38
|
}),
|
|
36
39
|
z.strictObject({
|
|
37
40
|
kind: z.literal('magnet'),
|
|
38
41
|
saveDir: z.string().min(1),
|
|
39
42
|
uri: z.string().startsWith('magnet:?'),
|
|
40
43
|
selectedFiles: z.array(z.number().int().nonnegative()).optional(),
|
|
44
|
+
idempotencyKey: z.string().min(8).max(128).optional(),
|
|
41
45
|
}),
|
|
42
46
|
z.strictObject({
|
|
43
47
|
kind: z.literal('torrent'),
|
|
@@ -45,6 +49,7 @@ export const DownloadAddParamsSchema = z.discriminatedUnion('kind', [
|
|
|
45
49
|
base64: z.string().min(1),
|
|
46
50
|
selectedFiles: z.array(z.number().int().nonnegative()).optional(),
|
|
47
51
|
displayName: z.string().optional(),
|
|
52
|
+
idempotencyKey: z.string().min(8).max(128).optional(),
|
|
48
53
|
}),
|
|
49
54
|
])
|
|
50
55
|
|
package/src/schemas/task.ts
CHANGED
|
@@ -59,6 +59,10 @@ export const MdxpTaskSchema = z.object({
|
|
|
59
59
|
finalPath: z.string().nullable(),
|
|
60
60
|
infoHash: z.string().nullable().optional(),
|
|
61
61
|
bt: MdxpBtSchema.optional(),
|
|
62
|
+
/** Open set of `DL_*` values (host's `DownloadErrorCode`); the host may add
|
|
63
|
+
* new codes over time, so consumers MUST tolerate an unrecognized string
|
|
64
|
+
* here rather than reject it — adding a value is not a breaking change. */
|
|
65
|
+
errorCode: z.string().nullish(),
|
|
62
66
|
})
|
|
63
67
|
|
|
64
68
|
/** Shared result for write methods that only need to ack. */
|