groovectl 0.0.0-stage → 0.2.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 (206) hide show
  1. package/CHANGELOG.md +79 -0
  2. package/LICENSE +201 -0
  3. package/NOTICE +4 -0
  4. package/README.md +424 -2
  5. package/SECURITY.md +10 -0
  6. package/dist/app/collection-service.d.ts +24 -0
  7. package/dist/app/collection-service.d.ts.map +1 -0
  8. package/dist/app/collection-service.js +129 -0
  9. package/dist/app/collection-service.js.map +1 -0
  10. package/dist/app/database-service.d.ts +26 -0
  11. package/dist/app/database-service.d.ts.map +1 -0
  12. package/dist/app/database-service.js +242 -0
  13. package/dist/app/database-service.js.map +1 -0
  14. package/dist/app/marketplace-offers.d.ts +25 -0
  15. package/dist/app/marketplace-offers.d.ts.map +1 -0
  16. package/dist/app/marketplace-offers.js +237 -0
  17. package/dist/app/marketplace-offers.js.map +1 -0
  18. package/dist/app/marketplace-service.d.ts +37 -0
  19. package/dist/app/marketplace-service.d.ts.map +1 -0
  20. package/dist/app/marketplace-service.js +270 -0
  21. package/dist/app/marketplace-service.js.map +1 -0
  22. package/dist/app/user-mappers.d.ts +4 -0
  23. package/dist/app/user-mappers.d.ts.map +1 -0
  24. package/dist/app/user-mappers.js +21 -0
  25. package/dist/app/user-mappers.js.map +1 -0
  26. package/dist/app/user-service.d.ts +11 -0
  27. package/dist/app/user-service.d.ts.map +1 -0
  28. package/dist/app/user-service.js +73 -0
  29. package/dist/app/user-service.js.map +1 -0
  30. package/dist/app/wantlist-service.d.ts +12 -0
  31. package/dist/app/wantlist-service.d.ts.map +1 -0
  32. package/dist/app/wantlist-service.js +32 -0
  33. package/dist/app/wantlist-service.js.map +1 -0
  34. package/dist/auth/keyring.d.ts +8 -0
  35. package/dist/auth/keyring.d.ts.map +1 -0
  36. package/dist/auth/keyring.js +39 -0
  37. package/dist/auth/keyring.js.map +1 -0
  38. package/dist/auth/prompt.d.ts +3 -0
  39. package/dist/auth/prompt.d.ts.map +1 -0
  40. package/dist/auth/prompt.js +8 -0
  41. package/dist/auth/prompt.js.map +1 -0
  42. package/dist/auth/token-provider.d.ts +31 -0
  43. package/dist/auth/token-provider.d.ts.map +1 -0
  44. package/dist/auth/token-provider.js +94 -0
  45. package/dist/auth/token-provider.js.map +1 -0
  46. package/dist/bin/groovectl.d.ts +3 -0
  47. package/dist/bin/groovectl.d.ts.map +1 -0
  48. package/dist/bin/groovectl.js +9 -0
  49. package/dist/bin/groovectl.js.map +1 -0
  50. package/dist/cli/commands/artist.d.ts +5 -0
  51. package/dist/cli/commands/artist.d.ts.map +1 -0
  52. package/dist/cli/commands/artist.js +72 -0
  53. package/dist/cli/commands/artist.js.map +1 -0
  54. package/dist/cli/commands/auth.d.ts +5 -0
  55. package/dist/cli/commands/auth.d.ts.map +1 -0
  56. package/dist/cli/commands/auth.js +49 -0
  57. package/dist/cli/commands/auth.js.map +1 -0
  58. package/dist/cli/commands/collection.d.ts +5 -0
  59. package/dist/cli/commands/collection.d.ts.map +1 -0
  60. package/dist/cli/commands/collection.js +391 -0
  61. package/dist/cli/commands/collection.js.map +1 -0
  62. package/dist/cli/commands/config.d.ts +5 -0
  63. package/dist/cli/commands/config.d.ts.map +1 -0
  64. package/dist/cli/commands/config.js +79 -0
  65. package/dist/cli/commands/config.js.map +1 -0
  66. package/dist/cli/commands/database-common.d.ts +19 -0
  67. package/dist/cli/commands/database-common.d.ts.map +1 -0
  68. package/dist/cli/commands/database-common.js +53 -0
  69. package/dist/cli/commands/database-common.js.map +1 -0
  70. package/dist/cli/commands/label.d.ts +5 -0
  71. package/dist/cli/commands/label.d.ts.map +1 -0
  72. package/dist/cli/commands/label.js +59 -0
  73. package/dist/cli/commands/label.js.map +1 -0
  74. package/dist/cli/commands/list.d.ts +5 -0
  75. package/dist/cli/commands/list.d.ts.map +1 -0
  76. package/dist/cli/commands/list.js +58 -0
  77. package/dist/cli/commands/list.js.map +1 -0
  78. package/dist/cli/commands/marketplace.d.ts +5 -0
  79. package/dist/cli/commands/marketplace.d.ts.map +1 -0
  80. package/dist/cli/commands/marketplace.js +661 -0
  81. package/dist/cli/commands/marketplace.js.map +1 -0
  82. package/dist/cli/commands/master.d.ts +5 -0
  83. package/dist/cli/commands/master.d.ts.map +1 -0
  84. package/dist/cli/commands/master.js +96 -0
  85. package/dist/cli/commands/master.js.map +1 -0
  86. package/dist/cli/commands/release.d.ts +5 -0
  87. package/dist/cli/commands/release.d.ts.map +1 -0
  88. package/dist/cli/commands/release.js +158 -0
  89. package/dist/cli/commands/release.js.map +1 -0
  90. package/dist/cli/commands/schema.d.ts +38 -0
  91. package/dist/cli/commands/schema.d.ts.map +1 -0
  92. package/dist/cli/commands/schema.js +125 -0
  93. package/dist/cli/commands/schema.js.map +1 -0
  94. package/dist/cli/commands/search.d.ts +5 -0
  95. package/dist/cli/commands/search.d.ts.map +1 -0
  96. package/dist/cli/commands/search.js +144 -0
  97. package/dist/cli/commands/search.js.map +1 -0
  98. package/dist/cli/commands/user.d.ts +5 -0
  99. package/dist/cli/commands/user.d.ts.map +1 -0
  100. package/dist/cli/commands/user.js +43 -0
  101. package/dist/cli/commands/user.js.map +1 -0
  102. package/dist/cli/commands/wantlist.d.ts +5 -0
  103. package/dist/cli/commands/wantlist.d.ts.map +1 -0
  104. package/dist/cli/commands/wantlist.js +158 -0
  105. package/dist/cli/commands/wantlist.js.map +1 -0
  106. package/dist/cli/confirmation.d.ts +3 -0
  107. package/dist/cli/confirmation.d.ts.map +1 -0
  108. package/dist/cli/confirmation.js +21 -0
  109. package/dist/cli/confirmation.js.map +1 -0
  110. package/dist/cli/create-program.d.ts +10 -0
  111. package/dist/cli/create-program.d.ts.map +1 -0
  112. package/dist/cli/create-program.js +121 -0
  113. package/dist/cli/create-program.js.map +1 -0
  114. package/dist/cli/global-options.d.ts +18 -0
  115. package/dist/cli/global-options.d.ts.map +1 -0
  116. package/dist/cli/global-options.js +25 -0
  117. package/dist/cli/global-options.js.map +1 -0
  118. package/dist/cli/run-cli.d.ts +7 -0
  119. package/dist/cli/run-cli.d.ts.map +1 -0
  120. package/dist/cli/run-cli.js +84 -0
  121. package/dist/cli/run-cli.js.map +1 -0
  122. package/dist/cli/runtime.d.ts +34 -0
  123. package/dist/cli/runtime.d.ts.map +1 -0
  124. package/dist/cli/runtime.js +93 -0
  125. package/dist/cli/runtime.js.map +1 -0
  126. package/dist/config/paths.d.ts +2 -0
  127. package/dist/config/paths.d.ts.map +1 -0
  128. package/dist/config/paths.js +18 -0
  129. package/dist/config/paths.js.map +1 -0
  130. package/dist/config/schema.d.ts +20 -0
  131. package/dist/config/schema.d.ts.map +1 -0
  132. package/dist/config/schema.js +15 -0
  133. package/dist/config/schema.js.map +1 -0
  134. package/dist/config/store.d.ts +10 -0
  135. package/dist/config/store.d.ts.map +1 -0
  136. package/dist/config/store.js +88 -0
  137. package/dist/config/store.js.map +1 -0
  138. package/dist/discogs/client.d.ts +247 -0
  139. package/dist/discogs/client.d.ts.map +1 -0
  140. package/dist/discogs/client.js +331 -0
  141. package/dist/discogs/client.js.map +1 -0
  142. package/dist/discogs/database-schemas.d.ts +162 -0
  143. package/dist/discogs/database-schemas.d.ts.map +1 -0
  144. package/dist/discogs/database-schemas.js +92 -0
  145. package/dist/discogs/database-schemas.js.map +1 -0
  146. package/dist/discogs/marketplace-page.d.ts +10 -0
  147. package/dist/discogs/marketplace-page.d.ts.map +1 -0
  148. package/dist/discogs/marketplace-page.js +140 -0
  149. package/dist/discogs/marketplace-page.js.map +1 -0
  150. package/dist/discogs/marketplace-schemas.d.ts +378 -0
  151. package/dist/discogs/marketplace-schemas.d.ts.map +1 -0
  152. package/dist/discogs/marketplace-schemas.js +184 -0
  153. package/dist/discogs/marketplace-schemas.js.map +1 -0
  154. package/dist/discogs/schemas.d.ts +142 -0
  155. package/dist/discogs/schemas.d.ts.map +1 -0
  156. package/dist/discogs/schemas.js +120 -0
  157. package/dist/discogs/schemas.js.map +1 -0
  158. package/dist/discogs/user-schemas.d.ts +325 -0
  159. package/dist/discogs/user-schemas.d.ts.map +1 -0
  160. package/dist/discogs/user-schemas.js +140 -0
  161. package/dist/discogs/user-schemas.js.map +1 -0
  162. package/dist/domain/database-resource.d.ts +72 -0
  163. package/dist/domain/database-resource.d.ts.map +1 -0
  164. package/dist/domain/database-resource.js +2 -0
  165. package/dist/domain/database-resource.js.map +1 -0
  166. package/dist/domain/marketplace.d.ts +165 -0
  167. package/dist/domain/marketplace.d.ts.map +1 -0
  168. package/dist/domain/marketplace.js +91 -0
  169. package/dist/domain/marketplace.js.map +1 -0
  170. package/dist/domain/release.d.ts +61 -0
  171. package/dist/domain/release.d.ts.map +1 -0
  172. package/dist/domain/release.js +2 -0
  173. package/dist/domain/release.js.map +1 -0
  174. package/dist/domain/search-result.d.ts +17 -0
  175. package/dist/domain/search-result.d.ts.map +1 -0
  176. package/dist/domain/search-result.js +2 -0
  177. package/dist/domain/search-result.js.map +1 -0
  178. package/dist/domain/user-resource.d.ts +117 -0
  179. package/dist/domain/user-resource.d.ts.map +1 -0
  180. package/dist/domain/user-resource.js +2 -0
  181. package/dist/domain/user-resource.js.map +1 -0
  182. package/dist/errors/app-error.d.ts +19 -0
  183. package/dist/errors/app-error.d.ts.map +1 -0
  184. package/dist/errors/app-error.js +55 -0
  185. package/dist/errors/app-error.js.map +1 -0
  186. package/dist/http/marketplace-request.d.ts +3 -0
  187. package/dist/http/marketplace-request.d.ts.map +1 -0
  188. package/dist/http/marketplace-request.js +67 -0
  189. package/dist/http/marketplace-request.js.map +1 -0
  190. package/dist/http/rate-limit.d.ts +12 -0
  191. package/dist/http/rate-limit.d.ts.map +1 -0
  192. package/dist/http/rate-limit.js +27 -0
  193. package/dist/http/rate-limit.js.map +1 -0
  194. package/dist/http/request.d.ts +19 -0
  195. package/dist/http/request.d.ts.map +1 -0
  196. package/dist/http/request.js +165 -0
  197. package/dist/http/request.js.map +1 -0
  198. package/dist/output/records.d.ts +14 -0
  199. package/dist/output/records.d.ts.map +1 -0
  200. package/dist/output/records.js +110 -0
  201. package/dist/output/records.js.map +1 -0
  202. package/dist/version.d.ts +11 -0
  203. package/dist/version.d.ts.map +1 -0
  204. package/dist/version.js +16 -0
  205. package/dist/version.js.map +1 -0
  206. package/package.json +72 -4
@@ -0,0 +1,117 @@
1
+ export interface BasicReleaseInformation {
2
+ id: number;
3
+ title: string;
4
+ artists: string[];
5
+ year: number | null;
6
+ formats: string[];
7
+ labels: string[];
8
+ catalogNumbers: string[];
9
+ url: string;
10
+ resourceUrl: string;
11
+ thumbnailUrl: string | null;
12
+ coverImageUrl: string | null;
13
+ }
14
+ export interface CollectionFolder {
15
+ id: number;
16
+ name: string;
17
+ count: number;
18
+ resourceUrl: string;
19
+ }
20
+ export interface CollectionNote {
21
+ fieldId: number;
22
+ value: string;
23
+ }
24
+ export interface CollectionItem extends BasicReleaseInformation {
25
+ instanceId: number;
26
+ folderId: number;
27
+ rating: number;
28
+ dateAdded: string | null;
29
+ notes: CollectionNote[];
30
+ }
31
+ export interface CollectionAddResult {
32
+ releaseId: number;
33
+ folderId: number;
34
+ instanceId: number;
35
+ resourceUrl: string;
36
+ }
37
+ export interface MoneyValue {
38
+ value: number | null;
39
+ currency: string | null;
40
+ display: string;
41
+ }
42
+ export interface CollectionValue {
43
+ minimum: MoneyValue;
44
+ median: MoneyValue;
45
+ maximum: MoneyValue;
46
+ }
47
+ export interface WantlistItem extends BasicReleaseInformation {
48
+ rating: number;
49
+ notes: string | null;
50
+ }
51
+ export interface CollectionField {
52
+ id: number;
53
+ name: string;
54
+ type: string;
55
+ position: number;
56
+ public: boolean | null;
57
+ lines: number | null;
58
+ options: string[];
59
+ }
60
+ export interface UserProfile {
61
+ id: number;
62
+ username: string;
63
+ name: string | null;
64
+ profile: string | null;
65
+ location: string | null;
66
+ homePage: string | null;
67
+ registered: string | null;
68
+ numCollection: number | null;
69
+ numWantlist: number | null;
70
+ numForSale: number | null;
71
+ numLists: number | null;
72
+ releasesContributed: number | null;
73
+ releasesRated: number | null;
74
+ ratingAverage: number | null;
75
+ currency: string | null;
76
+ buyerRating: number | null;
77
+ buyerNumRatings: number | null;
78
+ sellerRating: number | null;
79
+ sellerNumRatings: number | null;
80
+ url: string;
81
+ resourceUrl: string;
82
+ }
83
+ export interface UserListSummary {
84
+ id: number;
85
+ name: string;
86
+ description: string | null;
87
+ public: boolean | null;
88
+ dateAdded: string | null;
89
+ dateChanged: string | null;
90
+ url: string;
91
+ resourceUrl: string;
92
+ }
93
+ export interface UserListItem {
94
+ id: number;
95
+ type: string;
96
+ title: string;
97
+ comment: string | null;
98
+ url: string;
99
+ resourceUrl: string | null;
100
+ }
101
+ export interface UserListDetail extends UserListSummary {
102
+ items: UserListItem[];
103
+ }
104
+ export interface MutationResult {
105
+ action: string;
106
+ username: string;
107
+ releaseId?: number;
108
+ folderId?: number;
109
+ folderName?: string;
110
+ instanceId?: number;
111
+ fieldId?: number;
112
+ value?: string;
113
+ rating?: number;
114
+ notes?: string;
115
+ dryRun: boolean;
116
+ }
117
+ //# sourceMappingURL=user-resource.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"user-resource.d.ts","sourceRoot":"","sources":["../../src/domain/user-resource.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=user-resource.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"user-resource.js","sourceRoot":"","sources":["../../src/domain/user-resource.ts"],"names":[],"mappings":""}
@@ -0,0 +1,19 @@
1
+ export type ErrorKind = "usage" | "auth_required" | "auth_invalid" | "forbidden" | "not_found" | "rate_limited" | "validation" | "upstream" | "network" | "cancelled";
2
+ export interface AppErrorOptions {
3
+ kind: ErrorKind;
4
+ code: string;
5
+ message: string;
6
+ remediation?: string;
7
+ httpStatus?: number;
8
+ cause?: unknown;
9
+ }
10
+ export declare class AppError extends Error {
11
+ readonly kind: ErrorKind;
12
+ readonly code: string;
13
+ readonly remediation: string | undefined;
14
+ readonly httpStatus: number | undefined;
15
+ constructor(options: AppErrorOptions);
16
+ }
17
+ export declare function asAppError(error: unknown): AppError;
18
+ export declare function exitCodeForError(error: AppError): number;
19
+ //# sourceMappingURL=app-error.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"app-error.d.ts","sourceRoot":"","sources":["../../src/errors/app-error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,OAAO,GACP,eAAe,GACf,cAAc,GACd,WAAW,GACX,WAAW,GACX,cAAc,GACd,YAAY,GACZ,UAAU,GACV,SAAS,GACT,WAAW,CAAC;AAEhB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE5B,OAAO,EAAE,eAAe;CAQrC;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAiBnD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAqBxD"}
@@ -0,0 +1,55 @@
1
+ export class AppError extends Error {
2
+ kind;
3
+ code;
4
+ remediation;
5
+ httpStatus;
6
+ constructor(options) {
7
+ super(options.message, { cause: options.cause });
8
+ this.name = "AppError";
9
+ this.kind = options.kind;
10
+ this.code = options.code;
11
+ this.remediation = options.remediation;
12
+ this.httpStatus = options.httpStatus;
13
+ }
14
+ }
15
+ export function asAppError(error) {
16
+ if (error instanceof AppError) {
17
+ return error;
18
+ }
19
+ if (error instanceof Error && error.name === "ExitPromptError") {
20
+ return new AppError({
21
+ kind: "cancelled",
22
+ code: "GROOVECTL_CANCELLED",
23
+ message: "The prompt was cancelled.",
24
+ });
25
+ }
26
+ return new AppError({
27
+ kind: "upstream",
28
+ code: "GROOVECTL_UNEXPECTED",
29
+ message: "An unexpected error occurred.",
30
+ cause: error,
31
+ });
32
+ }
33
+ export function exitCodeForError(error) {
34
+ switch (error.kind) {
35
+ case "usage":
36
+ case "validation":
37
+ return 2;
38
+ case "auth_required":
39
+ case "auth_invalid":
40
+ return 3;
41
+ case "forbidden":
42
+ return 4;
43
+ case "not_found":
44
+ return 5;
45
+ case "rate_limited":
46
+ return 6;
47
+ case "upstream":
48
+ return 7;
49
+ case "network":
50
+ return 8;
51
+ case "cancelled":
52
+ return 10;
53
+ }
54
+ }
55
+ //# sourceMappingURL=app-error.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"app-error.js","sourceRoot":"","sources":["../../src/errors/app-error.ts"],"names":[],"mappings":"AAqBA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAY;IAChB,IAAI,CAAS;IACb,WAAW,CAAqB;IAChC,UAAU,CAAqB;IAExC,YAAY,OAAwB;QAClC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACvC,CAAC;CACF;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC/D,OAAO,IAAI,QAAQ,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,2BAA2B;SACrC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,QAAQ,CAAC;QAClB,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,+BAA+B;QACxC,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAe;IAC9C,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,OAAO,CAAC;QACb,KAAK,YAAY;YACf,OAAO,CAAC,CAAC;QACX,KAAK,eAAe,CAAC;QACrB,KAAK,cAAc;YACjB,OAAO,CAAC,CAAC;QACX,KAAK,WAAW;YACd,OAAO,CAAC,CAAC;QACX,KAAK,WAAW;YACd,OAAO,CAAC,CAAC;QACX,KAAK,cAAc;YACjB,OAAO,CAAC,CAAC;QACX,KAAK,UAAU;YACb,OAAO,CAAC,CAAC;QACX,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC;QACX,KAAK,WAAW;YACd,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC"}
@@ -0,0 +1,3 @@
1
+ /** One HTTPS GET, with no redirects, retries, cookies, or API credentials. */
2
+ export declare function requestMarketplacePage(url: URL, init: RequestInit): Promise<Response>;
3
+ //# sourceMappingURL=marketplace-request.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"marketplace-request.d.ts","sourceRoot":"","sources":["../../src/http/marketplace-request.ts"],"names":[],"mappings":"AAIA,8EAA8E;AAC9E,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,QAAQ,CAAC,CAwCnB"}
@@ -0,0 +1,67 @@
1
+ import { get } from "node:https";
2
+ import { Readable } from "node:stream";
3
+ import { createBrotliDecompress, createGunzip, createInflate } from "node:zlib";
4
+ /** One HTTPS GET, with no redirects, retries, cookies, or API credentials. */
5
+ export function requestMarketplacePage(url, init) {
6
+ return new Promise((resolve, reject) => {
7
+ const request = get(url, {
8
+ headers: Object.fromEntries(new Headers(init.headers)),
9
+ ...(init.signal == null ? {} : { signal: init.signal }),
10
+ }, (incoming) => {
11
+ try {
12
+ const headers = new Headers();
13
+ for (const [name, value] of Object.entries(incoming.headers)) {
14
+ if (Array.isArray(value)) {
15
+ for (const entry of value)
16
+ headers.append(name, entry);
17
+ }
18
+ else if (value !== undefined) {
19
+ headers.set(name, value);
20
+ }
21
+ }
22
+ const rawStatus = incoming.statusCode ?? 502;
23
+ const status = rawStatus >= 200 && rawStatus <= 599 ? rawStatus : 502;
24
+ if ([204, 205, 304].includes(status)) {
25
+ incoming.resume();
26
+ resolve(new Response(null, { status, headers }));
27
+ return;
28
+ }
29
+ const bodyStream = decodeStream(incoming, headers);
30
+ resolve(new Response(Readable.toWeb(bodyStream), { status, headers }));
31
+ }
32
+ catch (error) {
33
+ incoming.destroy();
34
+ reject(error instanceof Error ? error : new Error(String(error)));
35
+ }
36
+ });
37
+ request.on("error", reject);
38
+ });
39
+ }
40
+ function decodeStream(incoming, headers) {
41
+ const encoding = headers.get("content-encoding")?.trim().toLowerCase();
42
+ let decoder;
43
+ if (encoding === "gzip" || encoding === "x-gzip") {
44
+ decoder = createGunzip();
45
+ }
46
+ else if (encoding === "deflate") {
47
+ decoder = createInflate();
48
+ }
49
+ else if (encoding === "br") {
50
+ decoder = createBrotliDecompress();
51
+ }
52
+ if (decoder === undefined)
53
+ return incoming;
54
+ headers.delete("content-encoding");
55
+ headers.delete("content-length");
56
+ const decompressed = incoming.pipe(decoder);
57
+ incoming.on("error", (error) => decompressed.destroy(error));
58
+ const destroy = decompressed.destroy.bind(decompressed);
59
+ decompressed.destroy = function (error) {
60
+ incoming.unpipe(decompressed);
61
+ if (!incoming.destroyed)
62
+ incoming.destroy();
63
+ return destroy(error);
64
+ };
65
+ return decompressed;
66
+ }
67
+ //# sourceMappingURL=marketplace-request.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"marketplace-request.js","sourceRoot":"","sources":["../../src/http/marketplace-request.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import type { RateLimitState } from "./request.js";
2
+ export interface RateLimitGateOptions {
3
+ now?: () => number;
4
+ sleep?: (milliseconds: number) => Promise<void>;
5
+ }
6
+ export declare class RateLimitGate {
7
+ #private;
8
+ constructor(options?: RateLimitGateOptions);
9
+ update(state: RateLimitState): void;
10
+ wait(): Promise<void>;
11
+ }
12
+ //# sourceMappingURL=rate-limit.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../src/http/rate-limit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED,qBAAa,aAAa;;gBAKZ,OAAO,GAAE,oBAAyB;IAK9C,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAe7B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAI5B"}
@@ -0,0 +1,27 @@
1
+ export class RateLimitGate {
2
+ #now;
3
+ #sleep;
4
+ #nextAllowedAt = 0;
5
+ constructor(options = {}) {
6
+ this.#now = options.now ?? Date.now;
7
+ this.#sleep = options.sleep ?? defaultSleep;
8
+ }
9
+ update(state) {
10
+ if (state.limit === null ||
11
+ state.limit <= 0 ||
12
+ state.remaining === null ||
13
+ state.remaining > 1) {
14
+ return;
15
+ }
16
+ this.#nextAllowedAt = Math.max(this.#nextAllowedAt, this.#now() + Math.ceil(60_000 / state.limit));
17
+ }
18
+ async wait() {
19
+ const delay = this.#nextAllowedAt - this.#now();
20
+ if (delay > 0)
21
+ await this.#sleep(delay);
22
+ }
23
+ }
24
+ async function defaultSleep(milliseconds) {
25
+ await new Promise((resolve) => setTimeout(resolve, milliseconds));
26
+ }
27
+ //# sourceMappingURL=rate-limit.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../../src/http/rate-limit.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,aAAa;IACf,IAAI,CAAe;IACnB,MAAM,CAA0C;IACzD,cAAc,GAAG,CAAC,CAAC;IAEnB,YAAY,UAAgC,EAAE;QAC5C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,KAAqB;QAC1B,IACE,KAAK,CAAC,KAAK,KAAK,IAAI;YACpB,KAAK,CAAC,KAAK,IAAI,CAAC;YAChB,KAAK,CAAC,SAAS,KAAK,IAAI;YACxB,KAAK,CAAC,SAAS,GAAG,CAAC,EACnB,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAC5B,IAAI,CAAC,cAAc,EACnB,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAC9C,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAChD,IAAI,KAAK,GAAG,CAAC;YAAE,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;CACF;AAED,KAAK,UAAU,YAAY,CAAC,YAAoB;IAC9C,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;AAC1E,CAAC"}
@@ -0,0 +1,19 @@
1
+ export type FetchLike = typeof fetch;
2
+ export interface RequestOptions {
3
+ beforeRequest?: () => Promise<void>;
4
+ fetch?: FetchLike;
5
+ maxRateLimitWaitMs?: number;
6
+ maxRetries?: number;
7
+ onRateLimit?: (state: RateLimitState) => void;
8
+ onDiagnostic?: (message: string) => void;
9
+ random?: () => number;
10
+ sleep?: (milliseconds: number) => Promise<void>;
11
+ timeoutMs?: number;
12
+ }
13
+ export interface RateLimitState {
14
+ limit: number | null;
15
+ remaining: number | null;
16
+ used: number | null;
17
+ }
18
+ export declare function requestJson(url: URL, init: RequestInit, options?: RequestOptions): Promise<unknown>;
19
+ //# sourceMappingURL=request.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/http/request.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC;AAErC,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9C,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,wBAAsB,WAAW,CAC/B,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAqElB"}
@@ -0,0 +1,165 @@
1
+ import { AppError } from "../errors/app-error.js";
2
+ export async function requestJson(url, init, options = {}) {
3
+ const fetchImpl = options.fetch ?? fetch;
4
+ const timeoutMs = options.timeoutMs ?? 30_000;
5
+ const maxRetries = options.maxRetries ?? 3;
6
+ const maxRateLimitWaitMs = options.maxRateLimitWaitMs ?? 60_000;
7
+ const sleep = options.sleep ?? defaultSleep;
8
+ const random = options.random ?? Math.random;
9
+ const retryableMethod = (init.method ?? "GET").toUpperCase() === "GET";
10
+ for (let attempt = 0;; attempt += 1) {
11
+ try {
12
+ await options.beforeRequest?.();
13
+ const startedAt = Date.now();
14
+ options.onDiagnostic?.(`${(init.method ?? "GET").toUpperCase()} ${url.origin}${url.pathname}`);
15
+ const response = await fetchImpl(url, {
16
+ ...init,
17
+ signal: AbortSignal.timeout(timeoutMs),
18
+ });
19
+ options.onRateLimit?.(rateLimitState(response.headers));
20
+ options.onDiagnostic?.(`HTTP ${String(response.status)} in ${String(Date.now() - startedAt)}ms`);
21
+ if (!response.ok) {
22
+ const retryDelay = delayForResponse(response, attempt, retryableMethod ? maxRetries : 0, maxRateLimitWaitMs, random);
23
+ if (retryDelay !== undefined) {
24
+ await sleep(retryDelay);
25
+ continue;
26
+ }
27
+ throw errorForStatus(response.status);
28
+ }
29
+ try {
30
+ if (response.status === 204)
31
+ return undefined;
32
+ const text = await response.text();
33
+ if (text.length === 0)
34
+ return undefined;
35
+ return JSON.parse(text);
36
+ }
37
+ catch (cause) {
38
+ throw new AppError({
39
+ kind: "upstream",
40
+ code: "GROOVECTL_INVALID_RESPONSE",
41
+ message: "Discogs returned an invalid JSON response.",
42
+ httpStatus: response.status,
43
+ cause,
44
+ });
45
+ }
46
+ }
47
+ catch (error) {
48
+ if (error instanceof AppError)
49
+ throw error;
50
+ if (retryableMethod && attempt < maxRetries) {
51
+ await sleep(backoffDelay(attempt, random));
52
+ continue;
53
+ }
54
+ throw new AppError({
55
+ kind: "network",
56
+ code: "GROOVECTL_NETWORK_ERROR",
57
+ message: "The request to Discogs failed.",
58
+ remediation: "Check your network connection and try again.",
59
+ cause: error,
60
+ });
61
+ }
62
+ }
63
+ }
64
+ function delayForResponse(response, attempt, maxRetries, maxRateLimitWaitMs, random) {
65
+ if (attempt >= maxRetries)
66
+ return undefined;
67
+ if ([502, 503, 504].includes(response.status)) {
68
+ return backoffDelay(attempt, random);
69
+ }
70
+ if (response.status !== 429)
71
+ return undefined;
72
+ const retryAfter = parseRetryAfter(response.headers.get("retry-after"));
73
+ return retryAfter !== undefined && retryAfter <= maxRateLimitWaitMs
74
+ ? retryAfter
75
+ : undefined;
76
+ }
77
+ function parseRetryAfter(value) {
78
+ if (value === null)
79
+ return undefined;
80
+ const seconds = Number(value);
81
+ if (Number.isFinite(seconds) && seconds >= 0)
82
+ return seconds * 1_000;
83
+ const date = Date.parse(value);
84
+ if (Number.isNaN(date))
85
+ return undefined;
86
+ return Math.max(0, date - Date.now());
87
+ }
88
+ function backoffDelay(attempt, random) {
89
+ return 250 * 2 ** attempt + Math.floor(random() * 100);
90
+ }
91
+ function rateLimitState(headers) {
92
+ return {
93
+ limit: integerHeader(headers, "x-discogs-ratelimit"),
94
+ remaining: integerHeader(headers, "x-discogs-ratelimit-remaining"),
95
+ used: integerHeader(headers, "x-discogs-ratelimit-used"),
96
+ };
97
+ }
98
+ function integerHeader(headers, name) {
99
+ const value = headers.get(name);
100
+ if (value === null)
101
+ return null;
102
+ const parsed = Number.parseInt(value, 10);
103
+ return Number.isFinite(parsed) ? parsed : null;
104
+ }
105
+ async function defaultSleep(milliseconds) {
106
+ await new Promise((resolve) => setTimeout(resolve, milliseconds));
107
+ }
108
+ function errorForStatus(status) {
109
+ if (status === 401) {
110
+ return new AppError({
111
+ kind: "auth_invalid",
112
+ code: "GROOVECTL_AUTH_INVALID",
113
+ message: "Discogs rejected the supplied token.",
114
+ httpStatus: status,
115
+ });
116
+ }
117
+ if (status === 403) {
118
+ return new AppError({
119
+ kind: "forbidden",
120
+ code: "GROOVECTL_FORBIDDEN",
121
+ message: "Discogs denied access to this resource.",
122
+ httpStatus: status,
123
+ });
124
+ }
125
+ if (status === 404) {
126
+ return new AppError({
127
+ kind: "not_found",
128
+ code: "GROOVECTL_NOT_FOUND",
129
+ message: "The requested Discogs resource was not found.",
130
+ httpStatus: status,
131
+ });
132
+ }
133
+ if (status === 429) {
134
+ return new AppError({
135
+ kind: "rate_limited",
136
+ code: "GROOVECTL_RATE_LIMITED",
137
+ message: "Discogs rate limit exceeded.",
138
+ remediation: "Wait before retrying the request.",
139
+ httpStatus: status,
140
+ });
141
+ }
142
+ if (status === 405) {
143
+ return new AppError({
144
+ kind: "usage",
145
+ code: "GROOVECTL_METHOD_NOT_ALLOWED",
146
+ message: "Discogs does not allow this operation for the resource.",
147
+ httpStatus: status,
148
+ });
149
+ }
150
+ if (status === 422) {
151
+ return new AppError({
152
+ kind: "validation",
153
+ code: "GROOVECTL_VALIDATION_FAILED",
154
+ message: "Discogs rejected the supplied values.",
155
+ httpStatus: status,
156
+ });
157
+ }
158
+ return new AppError({
159
+ kind: "upstream",
160
+ code: "GROOVECTL_DISCOGS_ERROR",
161
+ message: `Discogs returned HTTP ${String(status)}.`,
162
+ httpStatus: status,
163
+ });
164
+ }
165
+ //# sourceMappingURL=request.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/http/request.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ export type OutputFormat = "table" | "json" | "jsonl" | "tsv";
2
+ export type WritableOutput = Pick<NodeJS.WriteStream, "write">;
3
+ export interface Column<T> {
4
+ key: string;
5
+ label?: string;
6
+ value: (item: T) => unknown;
7
+ }
8
+ export declare function renderRecord<T extends object>(item: T, format: OutputFormat, columns: readonly Column<T>[], output: WritableOutput, selectedFields?: readonly string[]): void;
9
+ export declare function limitRecords<T>(items: AsyncIterable<T>, limit: number | undefined): AsyncGenerator<T>;
10
+ export declare function renderRecords<T extends object>(items: AsyncIterable<T>, format: OutputFormat, columns: readonly Column<T>[], output: WritableOutput, selectedFields?: readonly string[], limit?: number): Promise<void>;
11
+ export declare function validateOutputFields(columns: readonly {
12
+ key: string;
13
+ }[], selectedFields: readonly string[] | undefined): void;
14
+ //# sourceMappingURL=records.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../src/output/records.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAE/D,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;CAC7B;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,SAAS,MAAM,CAAC,CAAC,CAAC,EAAE,EAC7B,MAAM,EAAE,cAAc,EACtB,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,GACjC,IAAI,CAwBN;AAED,wBAAuB,YAAY,CAAC,CAAC,EACnC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,cAAc,CAAC,CAAC,CAAC,CAYnB;AAED,wBAAsB,aAAa,CAAC,CAAC,SAAS,MAAM,EAClD,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,SAAS,MAAM,CAAC,CAAC,CAAC,EAAE,EAC7B,MAAM,EAAE,cAAc,EACtB,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,EAClC,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,EACnC,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAC5C,IAAI,CAEN"}