@wirecat/yandex-disk-cli 0.0.0-stage → 0.1.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.
Files changed (235) hide show
  1. package/CHANGELOG.md +25 -0
  2. package/LICENSE +204 -0
  3. package/README.md +243 -2
  4. package/contracts/wirecat.json +1554 -0
  5. package/dist/bin/ydisk.d.ts +3 -0
  6. package/dist/bin/ydisk.d.ts.map +1 -0
  7. package/dist/bin/ydisk.js +40 -0
  8. package/dist/bin/ydisk.js.map +1 -0
  9. package/dist/bundle/all-profiles-4OLZF3RT.js +279 -0
  10. package/dist/bundle/anthropic-DKB4OJXZ.js +91 -0
  11. package/dist/bundle/app-server-G4545SSV.js +247 -0
  12. package/dist/bundle/bun-RXEQKFED.js +169 -0
  13. package/dist/bundle/bun-sqlite-VHT5LN7U.js +76 -0
  14. package/dist/bundle/chunk-2BITUXGC.js +12289 -0
  15. package/dist/bundle/chunk-2CLWDQKA.js +39330 -0
  16. package/dist/bundle/chunk-2JFDOPKA.js +9575 -0
  17. package/dist/bundle/chunk-3GVI2MAO.js +106 -0
  18. package/dist/bundle/chunk-3SZBWBMI.js +131 -0
  19. package/dist/bundle/chunk-44VSEXW6.js +4054 -0
  20. package/dist/bundle/chunk-4YPRRQBE.js +95 -0
  21. package/dist/bundle/chunk-5COYRL5B.js +379 -0
  22. package/dist/bundle/chunk-5D4AEUVA.js +24783 -0
  23. package/dist/bundle/chunk-5DM7DIZL.js +1402 -0
  24. package/dist/bundle/chunk-6R2DVTVZ.js +24 -0
  25. package/dist/bundle/chunk-762BS35H.js +2787 -0
  26. package/dist/bundle/chunk-AG64V7AB.js +1233 -0
  27. package/dist/bundle/chunk-BC5HGIXB.js +334 -0
  28. package/dist/bundle/chunk-BH7LFEX7.js +36 -0
  29. package/dist/bundle/chunk-BLNPGY7N.js +53 -0
  30. package/dist/bundle/chunk-CNIA2LJF.js +372 -0
  31. package/dist/bundle/chunk-COSXMDC7.js +230 -0
  32. package/dist/bundle/chunk-D72URWJE.js +532 -0
  33. package/dist/bundle/chunk-D7FO33KU.js +785 -0
  34. package/dist/bundle/chunk-DFDN6AUB.js +21 -0
  35. package/dist/bundle/chunk-DJH26PQ3.js +1396 -0
  36. package/dist/bundle/chunk-DJPT7IUC.js +64567 -0
  37. package/dist/bundle/chunk-DTMSCZDW.js +209 -0
  38. package/dist/bundle/chunk-E6LGZ5LX.js +16 -0
  39. package/dist/bundle/chunk-E6YRIHS5.js +92 -0
  40. package/dist/bundle/chunk-EH6ZEJGT.js +932 -0
  41. package/dist/bundle/chunk-F3DDSZTF.js +78 -0
  42. package/dist/bundle/chunk-F4WWTQNL.js +188 -0
  43. package/dist/bundle/chunk-FDDAUASC.js +1028 -0
  44. package/dist/bundle/chunk-FMNPG6N2.js +170 -0
  45. package/dist/bundle/chunk-FOKJ4POB.js +274 -0
  46. package/dist/bundle/chunk-G22C7JG6.js +731 -0
  47. package/dist/bundle/chunk-GA442SYZ.js +161 -0
  48. package/dist/bundle/chunk-GEBSW7UK.js +6848 -0
  49. package/dist/bundle/chunk-GGRKWAOK.js +594 -0
  50. package/dist/bundle/chunk-HHINRNZA.js +788 -0
  51. package/dist/bundle/chunk-HUZCL33L.js +128 -0
  52. package/dist/bundle/chunk-IALSIQVT.js +142 -0
  53. package/dist/bundle/chunk-IOXR2QBX.js +398 -0
  54. package/dist/bundle/chunk-J5CXR6VX.js +63 -0
  55. package/dist/bundle/chunk-J5PWSTOX.js +82 -0
  56. package/dist/bundle/chunk-J7BVAEHR.js +364 -0
  57. package/dist/bundle/chunk-JH46HMZW.js +1334 -0
  58. package/dist/bundle/chunk-JOBO7F6W.js +52 -0
  59. package/dist/bundle/chunk-JXZ5B3L5.js +2333 -0
  60. package/dist/bundle/chunk-KBIAMDZN.js +66 -0
  61. package/dist/bundle/chunk-KFVDL2QS.js +146 -0
  62. package/dist/bundle/chunk-LNHTLSR5.js +288 -0
  63. package/dist/bundle/chunk-M24RAKMJ.js +58 -0
  64. package/dist/bundle/chunk-MDQ57Q3H.js +1197 -0
  65. package/dist/bundle/chunk-MGUEZYFA.js +5546 -0
  66. package/dist/bundle/chunk-MLXQ4X5L.js +206 -0
  67. package/dist/bundle/chunk-NQAKARHE.js +54 -0
  68. package/dist/bundle/chunk-OF7VVUDQ.js +23 -0
  69. package/dist/bundle/chunk-OQVPE3XK.js +324 -0
  70. package/dist/bundle/chunk-OR3QG7UR.js +259 -0
  71. package/dist/bundle/chunk-OUUYVROP.js +76 -0
  72. package/dist/bundle/chunk-PQBAM64O.js +168 -0
  73. package/dist/bundle/chunk-PYVIA7WF.js +88 -0
  74. package/dist/bundle/chunk-Q6HK3PHE.js +72 -0
  75. package/dist/bundle/chunk-QB3KECV2.js +218 -0
  76. package/dist/bundle/chunk-QGWXSFYN.js +73 -0
  77. package/dist/bundle/chunk-RC5QAAAE.js +29 -0
  78. package/dist/bundle/chunk-RMJ26HLB.js +18 -0
  79. package/dist/bundle/chunk-S4UUN6LD.js +1410 -0
  80. package/dist/bundle/chunk-T7ZUDA4C.js +72 -0
  81. package/dist/bundle/chunk-TRCSMVV5.js +72 -0
  82. package/dist/bundle/chunk-UD2BQEKA.js +46 -0
  83. package/dist/bundle/chunk-V4TL55GS.js +1068 -0
  84. package/dist/bundle/chunk-VJNWN5VU.js +4072 -0
  85. package/dist/bundle/chunk-VRRNBLMA.js +1227 -0
  86. package/dist/bundle/chunk-WUCMMNFJ.js +771 -0
  87. package/dist/bundle/chunk-XDESE3NY.js +44 -0
  88. package/dist/bundle/chunk-XFLCVHSQ.js +50 -0
  89. package/dist/bundle/chunk-XQUUANA2.js +24600 -0
  90. package/dist/bundle/chunk-Y5E2WNWB.js +35 -0
  91. package/dist/bundle/chunk-Z2QEON7B.js +2275 -0
  92. package/dist/bundle/chunk-ZMJ56GME.js +7 -0
  93. package/dist/bundle/chunk-ZTSB3D7Q.js +100 -0
  94. package/dist/bundle/chunk-ZVJWD3FK.js +38 -0
  95. package/dist/bundle/chunk-ZVVMGPBJ.js +50 -0
  96. package/dist/bundle/command-contract-YIOYGPJA.js +40 -0
  97. package/dist/bundle/command-server-entry-MHBQDXS4.js +169 -0
  98. package/dist/bundle/decode-NUGJIOUW.js +297 -0
  99. package/dist/bundle/definitions-AILHKEQT.js +2005 -0
  100. package/dist/bundle/dispatch-5LC4UEGY.js +411 -0
  101. package/dist/bundle/dist-4I2W6X2I.js +7577 -0
  102. package/dist/bundle/echarts-MHSH6PGC.js +42501 -0
  103. package/dist/bundle/embed-ZDXTHHYS.js +38 -0
  104. package/dist/bundle/embedder-XFEELFUL.js +111 -0
  105. package/dist/bundle/failure-5S7VPBYK.js +25 -0
  106. package/dist/bundle/first-run-JHCHT3RJ.js +29 -0
  107. package/dist/bundle/first-screen-FHGQ6QRV.js +40 -0
  108. package/dist/bundle/instructions-WKSMBUFX.js +11 -0
  109. package/dist/bundle/mcp-HS2ZDUVR.js +167 -0
  110. package/dist/bundle/mdast-util-from-markdown-R66F4HZA.js +1958 -0
  111. package/dist/bundle/mdast-util-gfm-LN2ELINH.js +2699 -0
  112. package/dist/bundle/meeting-combined-K4U4NYRZ.js +25 -0
  113. package/dist/bundle/meeting-model-KCEG6Y5O.js +26 -0
  114. package/dist/bundle/meeting-semantic-VYGSV3H6.js +22 -0
  115. package/dist/bundle/micromark-extension-gfm-5X7YT43T.js +1838 -0
  116. package/dist/bundle/node-CM6NC6UE.js +176 -0
  117. package/dist/bundle/node-KM3CUABH.js +2340 -0
  118. package/dist/bundle/node-TLZSIHIJ.js +21 -0
  119. package/dist/bundle/node-sqlite-5YDQ3LIJ.js +74 -0
  120. package/dist/bundle/notes-search-PGO7KM2U.js +62 -0
  121. package/dist/bundle/oauth-NY4C5UCK.js +20 -0
  122. package/dist/bundle/open-YNUTA6ZE.js +23 -0
  123. package/dist/bundle/openai-4CVT5PHH.js +241 -0
  124. package/dist/bundle/process-2XT3TL27.js +91 -0
  125. package/dist/bundle/program-FMIVF5T6.js +31904 -0
  126. package/dist/bundle/prompt-VNWY3H6S.js +17 -0
  127. package/dist/bundle/recognize-JS4PBPSZ.js +26 -0
  128. package/dist/bundle/remote-RCLFH4V2.js +32 -0
  129. package/dist/bundle/rerank-EG6VKYGO.js +52 -0
  130. package/dist/bundle/schemas-ED2LHKXK.js +645 -0
  131. package/dist/bundle/serve-AHG25QXB.js +199 -0
  132. package/dist/bundle/server-5FTB7WM3.js +78 -0
  133. package/dist/bundle/server-JNZVSAZE.js +209 -0
  134. package/dist/bundle/sqlite-runtime-XSZOAQPF.js +20 -0
  135. package/dist/bundle/state-XGVAJFF7.js +36 -0
  136. package/dist/bundle/store-OHSCWZEV.js +177 -0
  137. package/dist/bundle/store-PKSPKJXL.js +293 -0
  138. package/dist/bundle/store-maintenance-command-KAWGBSWK.js +69 -0
  139. package/dist/bundle/ydisk.js +183 -0
  140. package/dist/commands/api.d.ts +9 -0
  141. package/dist/commands/api.d.ts.map +1 -0
  142. package/dist/commands/api.js +59 -0
  143. package/dist/commands/api.js.map +1 -0
  144. package/dist/commands/comments.d.ts +3 -0
  145. package/dist/commands/comments.d.ts.map +1 -0
  146. package/dist/commands/comments.js +114 -0
  147. package/dist/commands/comments.js.map +1 -0
  148. package/dist/commands/files.d.ts +3 -0
  149. package/dist/commands/files.d.ts.map +1 -0
  150. package/dist/commands/files.js +272 -0
  151. package/dist/commands/files.js.map +1 -0
  152. package/dist/commands/library.d.ts +13 -0
  153. package/dist/commands/library.d.ts.map +1 -0
  154. package/dist/commands/library.js +118 -0
  155. package/dist/commands/library.js.map +1 -0
  156. package/dist/commands/session.d.ts +3 -0
  157. package/dist/commands/session.d.ts.map +1 -0
  158. package/dist/commands/session.js +99 -0
  159. package/dist/commands/session.js.map +1 -0
  160. package/dist/config.d.ts +18 -0
  161. package/dist/config.d.ts.map +1 -0
  162. package/dist/config.js +62 -0
  163. package/dist/config.js.map +1 -0
  164. package/dist/context.d.ts +80 -0
  165. package/dist/context.d.ts.map +1 -0
  166. package/dist/context.js +77 -0
  167. package/dist/context.js.map +1 -0
  168. package/dist/generated/definitions.d.ts +3 -0
  169. package/dist/generated/definitions.d.ts.map +1 -0
  170. package/dist/generated/definitions.js +2001 -0
  171. package/dist/generated/definitions.js.map +1 -0
  172. package/dist/generated/manifest.d.ts +6 -0
  173. package/dist/generated/manifest.d.ts.map +1 -0
  174. package/dist/generated/manifest.js +1473 -0
  175. package/dist/generated/manifest.js.map +1 -0
  176. package/dist/generated/schemas.d.ts +127 -0
  177. package/dist/generated/schemas.d.ts.map +1 -0
  178. package/dist/generated/schemas.js +545 -0
  179. package/dist/generated/schemas.js.map +1 -0
  180. package/dist/generated/types.d.ts +829 -0
  181. package/dist/generated/types.d.ts.map +1 -0
  182. package/dist/generated/types.js +5 -0
  183. package/dist/generated/types.js.map +1 -0
  184. package/dist/identity.d.ts +10 -0
  185. package/dist/identity.d.ts.map +1 -0
  186. package/dist/identity.js +33 -0
  187. package/dist/identity.js.map +1 -0
  188. package/dist/index.d.ts +3 -0
  189. package/dist/index.d.ts.map +1 -0
  190. package/dist/index.js +3 -0
  191. package/dist/index.js.map +1 -0
  192. package/dist/program.d.ts +6 -0
  193. package/dist/program.d.ts.map +1 -0
  194. package/dist/program.js +65 -0
  195. package/dist/program.js.map +1 -0
  196. package/dist/sample/comments.d.ts +61 -0
  197. package/dist/sample/comments.d.ts.map +1 -0
  198. package/dist/sample/comments.js +39 -0
  199. package/dist/sample/comments.js.map +1 -0
  200. package/dist/sample/records.d.ts +16 -0
  201. package/dist/sample/records.d.ts.map +1 -0
  202. package/dist/sample/records.js +22 -0
  203. package/dist/sample/records.js.map +1 -0
  204. package/dist/sample/transport.d.ts +42 -0
  205. package/dist/sample/transport.d.ts.map +1 -0
  206. package/dist/sample/transport.js +153 -0
  207. package/dist/sample/transport.js.map +1 -0
  208. package/dist/version.d.ts +2 -0
  209. package/dist/version.d.ts.map +1 -0
  210. package/dist/version.js +2 -0
  211. package/dist/version.js.map +1 -0
  212. package/dist/wcat.d.ts +3 -0
  213. package/dist/wcat.d.ts.map +1 -0
  214. package/dist/wcat.js +4 -0
  215. package/dist/wcat.js.map +1 -0
  216. package/dist/yandex/source.d.ts +39 -0
  217. package/dist/yandex/source.d.ts.map +1 -0
  218. package/dist/yandex/source.js +189 -0
  219. package/dist/yandex/source.js.map +1 -0
  220. package/dist/yandex/transport.d.ts +41 -0
  221. package/dist/yandex/transport.d.ts.map +1 -0
  222. package/dist/yandex/transport.js +152 -0
  223. package/dist/yandex/transport.js.map +1 -0
  224. package/dist/yandex/writes.d.ts +27 -0
  225. package/dist/yandex/writes.d.ts.map +1 -0
  226. package/dist/yandex/writes.js +61 -0
  227. package/dist/yandex/writes.js.map +1 -0
  228. package/package.json +88 -4
  229. package/skills/yandex-disk-cli/SKILL.md +46 -0
  230. package/skills/yandex-disk-cli/references/api/api-disk-operations-operation-id.md +13 -0
  231. package/skills/yandex-disk-cli/references/api/api-disk-public-resources.md +50 -0
  232. package/skills/yandex-disk-cli/references/api/api-disk-resources.md +171 -0
  233. package/skills/yandex-disk-cli/references/api/api-disk-trash-resources.md +48 -0
  234. package/skills/yandex-disk-cli/references/api/api-disk.md +13 -0
  235. package/skills/yandex-disk-cli/references/api.md +17 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wcat.js","sourceRoot":"","sources":["../src/wcat.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC,MAAM,CAAC,MAAM,IAAI,GAAqB,EAAE,GAAG,OAAO,EAAE,YAAY,EAAE,WAAW,CAAC,KAAK,EAAE,CAAA"}
@@ -0,0 +1,39 @@
1
+ import type { FetchLike } from "@wirecat/cli-base/http";
2
+ import { type FeedlessDocumentSource, type SourceFile } from "@wirecat/cli-core/documents";
3
+ import type { Transport } from "./transport.js";
4
+ export declare const FOLDER = "inode/directory";
5
+ export interface DiskFile extends SourceFile {
6
+ providerMetadata: {
7
+ path: string;
8
+ md5?: string;
9
+ };
10
+ }
11
+ /** One listing page; the API's default is 20. */
12
+ export declare const PAGE = 200;
13
+ /** A path in the trash as the API takes it: `trash:/old.pdf`, from `trash:/old.pdf`, `/old.pdf` or `old.pdf`. */
14
+ export declare const trashPath: (input: string) => string;
15
+ /** A path as the API takes it: `disk:/Docs`, from `/Docs`, `Docs` or `disk:/Docs`. */
16
+ export declare const diskPath: (input: string) => string;
17
+ export declare const isFolder: (file: SourceFile) => boolean;
18
+ /** Why a file is kept by name only; undefined when its text is read. */
19
+ export declare const skipReason: (file: SourceFile) => string | undefined;
20
+ /**
21
+ * Yandex Disk as a documents source. Files are addressed by path; their id is the stable `resource_id`, which keeps
22
+ * a moved file's tags and notes. There is no change feed (https://yandex.ru/dev/disk-api/doc/en/llms.txt lists none),
23
+ * so each sync walks the chosen folders in full.
24
+ */
25
+ export declare const diskSource: (api: Transport, links: FetchLike, signal?: AbortSignal) => FeedlessDocumentSource<DiskFile> & {
26
+ download(id: string, file?: DiskFile): Promise<Response>;
27
+ account(): Promise<{
28
+ id: string;
29
+ login: string | null;
30
+ name: string | null;
31
+ }>;
32
+ byPath(path: string): Promise<DiskFile>;
33
+ page(path: string, offset: number): Promise<{
34
+ folder: DiskFile;
35
+ files: DiskFile[];
36
+ more: boolean;
37
+ }>;
38
+ };
39
+ //# sourceMappingURL=source.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/yandex/source.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EACL,KAAK,sBAAsB,EAK3B,KAAK,UAAU,EAChB,MAAM,6BAA6B,CAAA;AAGpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,eAAO,MAAM,MAAM,oBAAoB,CAAA;AAEvC,MAAM,WAAW,QAAS,SAAQ,UAAU;IAC1C,gBAAgB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACjD;AA2BD,iDAAiD;AACjD,eAAO,MAAM,IAAI,MAAM,CAAA;AAIvB,iHAAiH;AACjH,eAAO,MAAM,SAAS,UAAW,MAAM,WAAyE,CAAA;AAEhH,sFAAsF;AACtF,eAAO,MAAM,QAAQ,UAAW,MAAM,WAIrC,CAAA;AAsCD,eAAO,MAAM,QAAQ,SAAU,UAAU,YAAyB,CAAA;AAElE,wEAAwE;AACxE,eAAO,MAAM,UAAU,SAAU,UAAU,uBAK1B,CAAA;AAYjB;;;;GAIG;AACH,eAAO,MAAM,UAAU,QAChB,SAAS,SACP,SAAS,WACP,WAAW,KACnB,sBAAsB,CAAC,QAAQ,CAAC,GAAG;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IACxD,OAAO,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAA;IAC7E,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IACvC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAgGpG,CAAA"}
@@ -0,0 +1,189 @@
1
+ import { createHash } from "node:crypto";
2
+ import { posix } from "node:path";
3
+ import { CliError } from "@wirecat/cli-base";
4
+ import { fileText, MAX_FILE_BYTES, readableFile, } from "@wirecat/cli-core/documents";
5
+ import * as v from "valibot";
6
+ import { IDENTITY } from "../identity.js";
7
+ export const FOLDER = "inode/directory";
8
+ // Only the fields the source reads; Yandex sends more (https://yandex.ru/dev/disk-api/doc/en/reference/response-objects).
9
+ const Resource = v.object({
10
+ path: v.string(),
11
+ name: v.string(),
12
+ type: v.picklist(["dir", "file"]),
13
+ resource_id: v.string(),
14
+ created: v.optional(v.string()),
15
+ modified: v.optional(v.string()),
16
+ size: v.optional(v.number()),
17
+ mime_type: v.optional(v.string()),
18
+ md5: v.optional(v.string()),
19
+ revision: v.optional(v.number()),
20
+ });
21
+ const Listing = v.object({
22
+ ...Resource.entries,
23
+ _embedded: v.optional(v.object({ items: v.array(Resource), total: v.optional(v.number()), offset: v.optional(v.number()) })),
24
+ });
25
+ const Disk = v.object({
26
+ user: v.object({ uid: v.string(), login: v.optional(v.string()), display_name: v.optional(v.string()) }),
27
+ });
28
+ const Link = v.object({ href: v.string() });
29
+ /** One listing page; the API's default is 20. */
30
+ export const PAGE = 200;
31
+ /** One folder is read whole by `children`; past this many entries it is too large for one step. */
32
+ const MOST_CHILDREN = 10_000;
33
+ /** A path in the trash as the API takes it: `trash:/old.pdf`, from `trash:/old.pdf`, `/old.pdf` or `old.pdf`. */
34
+ export const trashPath = (input) => diskPath(input.replace(/^trash:/u, "")).replace(/^disk:/u, "trash:");
35
+ /** A path as the API takes it: `disk:/Docs`, from `/Docs`, `Docs` or `disk:/Docs`. */
36
+ export const diskPath = (input) => {
37
+ const bare = input.replace(/^disk:/u, "").trim();
38
+ const absolute = posix.normalize(bare.startsWith("/") ? bare : `/${bare}`);
39
+ return `disk:${absolute.length > 1 ? absolute.replace(/\/$/u, "") : absolute}`;
40
+ };
41
+ const webUrl = (path, folder) => {
42
+ const dir = folder ? path : posix.dirname(path.replace(/^disk:/u, "")) || "/";
43
+ const shown = dir.replace(/^disk:/u, "");
44
+ return `https://disk.yandex.ru/client/disk${shown === "/" ? "" : shown.split("/").map(encodeURIComponent).join("/")}`;
45
+ };
46
+ /**
47
+ * Yandex sends a time with an offset, `2026-01-02T03:00:00+03:00`; it leaves as UTC ending in `Z` (WC-TIME-2). A time
48
+ * that does not parse is left out rather than guessed.
49
+ */
50
+ const utc = (value) => {
51
+ const ms = value === undefined ? Number.NaN : Date.parse(value);
52
+ return Number.isNaN(ms) ? undefined : new Date(ms).toISOString();
53
+ };
54
+ const fileOf = (resource, parents) => {
55
+ const folder = resource.type === "dir";
56
+ const modifiedAt = utc(resource.modified);
57
+ const createdAt = utc(resource.created);
58
+ return {
59
+ id: resource.resource_id,
60
+ name: resource.name || "Disk",
61
+ mime: folder ? FOLDER : (resource.mime_type ?? "application/octet-stream"),
62
+ parents,
63
+ // md5 changes with the content; a folder has none, and its revision moves with any change below it.
64
+ ...(resource.md5 ? { version: resource.md5 } : {}),
65
+ ...(modifiedAt ? { modifiedAt } : {}),
66
+ ...(createdAt ? { createdAt } : {}),
67
+ ...(resource.size === undefined ? {} : { size: resource.size }),
68
+ url: webUrl(resource.path, folder),
69
+ trashed: false,
70
+ canDownload: !folder,
71
+ providerMetadata: { path: resource.path, ...(resource.md5 ? { md5: resource.md5 } : {}) },
72
+ };
73
+ };
74
+ export const isFolder = (file) => file.mime === FOLDER;
75
+ /** Why a file is kept by name only; undefined when its text is read. */
76
+ export const skipReason = (file) => !readableFile(file)
77
+ ? `unsupported type: ${file.mime}`
78
+ : (file.size ?? 0) > MAX_FILE_BYTES
79
+ ? `file is larger than ${Math.round(MAX_FILE_BYTES / 1024 / 1024)} MB`
80
+ : undefined;
81
+ const pathOf = (id, known) => {
82
+ const path = known?.providerMetadata.path;
83
+ // The API takes a path, never a resource_id: an id the sync has not listed cannot be read.
84
+ if (known?.id !== id || !path)
85
+ throw new CliError("not_found", "Yandex Disk finds a file by its path; this one was not listed by a sync", {
86
+ reason: "document.not-found",
87
+ });
88
+ return path;
89
+ };
90
+ /**
91
+ * Yandex Disk as a documents source. Files are addressed by path; their id is the stable `resource_id`, which keeps
92
+ * a moved file's tags and notes. There is no change feed (https://yandex.ru/dev/disk-api/doc/en/llms.txt lists none),
93
+ * so each sync walks the chosen folders in full.
94
+ */
95
+ export const diskSource = (api, links, signal) => {
96
+ const page = async (path, offset) => {
97
+ const answer = await api.send({ method: "GET", path: "disk/resources", query: { path, limit: PAGE, offset, sort: "name" } }, Listing);
98
+ const folder = fileOf(answer, []);
99
+ const items = answer._embedded?.items ?? [];
100
+ return {
101
+ folder,
102
+ files: items.map((item) => fileOf(item, [folder.id])),
103
+ more: items.length === PAGE && (answer._embedded?.total ?? Number.POSITIVE_INFINITY) > offset + PAGE,
104
+ };
105
+ };
106
+ const byPath = async (path) => {
107
+ const answer = await api.send({ method: "GET", path: "disk/resources", query: { path, limit: 0 } }, Listing);
108
+ return fileOf(answer, []);
109
+ };
110
+ const metadata = async (id, known) => {
111
+ const found = await byPath(pathOf(id, known));
112
+ // Another file now at the old path is not this one.
113
+ if (found.id !== id)
114
+ throw new CliError("not_found", "the file is no longer at the path the last sync saw", {
115
+ reason: "document.not-found",
116
+ });
117
+ return { ...found, parents: known?.parents ?? [] };
118
+ };
119
+ const download = async (id, file) => {
120
+ const { href } = await api.send({ method: "GET", path: "disk/resources/download", query: { path: pathOf(id, file) } }, Link);
121
+ // The link carries its own grant; linkFetch refuses to send the token there.
122
+ const response = await links(href, { redirect: "follow", ...(signal ? { signal } : {}) });
123
+ if (!response.ok)
124
+ throw new CliError(response.status === 404 ? "not_found" : "provider_error", "the Yandex Disk download failed", {
125
+ status: response.status,
126
+ });
127
+ return response;
128
+ };
129
+ const bytes = async (id, file) => {
130
+ const read = new Uint8Array(await (await download(id, file)).arrayBuffer());
131
+ // Bytes other than the listed ones (the file edited, or another put at its path, since the listing) are not
132
+ // saved; the error is retryable, so the sync keeps the copy it has and reads the file again next time.
133
+ const md5 = file?.providerMetadata.md5;
134
+ if (md5 && createHash("md5").update(read).digest("hex") !== md5)
135
+ throw new CliError("provider_error", "the file at this path changed since the sync listed it", {
136
+ retryable: true,
137
+ });
138
+ return read;
139
+ };
140
+ const user = async () => (await api.send({ method: "GET", path: "disk", query: { fields: "user" } }, Disk)).user;
141
+ return {
142
+ download,
143
+ account: async () => {
144
+ const { uid, login, display_name } = await user();
145
+ return { id: uid, login: login ?? null, name: display_name ?? null };
146
+ },
147
+ byPath,
148
+ page,
149
+ identity: async () => (await user()).uid,
150
+ metadata,
151
+ children: async (id, folder) => {
152
+ const path = pathOf(id, folder);
153
+ const files = [];
154
+ for (let offset = 0;; offset += PAGE) {
155
+ const one = await page(path, offset);
156
+ for (const file of one.files)
157
+ files.push({ ...file, parents: [id] });
158
+ if (!one.more)
159
+ return files;
160
+ if (files.length >= MOST_CHILDREN)
161
+ throw new CliError("provider_error", `a folder holds more than ${MOST_CHILDREN} entries`, {
162
+ reason: "listing.too-large",
163
+ });
164
+ }
165
+ },
166
+ childrenPage: async (id, cursor, folder) => {
167
+ const offset = cursor === undefined ? 0 : Number(cursor);
168
+ if (!Number.isSafeInteger(offset) || offset < 0)
169
+ throw new CliError("not_found", "the listing cursor is not a Yandex Disk offset");
170
+ const one = await page(pathOf(id, folder), offset);
171
+ return {
172
+ files: one.files.map((file) => ({ ...file, parents: [id] })),
173
+ ...(one.more ? { cursor: String(offset + PAGE) } : {}),
174
+ };
175
+ },
176
+ content: async (id, maxChars, file) => {
177
+ const current = file ?? (await metadata(id, file));
178
+ if (isFolder(current))
179
+ throw new CliError("validation_error", "a folder has no text");
180
+ const skipped = skipReason(current);
181
+ if (skipped)
182
+ return { metadata: current, markdown: "", text: "", tabs: [], notRead: skipped };
183
+ const text = (await fileText(await bytes(id, current), current, IDENTITY.command)).slice(0, maxChars);
184
+ return { metadata: current, markdown: text, text, tabs: [] };
185
+ },
186
+ bytes,
187
+ };
188
+ };
189
+ //# sourceMappingURL=source.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/yandex/source.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,41 @@
1
+ import { CliError, type SleepLike } from "@wirecat/cli-base";
2
+ import { type EventSink } from "@wirecat/cli-core/cli";
3
+ import type { Pacer } from "@wirecat/cli-core/sends";
4
+ import * as v from "valibot";
5
+ export declare const SERVICE_URL = "https://cloud-api.yandex.net/v1/";
6
+ export interface Request {
7
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
8
+ /** The path as a template, `disk/resources`: the run record keeps the template, never an id. */
9
+ path: string;
10
+ ids?: Record<string, string>;
11
+ query?: Record<string, string | number | undefined>;
12
+ body?: Record<string, unknown>;
13
+ }
14
+ export interface TransportOptions {
15
+ token: string;
16
+ fetch?: typeof fetch;
17
+ signal?: AbortSignal | undefined;
18
+ /** The run's sink from `baseContext(...).run(events => …)`, so each request lands in the run record (WC-LIFE-15). */
19
+ events?: EventSink;
20
+ /** cli-core's per-profile pace, shared by every process of the profile through a file. */
21
+ pacer?: Pacer;
22
+ sleep?: SleepLike;
23
+ now?: () => number;
24
+ timeoutMs?: number;
25
+ }
26
+ /**
27
+ * A refusal as a CliError with cli-base's code for its status. The service's own message is never repeated: it can
28
+ * quote what was sent (WC-SECR-6). A write that failed on the service's side may have happened, so it is
29
+ * `outcome_unknown` and never retryable (WC-OUT-20, WC-LIFE-9).
30
+ */
31
+ export declare const failureOf: (status: number, writes: boolean, retryAfterMs?: number) => CliError;
32
+ /**
33
+ * The only code that holds the token: it goes in the Authorization header, never in an address, an error or a run
34
+ * record (WC-SECR-7). Nothing here retries. A read the caller may run again; a write is never sent twice, since the
35
+ * first may have landed (WC-OUT-20).
36
+ */
37
+ export declare const transport: (options: TransportOptions) => {
38
+ send: <T>(request: Request, answer: v.GenericSchema<unknown, T>) => Promise<T>;
39
+ };
40
+ export type Transport = ReturnType<typeof transport>;
41
+ //# sourceMappingURL=transport.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/yandex/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAyB,KAAK,SAAS,EAAa,MAAM,mBAAmB,CAAA;AAE9F,OAAO,EAAE,KAAK,SAAS,EAAmB,MAAM,uBAAuB,CAAA;AACvE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAG5B,eAAO,MAAM,WAAW,qCAAqC,CAAA;AAO7D,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;IACnD,gGAAgG;IAChG,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAA;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;IAChC,qHAAqH;IACrH,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,0FAA0F;IAC1F,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAkBD;;;;GAIG;AACH,eAAO,MAAM,SAAS,WAAY,MAAM,UAAU,OAAO,iBAAiB,MAAM,KAAG,QAmBlF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,YAAa,gBAAgB;WA6B7B,CAAC,WAAW,OAAO,UAAU,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAAC;CAoE1F,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAA"}
@@ -0,0 +1,152 @@
1
+ import { CliError, isCliError, realSleep, wallClock } from "@wirecat/cli-base";
2
+ import { hostFetch, providerWaitMs, readJsonResponse, statusToCode } from "@wirecat/cli-base/http";
3
+ import { providerRequest } from "@wirecat/cli-core/cli";
4
+ import * as v from "valibot";
5
+ import { API_HOSTS, SERVICE } from "../identity.js";
6
+ export const SERVICE_URL = "https://cloud-api.yandex.net/v1/";
7
+ const TIMEOUT_MS = 30_000;
8
+ const LARGEST_ANSWER = 8 * 1024 * 1024;
9
+ /** A pace wait longer than this ends the run with `rate_limited` instead of sitting in it. */
10
+ const LONGEST_PACE_WAIT_MS = 60_000;
11
+ /** `new URL` folds a `.` or `..` segment into its parent, so such an id would reach another endpoint. */
12
+ const segment = (name, value) => {
13
+ if (value === "" || value === "." || value === "..")
14
+ throw new CliError("validation_error", `${name} must name one item; an empty, "." or ".." id is refused`);
15
+ return encodeURIComponent(value);
16
+ };
17
+ const urlOf = ({ path, ids = {}, query = {} }) => {
18
+ const url = new URL(path.replace(/\{(\w+)\}/g, (_, name) => segment(name, ids[name] ?? "")), SERVICE_URL);
19
+ for (const [key, value] of Object.entries(query))
20
+ if (value !== undefined)
21
+ url.searchParams.set(key, String(value));
22
+ return url;
23
+ };
24
+ /**
25
+ * A refusal as a CliError with cli-base's code for its status. The service's own message is never repeated: it can
26
+ * quote what was sent (WC-SECR-6). A write that failed on the service's side may have happened, so it is
27
+ * `outcome_unknown` and never retryable (WC-OUT-20, WC-LIFE-9).
28
+ */
29
+ export const failureOf = (status, writes, retryAfterMs) => {
30
+ if (status === 401)
31
+ return new CliError("authentication_error", `${SERVICE} refused the token`, { status });
32
+ if (status === 429)
33
+ return new CliError("rate_limited", `${SERVICE} asked to slow down; retry the command later`, {
34
+ status,
35
+ retryable: true,
36
+ ...(retryAfterMs === undefined ? {} : { retry_after_ms: retryAfterMs }),
37
+ });
38
+ if (status >= 500 && writes)
39
+ return new CliError("outcome_unknown", `${SERVICE} failed during a write; check it before repeating the write`, {
40
+ status,
41
+ retryable: false,
42
+ });
43
+ if (status === 404)
44
+ return new CliError("not_found", `${SERVICE} has no such item, or this token cannot see it`);
45
+ return new CliError(statusToCode(status), `${SERVICE} refused the request (HTTP ${status})`, {
46
+ status,
47
+ // 507: the Disk is full, which a retry does not change.
48
+ retryable: status >= 500 && status !== 507,
49
+ });
50
+ };
51
+ /**
52
+ * The only code that holds the token: it goes in the Authorization header, never in an address, an error or a run
53
+ * record (WC-SECR-7). Nothing here retries. A read the caller may run again; a write is never sent twice, since the
54
+ * first may have landed (WC-OUT-20).
55
+ */
56
+ export const transport = (options) => {
57
+ const fetchOf = hostFetch({ hosts: API_HOSTS, ...(options.fetch ? { fetch: options.fetch } : {}) });
58
+ const sleep = options.sleep ?? realSleep;
59
+ const now = options.now ?? Date.now;
60
+ const turn = async () => {
61
+ if (!options.pacer)
62
+ return;
63
+ const wait = (await options.pacer.reserve()) - now();
64
+ if (wait <= 0)
65
+ return;
66
+ if (wait > LONGEST_PACE_WAIT_MS)
67
+ throw new CliError("rate_limited", `this profile must wait ${Math.ceil(wait / 1000)} s before its next request`, {
68
+ retry_after_ms: wait,
69
+ });
70
+ await sleep(wait, options.signal, "retry");
71
+ };
72
+ const unanswered = (writes, error) => {
73
+ // Before the stop check: a write stopped in flight may still have landed (WC-LIFE-9).
74
+ if (writes)
75
+ return new CliError("outcome_unknown", `${SERVICE} did not answer a write; check it before repeating the write`, {
76
+ retryable: false,
77
+ });
78
+ if (options.signal?.aborted)
79
+ return new CliError("cancelled", `the ${SERVICE} request was stopped`);
80
+ const timedOut = error instanceof Error && error.name === "TimeoutError";
81
+ return timedOut
82
+ ? new CliError("timeout", `${SERVICE} did not answer in time`, { retryable: true })
83
+ : new CliError("network_error", `${SERVICE} could not be reached`, { retryable: true });
84
+ };
85
+ const send = async (request, answer) => {
86
+ const writes = request.method !== "GET";
87
+ const url = urlOf(request);
88
+ await turn();
89
+ // Not AbortSignal.timeout: its timer keeps the run's async context alive until it fires.
90
+ const deadline = new AbortController();
91
+ const timer = setTimeout(() => deadline.abort(new DOMException("timed out", "TimeoutError")), options.timeoutMs ?? TIMEOUT_MS);
92
+ timer.unref();
93
+ const signal = options.signal ? AbortSignal.any([options.signal, deadline.signal]) : deadline.signal;
94
+ const end = providerRequest(`${request.method} /${request.path}`, options.events, {
95
+ method: request.method,
96
+ transport: "http",
97
+ });
98
+ try {
99
+ let response;
100
+ try {
101
+ response = await fetchOf(url, {
102
+ method: request.method,
103
+ headers: {
104
+ // Yandex's scheme word is OAuth, not Bearer (https://yandex.ru/dev/disk-api/doc/en/concepts/quickstart).
105
+ authorization: `OAuth ${options.token}`,
106
+ accept: "application/json",
107
+ ...(request.body ? { "content-type": "application/json" } : {}),
108
+ },
109
+ ...(request.body ? { body: JSON.stringify(request.body) } : {}),
110
+ // A redirect would carry the Authorization header to an address we did not choose.
111
+ redirect: "error",
112
+ signal,
113
+ });
114
+ }
115
+ catch (error) {
116
+ const failure = unanswered(writes, deadline.signal.reason ?? error);
117
+ end({ errorCode: failure.code });
118
+ throw failure;
119
+ }
120
+ if (!response.ok) {
121
+ const failure = failureOf(response.status, writes, providerWaitMs(response.headers, wallClock));
122
+ end({ status: response.status, errorCode: failure.code });
123
+ throw failure;
124
+ }
125
+ let body;
126
+ try {
127
+ // A delete answers 204 with no body (https://yandex.ru/dev/disk-api/doc/en/reference/delete).
128
+ body =
129
+ response.status === 204 ? undefined : await readJsonResponse(response, { maxBytes: LARGEST_ANSWER, signal });
130
+ }
131
+ catch (error) {
132
+ const failure = isCliError(error) && error.code !== "invalid_response"
133
+ ? error
134
+ : new CliError("invalid_response", `${SERVICE} answered with something other than bounded JSON`);
135
+ end({ status: response.status, errorCode: failure.code });
136
+ throw failure;
137
+ }
138
+ const parsed = v.safeParse(answer, body);
139
+ if (!parsed.success) {
140
+ end({ status: response.status, errorCode: "invalid_response" });
141
+ throw new CliError("invalid_response", `${SERVICE}'s answer does not have the documented shape`);
142
+ }
143
+ end({ status: response.status });
144
+ return parsed.output;
145
+ }
146
+ finally {
147
+ clearTimeout(timer);
148
+ }
149
+ };
150
+ return { send };
151
+ };
152
+ //# sourceMappingURL=transport.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/yandex/transport.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,27 @@
1
+ import type { FetchLike } from "@wirecat/cli-base/http";
2
+ import type { Transport } from "./transport.js";
3
+ export type Outcome = {
4
+ status: "done";
5
+ } | {
6
+ status: "in-progress";
7
+ disk_operation: string;
8
+ };
9
+ /**
10
+ * The writes to the Disk, each one request of Yandex's REST API
11
+ * (https://yandex.ru/dev/disk-api/doc/en/). Paths are the API's own, `disk:/…` or
12
+ * `trash:/…`. Nothing here asks or checks a permission: the command does, before it calls.
13
+ */
14
+ export declare const diskWrites: (api: Transport, links: FetchLike, signal?: AbortSignal) => {
15
+ createFolder: (path: string) => Promise<Outcome>;
16
+ trash: (path: string) => Promise<Outcome>;
17
+ restore: (trashPath: string) => Promise<Outcome>;
18
+ transfer: (kind: "copy" | "move", from: string, to: string, replace: boolean) => Promise<Outcome>;
19
+ publish: (path: string) => Promise<Outcome>;
20
+ unpublish: (path: string) => Promise<Outcome>;
21
+ /** The public link, or undefined when the read fails or names none: the publish itself already happened. */
22
+ publicUrl: (path: string) => Promise<string | undefined>;
23
+ upload: (path: string, body: Blob, replace: boolean) => Promise<{
24
+ status: "done" | "in-progress";
25
+ }>;
26
+ };
27
+ //# sourceMappingURL=writes.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"writes.d.ts","sourceRoot":"","sources":["../../src/yandex/writes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAGvD,OAAO,KAAK,EAAW,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAMxD,MAAM,MAAM,OAAO,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAA;AAQ5F;;;;GAIG;AACH,eAAO,MAAM,UAAU,QAAS,SAAS,SAAS,SAAS,WAAW,WAAW;IAG7E,YAAY,SAAS,MAAM;IAC3B,KAAK,SAAS,MAAM;IACpB,OAAO,cAAc,MAAM;IAE3B,QAAQ,SAAS,MAAM,GAAG,MAAM,QAAQ,MAAM,MAAM,MAAM,WAAW,OAAO;IAG5E,OAAO,SAAS,MAAM;IACtB,SAAS,SAAS,MAAM;IACxB,4GAA4G;IAC5G,SAAS,SAAS,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKtD,MAAM,SAAe,MAAM,QAAQ,IAAI,WAAW,OAAO,KAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAAA;KAAE,CAAC;CAmC1G,CAAA"}
@@ -0,0 +1,61 @@
1
+ import { CliError } from "@wirecat/cli-base";
2
+ import * as v from "valibot";
3
+ import { SERVICE } from "../identity.js";
4
+ const Link = v.object({ href: v.string(), method: v.optional(v.string()) });
5
+ const Answer = v.optional(Link);
6
+ const PublicUrl = v.object({ public_url: v.optional(v.string()) });
7
+ /** A 202 names the operation the Disk goes on with; its id lets the caller check it later. */
8
+ const outcomeOf = (link) => {
9
+ const id = link?.href.match(/\/operations\/([^/?]+)/u)?.[1];
10
+ return id ? { status: "in-progress", disk_operation: id } : { status: "done" };
11
+ };
12
+ /**
13
+ * The writes to the Disk, each one request of Yandex's REST API
14
+ * (https://yandex.ru/dev/disk-api/doc/en/). Paths are the API's own, `disk:/…` or
15
+ * `trash:/…`. Nothing here asks or checks a permission: the command does, before it calls.
16
+ */
17
+ export const diskWrites = (api, links, signal) => {
18
+ const send = async (request) => outcomeOf(await api.send(request, Answer));
19
+ return {
20
+ createFolder: (path) => send({ method: "PUT", path: "disk/resources", query: { path } }),
21
+ trash: (path) => send({ method: "DELETE", path: "disk/resources", query: { path, permanently: "false" } }),
22
+ restore: (trashPath) => send({ method: "PUT", path: "disk/trash/resources/restore", query: { path: trashPath } }),
23
+ transfer: (kind, from, to, replace) => send({ method: "POST", path: `disk/resources/${kind}`, query: { from, path: to, overwrite: String(replace) } }),
24
+ // The spec marks the body as required; an empty one keeps Yandex's default settings.
25
+ publish: (path) => send({ method: "PUT", path: "disk/resources/publish", query: { path }, body: {} }),
26
+ unpublish: (path) => send({ method: "PUT", path: "disk/resources/unpublish", query: { path } }),
27
+ /** The public link, or undefined when the read fails or names none: the publish itself already happened. */
28
+ publicUrl: (path) => api.send({ method: "GET", path: "disk/resources", query: { path, fields: "public_url" } }, PublicUrl).then((answer) => answer.public_url, () => undefined),
29
+ upload: async (path, body, replace) => {
30
+ // The link lives 30 minutes and takes the bytes without the token (https://yandex.ru/dev/disk-api/doc/en/reference/upload).
31
+ const link = await api.send({ method: "GET", path: "disk/resources/upload", query: { path, overwrite: String(replace) } }, Link);
32
+ let response;
33
+ try {
34
+ response = await links(link.href, { method: "PUT", body, ...(signal ? { signal } : {}) });
35
+ }
36
+ catch (error) {
37
+ // Only a request that never left is safe to call failed; the bytes may have landed otherwise (WC-LIFE-9).
38
+ if (error instanceof CliError && error.details.sent === false)
39
+ throw error;
40
+ throw new CliError("outcome_unknown", `${SERVICE} did not answer the upload; check the file before sending it again`, {
41
+ retryable: false,
42
+ });
43
+ }
44
+ if (response.status === 413)
45
+ throw new CliError("validation_error", `${SERVICE} refuses a file this large for this account`);
46
+ if (response.status === 507)
47
+ throw new CliError("validation_error", `the ${SERVICE} is full`);
48
+ if (response.status >= 400 && response.status < 500)
49
+ throw new CliError("validation_error", `${SERVICE} refused the upload (HTTP ${response.status})`, {
50
+ status: response.status,
51
+ });
52
+ if (!response.ok)
53
+ throw new CliError("outcome_unknown", `the ${SERVICE} upload ended with HTTP ${response.status}`, {
54
+ status: response.status,
55
+ retryable: false,
56
+ });
57
+ return { status: response.status === 202 ? "in-progress" : "done" };
58
+ },
59
+ };
60
+ };
61
+ //# sourceMappingURL=writes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"writes.js","sourceRoot":"","sources":["../../src/yandex/writes.ts"],"names":[],"mappings":"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"}