modkit-server 0.0.0-stage → 1.0.0-beta.1

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 (51) hide show
  1. package/README.md +23 -2
  2. package/dist/adapters/classifiers.d.ts +45 -0
  3. package/dist/adapters/classifiers.d.ts.map +1 -0
  4. package/dist/adapters/classifiers.js +271 -0
  5. package/dist/adapters/classifiers.js.map +1 -0
  6. package/dist/adapters/notifiers.d.ts +34 -0
  7. package/dist/adapters/notifiers.d.ts.map +1 -0
  8. package/dist/adapters/notifiers.js +114 -0
  9. package/dist/adapters/notifiers.js.map +1 -0
  10. package/dist/adapters/storage.d.ts +15 -0
  11. package/dist/adapters/storage.d.ts.map +1 -0
  12. package/dist/adapters/storage.js +77 -0
  13. package/dist/adapters/storage.js.map +1 -0
  14. package/dist/auth.d.ts +43 -0
  15. package/dist/auth.d.ts.map +1 -0
  16. package/dist/auth.js +260 -0
  17. package/dist/auth.js.map +1 -0
  18. package/dist/cli.d.ts +18 -0
  19. package/dist/cli.d.ts.map +1 -0
  20. package/dist/cli.js +306 -0
  21. package/dist/cli.js.map +1 -0
  22. package/dist/conformance.d.ts +21 -0
  23. package/dist/conformance.d.ts.map +1 -0
  24. package/dist/conformance.js +188 -0
  25. package/dist/conformance.js.map +1 -0
  26. package/dist/errors.d.ts +7 -0
  27. package/dist/errors.d.ts.map +1 -0
  28. package/dist/errors.js +18 -0
  29. package/dist/errors.js.map +1 -0
  30. package/dist/index.d.ts +12 -0
  31. package/dist/index.d.ts.map +1 -0
  32. package/dist/index.js +12 -0
  33. package/dist/index.js.map +1 -0
  34. package/dist/memoryStore.d.ts +6 -0
  35. package/dist/memoryStore.d.ts.map +1 -0
  36. package/dist/memoryStore.js +332 -0
  37. package/dist/memoryStore.js.map +1 -0
  38. package/dist/postgresStore.d.ts +20 -0
  39. package/dist/postgresStore.d.ts.map +1 -0
  40. package/dist/postgresStore.js +457 -0
  41. package/dist/postgresStore.js.map +1 -0
  42. package/dist/server.d.ts +37 -0
  43. package/dist/server.d.ts.map +1 -0
  44. package/dist/server.js +322 -0
  45. package/dist/server.js.map +1 -0
  46. package/dist/store.d.ts +131 -0
  47. package/dist/store.d.ts.map +1 -0
  48. package/dist/store.js +19 -0
  49. package/dist/store.js.map +1 -0
  50. package/migrations/001_modkit_v1.sql +168 -0
  51. package/package.json +55 -4
package/dist/auth.d.ts ADDED
@@ -0,0 +1,43 @@
1
+ export interface ModKitAuthPrincipal {
2
+ userId: string;
3
+ email?: string | null | undefined;
4
+ }
5
+ export type ModKitAuthenticator = (request: Request) => Promise<ModKitAuthPrincipal | null> | ModKitAuthPrincipal | null;
6
+ export interface JwtClaims {
7
+ sub: string;
8
+ email?: string | undefined;
9
+ exp?: number | undefined;
10
+ nbf?: number | undefined;
11
+ iat?: number | undefined;
12
+ iss?: string | undefined;
13
+ aud?: string | string[] | undefined;
14
+ [key: string]: unknown;
15
+ }
16
+ export interface SupabaseJwtOptions {
17
+ jwksUrl?: string | undefined;
18
+ secret?: string | undefined;
19
+ issuer?: string | string[] | undefined;
20
+ audience?: string | string[] | undefined;
21
+ authorizeUser?: ((claims: JwtClaims) => Promise<boolean> | boolean) | undefined;
22
+ fetchImpl?: typeof globalThis.fetch | undefined;
23
+ jwksCacheTtlMs?: number | undefined;
24
+ jwksRefreshCooldownMs?: number | undefined;
25
+ now?: (() => Date) | undefined;
26
+ }
27
+ /**
28
+ * Extracts a trimmed Bearer token from the `Authorization` request header.
29
+ */
30
+ export declare function extractBearerToken(request: Request): string | null;
31
+ /**
32
+ * Performs a constant-time comparison between two secret strings using SHA-256 digests.
33
+ */
34
+ export declare function verifySecretConstantTime(provided: string, expected: string): boolean;
35
+ /**
36
+ * Creates an in-memory authenticator backed by a static map of bearer tokens to user IDs or principals.
37
+ */
38
+ export declare function staticTokens(tokens: Record<string, string | ModKitAuthPrincipal>): ModKitAuthenticator;
39
+ /**
40
+ * Creates a JWT authenticator for Supabase Auth (ES256/RS256 JWKS with HS256 fallback).
41
+ */
42
+ export declare function supabaseJwt(options: SupabaseJwtOptions): ModKitAuthenticator;
43
+ //# sourceMappingURL=auth.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CAClC;AAED,MAAM,MAAM,mBAAmB,GAAG,CAChC,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,GAAG,mBAAmB,GAAG,IAAI,CAAA;AAErE,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxB,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxB,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxB,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAA;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAA;IACtC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAA;IACxC,aAAa,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,GAAG,SAAS,CAAA;IAC/E,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,SAAS,CAAA;IAC/C,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1C,GAAG,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAA;CAC/B;AAWD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAOlE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIpF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAAC,GACnD,mBAAmB,CAcrB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,mBAAmB,CAwK5E"}
package/dist/auth.js ADDED
@@ -0,0 +1,260 @@
1
+ import { Buffer } from 'node:buffer';
2
+ import { createHash, timingSafeEqual } from 'node:crypto';
3
+ /**
4
+ * Extracts a trimmed Bearer token from the `Authorization` request header.
5
+ */
6
+ export function extractBearerToken(request) {
7
+ const header = request.headers.get('authorization');
8
+ if (!header)
9
+ return null;
10
+ const match = header.match(/^Bearer\s+(.+)$/i);
11
+ if (!match || !match[1])
12
+ return null;
13
+ const token = match[1].trim();
14
+ return token.length > 0 ? token : null;
15
+ }
16
+ /**
17
+ * Performs a constant-time comparison between two secret strings using SHA-256 digests.
18
+ */
19
+ export function verifySecretConstantTime(provided, expected) {
20
+ const a = createHash('sha256').update(provided, 'utf8').digest();
21
+ const b = createHash('sha256').update(expected, 'utf8').digest();
22
+ return timingSafeEqual(a, b);
23
+ }
24
+ /**
25
+ * Creates an in-memory authenticator backed by a static map of bearer tokens to user IDs or principals.
26
+ */
27
+ export function staticTokens(tokens) {
28
+ return (request) => {
29
+ const token = extractBearerToken(request);
30
+ if (!token || !Object.hasOwn(tokens, token))
31
+ return null;
32
+ const entry = tokens[token];
33
+ if (!entry)
34
+ return null;
35
+ if (typeof entry === 'string') {
36
+ return { userId: entry };
37
+ }
38
+ return {
39
+ userId: entry.userId,
40
+ email: entry.email ?? null,
41
+ };
42
+ };
43
+ }
44
+ /**
45
+ * Creates a JWT authenticator for Supabase Auth (ES256/RS256 JWKS with HS256 fallback).
46
+ */
47
+ export function supabaseJwt(options) {
48
+ if (!options.jwksUrl && !options.secret) {
49
+ throw new Error('supabaseJwt requires at least one of jwksUrl or secret.');
50
+ }
51
+ const fetchFn = options.fetchImpl ?? globalThis.fetch;
52
+ const cacheTtlMs = options.jwksCacheTtlMs ?? 5 * 60 * 1000;
53
+ const refreshCooldownMs = options.jwksRefreshCooldownMs ?? 10_000;
54
+ const nowFn = options.now ?? (() => new Date());
55
+ const expectedAudience = normalizeExpectedClaim(options.audience ?? 'authenticated');
56
+ const derivedIssuer = deriveIssuerFromJwksUrl(options.jwksUrl);
57
+ const expectedIssuer = normalizeExpectedClaim(options.issuer ?? derivedIssuer);
58
+ let cachedJwks = null;
59
+ let inFlightJwksFetch = null;
60
+ let lastForcedRefreshAt = -Infinity;
61
+ async function getJwksKeys(forceRefresh = false) {
62
+ if (!options.jwksUrl)
63
+ return [];
64
+ const nowMs = nowFn().getTime();
65
+ if (!forceRefresh && cachedJwks && nowMs - cachedJwks.fetchedAt < cacheTtlMs) {
66
+ return cachedJwks.keys;
67
+ }
68
+ if (forceRefresh &&
69
+ cachedJwks &&
70
+ nowMs - lastForcedRefreshAt < refreshCooldownMs &&
71
+ nowMs - cachedJwks.fetchedAt < cacheTtlMs) {
72
+ return cachedJwks.keys;
73
+ }
74
+ if (inFlightJwksFetch) {
75
+ return inFlightJwksFetch;
76
+ }
77
+ if (forceRefresh) {
78
+ lastForcedRefreshAt = nowMs;
79
+ }
80
+ const fetchUrl = options.jwksUrl;
81
+ inFlightJwksFetch = (async () => {
82
+ try {
83
+ const response = await fetchFn(fetchUrl, {
84
+ method: 'GET',
85
+ headers: { accept: 'application/json' },
86
+ });
87
+ if (!response.ok) {
88
+ throw new Error(`Failed to fetch JWKS from ${fetchUrl}: ${response.status}`);
89
+ }
90
+ const body = (await response.json());
91
+ const keys = Array.isArray(body?.keys) ? body.keys : [];
92
+ cachedJwks = {
93
+ fetchedAt: nowFn().getTime(),
94
+ keys,
95
+ };
96
+ return keys;
97
+ }
98
+ finally {
99
+ inFlightJwksFetch = null;
100
+ }
101
+ })();
102
+ return inFlightJwksFetch;
103
+ }
104
+ async function findJwk(kid, alg) {
105
+ let keys = await getJwksKeys(false);
106
+ let match = matchKey(keys, kid, alg);
107
+ if (!match && kid) {
108
+ keys = await getJwksKeys(true);
109
+ match = matchKey(keys, kid, alg);
110
+ }
111
+ return match;
112
+ }
113
+ return async (request) => {
114
+ const token = extractBearerToken(request);
115
+ if (!token)
116
+ return null;
117
+ const parts = token.split('.');
118
+ if (parts.length !== 3)
119
+ return null;
120
+ const [headerB64, payloadB64, signatureB64] = parts;
121
+ if (!headerB64 || !payloadB64 || !signatureB64)
122
+ return null;
123
+ let header;
124
+ let payload;
125
+ let signatureBytes;
126
+ try {
127
+ header = JSON.parse(new TextDecoder().decode(base64UrlDecode(headerB64)));
128
+ payload = JSON.parse(new TextDecoder().decode(base64UrlDecode(payloadB64)));
129
+ signatureBytes = base64UrlDecode(signatureB64);
130
+ }
131
+ catch {
132
+ return null;
133
+ }
134
+ if (typeof header !== 'object' ||
135
+ header === null ||
136
+ typeof payload !== 'object' ||
137
+ payload === null) {
138
+ return null;
139
+ }
140
+ const alg = typeof header.alg === 'string' ? header.alg : '';
141
+ const kid = typeof header.kid === 'string' ? header.kid : undefined;
142
+ const signingInput = new TextEncoder().encode(`${headerB64}.${payloadB64}`);
143
+ let verified = false;
144
+ try {
145
+ if ((alg === 'ES256' || alg === 'RS256') && options.jwksUrl) {
146
+ const jwk = await findJwk(kid, alg);
147
+ if (jwk) {
148
+ verified = await verifyWithJwk(jwk, alg, signingInput, signatureBytes);
149
+ }
150
+ }
151
+ else if (alg === 'HS256' && options.secret) {
152
+ verified = await verifyWithHmacSecret(options.secret, signingInput, signatureBytes);
153
+ }
154
+ }
155
+ catch {
156
+ return null;
157
+ }
158
+ if (!verified)
159
+ return null;
160
+ const nowSec = Math.floor(nowFn().getTime() / 1000);
161
+ if (typeof payload.exp !== 'number' || !Number.isFinite(payload.exp) || nowSec >= payload.exp) {
162
+ return null;
163
+ }
164
+ if (payload.nbf !== undefined) {
165
+ if (typeof payload.nbf !== 'number' || !Number.isFinite(payload.nbf) || nowSec < payload.nbf) {
166
+ return null;
167
+ }
168
+ }
169
+ if (expectedAudience.length > 0 && !matchesAudienceClaim(payload.aud, expectedAudience)) {
170
+ return null;
171
+ }
172
+ if (expectedIssuer.length > 0 && !matchesIssuerClaim(payload.iss, expectedIssuer)) {
173
+ return null;
174
+ }
175
+ const sub = typeof payload.sub === 'string' ? payload.sub.trim() : '';
176
+ if (!sub)
177
+ return null;
178
+ const claims = {
179
+ ...payload,
180
+ sub,
181
+ email: typeof payload.email === 'string' ? payload.email : undefined,
182
+ exp: payload.exp,
183
+ nbf: typeof payload.nbf === 'number' ? payload.nbf : undefined,
184
+ iat: typeof payload.iat === 'number' ? payload.iat : undefined,
185
+ iss: typeof payload.iss === 'string' ? payload.iss : undefined,
186
+ aud: typeof payload.aud === 'string' || Array.isArray(payload.aud)
187
+ ? payload.aud
188
+ : undefined,
189
+ };
190
+ if (options.authorizeUser) {
191
+ const allowed = await options.authorizeUser(claims);
192
+ if (!allowed)
193
+ return null;
194
+ }
195
+ return {
196
+ userId: sub,
197
+ email: claims.email ?? null,
198
+ };
199
+ };
200
+ }
201
+ function normalizeExpectedClaim(value) {
202
+ if (!value)
203
+ return [];
204
+ const list = Array.isArray(value) ? value : [value];
205
+ return list.map((item) => item.trim()).filter((item) => item.length > 0);
206
+ }
207
+ function deriveIssuerFromJwksUrl(jwksUrl) {
208
+ if (!jwksUrl)
209
+ return undefined;
210
+ const trimmed = jwksUrl.trim();
211
+ const suffix = '/.well-known/jwks.json';
212
+ if (trimmed.endsWith(suffix)) {
213
+ return trimmed.slice(0, -suffix.length);
214
+ }
215
+ return undefined;
216
+ }
217
+ function matchesAudienceClaim(audClaim, expectedAudiences) {
218
+ if (typeof audClaim === 'string') {
219
+ return expectedAudiences.includes(audClaim);
220
+ }
221
+ if (Array.isArray(audClaim)) {
222
+ return audClaim.some((item) => typeof item === 'string' && expectedAudiences.includes(item));
223
+ }
224
+ return false;
225
+ }
226
+ function matchesIssuerClaim(issClaim, expectedIssuers) {
227
+ return typeof issClaim === 'string' && expectedIssuers.includes(issClaim);
228
+ }
229
+ function matchKey(keys, kid, alg) {
230
+ const expectedKty = alg === 'ES256' ? 'EC' : 'RSA';
231
+ if (kid) {
232
+ const byKid = keys.find((k) => k.kid === kid && (!k.alg || k.alg === alg) && (!k.kty || k.kty === expectedKty));
233
+ return byKid ?? null;
234
+ }
235
+ const byType = keys.find((k) => (!k.alg || k.alg === alg) && k.kty === expectedKty);
236
+ return byType ?? null;
237
+ }
238
+ async function verifyWithJwk(jwk, alg, signingInput, signatureBytes) {
239
+ if (alg === 'ES256') {
240
+ const cryptoKey = await crypto.subtle.importKey('jwk', jwk, { name: 'ECDSA', namedCurve: 'P-256' }, false, ['verify']);
241
+ return crypto.subtle.verify({ name: 'ECDSA', hash: 'SHA-256' }, cryptoKey, toArrayBuffer(signatureBytes), toArrayBuffer(signingInput));
242
+ }
243
+ const cryptoKey = await crypto.subtle.importKey('jwk', jwk, { name: 'RSASSA-PKCS1-v1_5', hash: 'SHA-256' }, false, ['verify']);
244
+ return crypto.subtle.verify({ name: 'RSASSA-PKCS1-v1_5' }, cryptoKey, toArrayBuffer(signatureBytes), toArrayBuffer(signingInput));
245
+ }
246
+ async function verifyWithHmacSecret(secret, signingInput, signatureBytes) {
247
+ const secretBytes = new TextEncoder().encode(secret);
248
+ const cryptoKey = await crypto.subtle.importKey('raw', toArrayBuffer(secretBytes), { name: 'HMAC', hash: 'SHA-256' }, false, ['verify']);
249
+ return crypto.subtle.verify('HMAC', cryptoKey, toArrayBuffer(signatureBytes), toArrayBuffer(signingInput));
250
+ }
251
+ function base64UrlDecode(input) {
252
+ const base64 = input.replace(/-/g, '+').replace(/_/g, '/');
253
+ const padLength = (4 - (base64.length % 4)) % 4;
254
+ const padded = base64 + '='.repeat(padLength);
255
+ return new Uint8Array(Buffer.from(padded, 'base64'));
256
+ }
257
+ function toArrayBuffer(bytes) {
258
+ return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
259
+ }
260
+ //# sourceMappingURL=auth.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"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"}
package/dist/cli.d.ts ADDED
@@ -0,0 +1,18 @@
1
+ #!/usr/bin/env node
2
+ import { type ModKitStore } from './store.js';
3
+ export type ClosableModKitStore = ModKitStore & {
4
+ close?: () => Promise<void>;
5
+ };
6
+ export interface CliIo {
7
+ stdout?: ((line: string) => void) | undefined;
8
+ stderr?: ((line: string) => void) | undefined;
9
+ fetchImpl?: typeof globalThis.fetch | undefined;
10
+ cwd?: string | undefined;
11
+ storeFactory?: ((dbUrl: string) => ClosableModKitStore) | undefined;
12
+ }
13
+ /**
14
+ * Executes a `modkit` / `modkit-server` CLI command and returns a POSIX exit code (`0` on success, `1` on error).
15
+ */
16
+ export declare function runCli(argv: string[], io?: CliIo): Promise<number>;
17
+ export declare function isCliEntrypoint(argv1: string | undefined, moduleUrl: string): boolean;
18
+ //# sourceMappingURL=cli.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAOA,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,YAAY,CAAA;AAInB,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAA;AAE/E,MAAM,WAAW,KAAK;IACpB,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;IAC7C,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;IAC7C,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,SAAS,CAAA;IAC/C,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxB,YAAY,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,mBAAmB,CAAC,GAAG,SAAS,CAAA;CACpE;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAE,KAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA4Q5E;AA6CD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAQrF"}
package/dist/cli.js ADDED
@@ -0,0 +1,306 @@
1
+ #!/usr/bin/env node
2
+ import { realpathSync } from 'node:fs';
3
+ import { constants, copyFile, mkdir, readdir } from 'node:fs/promises';
4
+ import { dirname, join, resolve } from 'node:path';
5
+ import { fileURLToPath } from 'node:url';
6
+ import { runConformanceSuite } from './conformance.js';
7
+ import { postgresStore } from './postgresStore.js';
8
+ import { MODKIT_REPORT_STATUSES, } from './store.js';
9
+ const VALID_ACTIONS = new Set(['remove', 'dismiss', 'ban']);
10
+ /**
11
+ * Executes a `modkit` / `modkit-server` CLI command and returns a POSIX exit code (`0` on success, `1` on error).
12
+ */
13
+ export async function runCli(argv, io = {}) {
14
+ const stdout = io.stdout ?? ((line) => console.log(line));
15
+ const stderr = io.stderr ?? ((line) => console.error(line));
16
+ const fetchFn = io.fetchImpl ?? globalThis.fetch;
17
+ const cwd = io.cwd ?? process.cwd();
18
+ const createStore = io.storeFactory ?? ((url) => postgresStore({ url, max: 1, prepare: false, fetchTypes: false }));
19
+ try {
20
+ const [group, subcommand, ...rest] = argv;
21
+ if (!group || group === '--help' || group === '-h' || group === 'help') {
22
+ printUsage(stdout);
23
+ return 0;
24
+ }
25
+ if (group === 'migrations') {
26
+ if (subcommand === 'copy') {
27
+ const targetDirArg = rest[0];
28
+ if (!targetDirArg) {
29
+ stderr('Error: Usage: modkit migrations copy <dest-dir>');
30
+ return 1;
31
+ }
32
+ const targetDir = resolve(cwd, targetDirArg);
33
+ await mkdir(targetDir, { recursive: true });
34
+ const migrationsDir = resolve(dirname(fileURLToPath(import.meta.url)), '..', 'migrations');
35
+ const entries = await readdir(migrationsDir);
36
+ const sqlFiles = entries.filter((f) => f.endsWith('.sql')).sort();
37
+ if (sqlFiles.length === 0) {
38
+ stderr('Error: No SQL migration files found.');
39
+ return 1;
40
+ }
41
+ for (const file of sqlFiles) {
42
+ const srcPath = join(migrationsDir, file);
43
+ const destPath = join(targetDir, file);
44
+ try {
45
+ await copyFile(srcPath, destPath, constants.COPYFILE_EXCL);
46
+ }
47
+ catch (error) {
48
+ if (error?.code === 'EEXIST') {
49
+ stderr(`Error: Migration file already exists at destination: ${destPath}`);
50
+ return 1;
51
+ }
52
+ throw error;
53
+ }
54
+ stdout(`Copied ${file} -> ${destPath}`);
55
+ }
56
+ return 0;
57
+ }
58
+ stderr(`Error: Unknown migrations subcommand: ${subcommand ?? ''}`);
59
+ return 1;
60
+ }
61
+ if (group === 'reports') {
62
+ if (subcommand === 'list') {
63
+ const { flags } = parseFlags(rest);
64
+ const dbUrl = flags.get('db') ?? process.env.DATABASE_URL;
65
+ if (!dbUrl) {
66
+ stderr('Error: Missing --db <url> (or DATABASE_URL). Usage: modkit reports list --db <url> [--status open|actioned|dismissed]');
67
+ return 1;
68
+ }
69
+ const statusRaw = flags.get('status');
70
+ let statusFilter;
71
+ if (statusRaw !== undefined) {
72
+ if (!MODKIT_REPORT_STATUSES.includes(statusRaw)) {
73
+ stderr(`Error: Invalid --status "${statusRaw}". Allowed: ${MODKIT_REPORT_STATUSES.join(', ')}`);
74
+ return 1;
75
+ }
76
+ statusFilter = statusRaw;
77
+ }
78
+ const store = createStore(dbUrl);
79
+ try {
80
+ const reports = await store.listReports({ status: statusFilter });
81
+ if (reports.length === 0) {
82
+ stdout('No reports found.');
83
+ return 0;
84
+ }
85
+ for (const r of reports) {
86
+ stdout(`${r.id}\t${r.status}\t${r.reason}\t${r.target_type}/${r.target_id}\tauthor=${r.target_author_id ?? 'unknown'}\treporter=${r.reporter_id}\t${r.created_at}`);
87
+ }
88
+ stdout(`Listed ${reports.length} report(s).`);
89
+ return 0;
90
+ }
91
+ finally {
92
+ await store.close?.();
93
+ }
94
+ }
95
+ if (subcommand === 'resolve') {
96
+ const { positional, flags } = parseFlags(rest);
97
+ const reportId = positional[0];
98
+ const actionRaw = flags.get('action');
99
+ const note = flags.get('note') ?? null;
100
+ const resolvedBy = flags.get('by') ?? 'cli';
101
+ const dbUrl = flags.get('db') ?? process.env.DATABASE_URL;
102
+ if (!reportId || !actionRaw || !dbUrl) {
103
+ stderr('Error: Usage: modkit reports resolve <report-id> --action <remove|dismiss|ban> [--note "..."] --db <url>');
104
+ return 1;
105
+ }
106
+ if (!VALID_ACTIONS.has(actionRaw)) {
107
+ stderr('Error: --action must be one of: remove, dismiss, ban');
108
+ return 1;
109
+ }
110
+ const store = createStore(dbUrl);
111
+ try {
112
+ const resolved = await store.resolveReport({
113
+ reportId,
114
+ action: actionRaw,
115
+ note,
116
+ resolvedBy,
117
+ });
118
+ if (!resolved) {
119
+ stderr(`Error: Report "${reportId}" not found.`);
120
+ return 1;
121
+ }
122
+ stdout(`Resolved report ${resolved.id} -> status=${resolved.status} (action=${actionRaw})`);
123
+ return 0;
124
+ }
125
+ finally {
126
+ await store.close?.();
127
+ }
128
+ }
129
+ stderr(`Error: Unknown reports subcommand: ${subcommand ?? ''}`);
130
+ return 1;
131
+ }
132
+ if (group === 'bans') {
133
+ if (subcommand === 'add') {
134
+ const { positional, flags } = parseFlags(rest);
135
+ const userId = positional[0];
136
+ const reason = flags.get('reason');
137
+ const bannedBy = flags.get('by') ?? 'cli';
138
+ const expiresAt = flags.get('expires-at') ?? null;
139
+ const dbUrl = flags.get('db') ?? process.env.DATABASE_URL;
140
+ if (!userId || !reason || !dbUrl) {
141
+ stderr('Error: Usage: modkit bans add <user-id> --reason "..." --db <url>');
142
+ return 1;
143
+ }
144
+ const store = createStore(dbUrl);
145
+ try {
146
+ const ban = await store.addBan({
147
+ userId,
148
+ reason,
149
+ bannedBy,
150
+ expiresAt,
151
+ });
152
+ stdout(`Banned user ${ban.user_id} (reason: ${ban.reason})`);
153
+ return 0;
154
+ }
155
+ finally {
156
+ await store.close?.();
157
+ }
158
+ }
159
+ if (subcommand === 'remove') {
160
+ const { positional, flags } = parseFlags(rest);
161
+ const userId = positional[0];
162
+ const dbUrl = flags.get('db') ?? process.env.DATABASE_URL;
163
+ if (!userId || !dbUrl) {
164
+ stderr('Error: Usage: modkit bans remove <user-id> --db <url>');
165
+ return 1;
166
+ }
167
+ const store = createStore(dbUrl);
168
+ try {
169
+ const removed = await store.removeBan(userId);
170
+ if (!removed) {
171
+ stderr(`Error: No active ban found for user "${userId}".`);
172
+ return 1;
173
+ }
174
+ stdout(`Removed ban for user ${userId}`);
175
+ return 0;
176
+ }
177
+ finally {
178
+ await store.close?.();
179
+ }
180
+ }
181
+ if (subcommand === 'list') {
182
+ const { flags } = parseFlags(rest);
183
+ const dbUrl = flags.get('db') ?? process.env.DATABASE_URL;
184
+ if (!dbUrl) {
185
+ stderr('Error: Usage: modkit bans list --db <url>');
186
+ return 1;
187
+ }
188
+ const store = createStore(dbUrl);
189
+ try {
190
+ const bans = await store.listBans();
191
+ if (bans.length === 0) {
192
+ stdout('No bans found.');
193
+ return 0;
194
+ }
195
+ for (const b of bans) {
196
+ stdout(`${b.user_id}\t${b.reason}\tcreated=${b.created_at}\texpires=${b.expires_at ?? 'never'}`);
197
+ }
198
+ return 0;
199
+ }
200
+ finally {
201
+ await store.close?.();
202
+ }
203
+ }
204
+ stderr(`Error: Unknown bans subcommand: ${subcommand ?? ''}`);
205
+ return 1;
206
+ }
207
+ if (group === 'conformance') {
208
+ const allArgs = subcommand ? [subcommand, ...rest] : rest;
209
+ const { flags } = parseFlags(allArgs);
210
+ const serverUrl = flags.get('server');
211
+ if (!serverUrl) {
212
+ stderr('Error: Usage: modkit conformance --server <url> [--token <jwt>] [--webhook-secret <secret>]');
213
+ return 1;
214
+ }
215
+ const userAToken = flags.get('token') ?? process.env.MODKIT_TEST_TOKEN ?? 'test-user-a-token';
216
+ const webhookSecret = flags.get('webhook-secret') ?? process.env.MODKIT_WEBHOOK_SECRET;
217
+ const result = await runConformanceSuite({
218
+ baseUrl: serverUrl,
219
+ userAToken,
220
+ webhookSecret,
221
+ fetch: fetchFn,
222
+ });
223
+ for (const step of result.steps) {
224
+ if (step.ok) {
225
+ stdout(`✓ ${step.name}`);
226
+ }
227
+ else {
228
+ stderr(`✗ ${step.name}: ${step.detail ?? 'failed'}`);
229
+ }
230
+ }
231
+ if (!result.ok) {
232
+ stderr('Conformance suite failed.');
233
+ return 1;
234
+ }
235
+ stdout(`Conformance suite passed (${result.steps.length} steps).`);
236
+ return 0;
237
+ }
238
+ stderr(`Error: Unknown command "${group}". Run "modkit --help" for usage.`);
239
+ return 1;
240
+ }
241
+ catch (error) {
242
+ const message = error instanceof Error ? error.message : String(error);
243
+ stderr(`Error: ${message}`);
244
+ return 1;
245
+ }
246
+ }
247
+ function parseFlags(args) {
248
+ const positional = [];
249
+ const flags = new Map();
250
+ for (let i = 0; i < args.length; i++) {
251
+ const arg = args[i];
252
+ if (arg.startsWith('--')) {
253
+ const eqIdx = arg.indexOf('=');
254
+ if (eqIdx >= 0) {
255
+ const key = arg.slice(2, eqIdx);
256
+ const val = arg.slice(eqIdx + 1);
257
+ flags.set(key, val);
258
+ }
259
+ else {
260
+ const key = arg.slice(2);
261
+ const next = args[i + 1];
262
+ if (next !== undefined && !next.startsWith('--')) {
263
+ flags.set(key, next);
264
+ i += 1;
265
+ }
266
+ else {
267
+ flags.set(key, 'true');
268
+ }
269
+ }
270
+ }
271
+ else {
272
+ positional.push(arg);
273
+ }
274
+ }
275
+ return { positional, flags };
276
+ }
277
+ function printUsage(stdout) {
278
+ stdout(`ModKit v1 Operator CLI
279
+
280
+ Usage:
281
+ modkit migrations copy <dest-dir>
282
+ modkit reports list --db <url> [--status open|actioned|dismissed]
283
+ modkit reports resolve <report-id> --action <remove|dismiss|ban> [--note "..."] --db <url>
284
+ modkit bans add <user-id> --reason "..." [--expires-at <iso>] --db <url>
285
+ modkit bans remove <user-id> --db <url>
286
+ modkit bans list --db <url>
287
+ modkit conformance --server <url> [--token <jwt>] [--webhook-secret <secret>]`);
288
+ }
289
+ export function isCliEntrypoint(argv1, moduleUrl) {
290
+ if (!argv1)
291
+ return false;
292
+ const modulePath = fileURLToPath(moduleUrl);
293
+ try {
294
+ return realpathSync(argv1) === realpathSync(modulePath);
295
+ }
296
+ catch {
297
+ return resolve(argv1) === resolve(modulePath);
298
+ }
299
+ }
300
+ const isMain = isCliEntrypoint(process.argv[1], import.meta.url);
301
+ if (isMain) {
302
+ runCli(process.argv.slice(2)).then((code) => {
303
+ process.exitCode = code;
304
+ });
305
+ }
306
+ //# sourceMappingURL=cli.js.map