@fivepixels-js/lite-api 0.2.1

package/dist/cli/cli.js

@@ -0,0 +1,132 @@
+import { parseArgs } from 'node:util';
+import { ConfigError, loadConfig } from '../config/config.js';
+import { PACKAGE_VERSION } from '../version.js';
+import { runBackupCommand } from './commands/backup.js';
+import { runInitCommand } from './commands/init.js';
+import { runMigrateCommand } from './commands/migrate.js';
+import { runStartCommand } from './commands/start.js';
+import { runStatusCommand } from './commands/status.js';
+import { consoleIo } from './io.js';
+const HELP = `Fivepixels Lite API ${PACKAGE_VERSION}
+
+Usage:
+  fivepixels-lite-api <command> [options]
+  fivepixels-lite-api --version
+  fivepixels-lite-api --help
+
+Commands:
+  fivepixels-lite-api init       Initialize the data directory and database
+  fivepixels-lite-api start      Run migrations and start the API server
+  fivepixels-lite-api status     Check HTTP, database, and migration status
+  fivepixels-lite-api backup     Create an online SQLite backup
+  fivepixels-lite-api migrate    Apply pending database migrations
+
+Options:
+  --host <host>                  Listen host (default: 127.0.0.1)
+  --port <port>                  Listen port (default: 3000)
+  --db-path <path>               SQLite database path
+  --log-level <level>            fatal|error|warn|info|debug|trace|silent
+  --cors-origin <origins>        Comma-separated exact origins
+  --docs-enabled <true|false>    Enable or disable Swagger documentation
+  --admin-token-file <path>      Read the admin token from a file
+  --jwt-secret-file <path>       Read the JWT signing secret from a file
+  --registration-enabled <bool> Enable or disable local account registration
+  --trust-proxy <addresses>      Comma-separated trusted proxy IPs or CIDRs
+  --output <path>                Backup output path (backup only)
+  -h, --help                     Show this help
+  -v, --version                  Show the package version
+`;
+function toOverrides(values) {
+    const overrides = {};
+    if (typeof values.host === 'string')
+        overrides.host = values.host;
+    if (typeof values.port === 'string')
+        overrides.port = values.port;
+    if (typeof values['db-path'] === 'string')
+        overrides.dbPath = values['db-path'];
+    if (typeof values['log-level'] === 'string')
+        overrides.logLevel = values['log-level'];
+    if (typeof values['cors-origin'] === 'string')
+        overrides.corsOrigin = values['cors-origin'];
+    if (typeof values['docs-enabled'] === 'string')
+        overrides.docsEnabled = values['docs-enabled'];
+    if (typeof values['admin-token-file'] === 'string') {
+        overrides.adminTokenFile = values['admin-token-file'];
+    }
+    if (typeof values['jwt-secret-file'] === 'string') {
+        overrides.jwtSecretFile = values['jwt-secret-file'];
+    }
+    if (typeof values['registration-enabled'] === 'string') {
+        overrides.registrationEnabled = values['registration-enabled'];
+    }
+    if (typeof values['trust-proxy'] === 'string')
+        overrides.trustProxy = values['trust-proxy'];
+    return overrides;
+}
+export async function runCli(arguments_, environment = process.env, io = consoleIo) {
+    try {
+        const { positionals, values } = parseArgs({
+            args: arguments_,
+            allowPositionals: true,
+            strict: true,
+            options: {
+                'admin-token-file': { type: 'string' },
+                'cors-origin': { type: 'string' },
+                'db-path': { type: 'string' },
+                'docs-enabled': { type: 'string' },
+                help: { type: 'boolean', short: 'h' },
+                host: { type: 'string' },
+                'jwt-secret-file': { type: 'string' },
+                'log-level': { type: 'string' },
+                output: { type: 'string' },
+                port: { type: 'string' },
+                'registration-enabled': { type: 'string' },
+                'trust-proxy': { type: 'string' },
+                version: { type: 'boolean', short: 'v' },
+            },
+        });
+        if (values.version === true) {
+            io.output(PACKAGE_VERSION);
+            return 0;
+        }
+        if (values.help === true) {
+            io.output(HELP);
+            return 0;
+        }
+        const command = positionals[0];
+        if (command === undefined) {
+            io.error('A command is required. Use --help for usage.');
+            return 2;
+        }
+        if (positionals.length > 1) {
+            io.error('Unexpected positional arguments. Use --help for usage.');
+            return 2;
+        }
+        if (values.output !== undefined && command !== 'backup') {
+            io.error('--output can only be used with the backup command.');
+            return 2;
+        }
+        const config = loadConfig(toOverrides(values), environment);
+        switch (command) {
+            case 'init':
+                return await runInitCommand(config, io);
+            case 'start':
+                return await runStartCommand(config, io);
+            case 'status':
+                return await runStatusCommand(config, io);
+            case 'backup':
+                return await runBackupCommand(config, values.output, io);
+            case 'migrate':
+                return await runMigrateCommand(config, io);
+            default:
+                io.error(`Unknown command: ${command}. Use --help for usage.`);
+                return 2;
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error.';
+        io.error(message);
+        return error instanceof ConfigError || error instanceof TypeError ? 2 : 1;
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli/cli.js.map

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

package/dist/cli/commands/backup.d.ts

@@ -0,0 +1,4 @@
+import type { AppConfig } from '../../config/config.js';
+import type { CommandIo } from '../io.js';
+export declare function runBackupCommand(config: AppConfig, outputPath: string | undefined, io: CommandIo): Promise<number>;
+//# sourceMappingURL=backup.d.ts.map

package/dist/cli/commands/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/backup.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,EAAE,EAAE,SAAS,GACZ,OAAO,CAAC,MAAM,CAAC,CAiBjB"}

package/dist/cli/commands/backup.js

@@ -0,0 +1,24 @@
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { createBackup, getDefaultBackupPath } from '../../db/backup.js';
+import { openDatabase } from '../../db/connection.js';
+export async function runBackupCommand(config, outputPath, io) {
+    if (!existsSync(config.dbPath)) {
+        throw new Error('Database has not been initialized.');
+    }
+    const destination = outputPath === undefined
+        ? getDefaultBackupPath(config.dbPath)
+        : resolve(outputPath);
+    const database = openDatabase(config.dbPath, { fileMustExist: true });
+    try {
+        const result = await createBackup(database, destination);
+        io.output(`Backup: ${result.path}`);
+        io.output(`Pages: ${result.totalPages}`);
+        return 0;
+    }
+    finally {
+        if (database.open)
+            database.close();
+    }
+}
+//# sourceMappingURL=backup.js.map

package/dist/cli/commands/backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.js","sourceRoot":"","sources":["../../../src/cli/commands/backup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGtD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAiB,EACjB,UAA8B,EAC9B,EAAa;IAEb,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,WAAW,GAAG,UAAU,KAAK,SAAS;QAC1C,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC;QACrC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACxB,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACzD,EAAE,CAAC,MAAM,CAAC,WAAW,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACpC,EAAE,CAAC,MAAM,CAAC,UAAU,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,CAAC;IACX,CAAC;YAAS,CAAC;QACT,IAAI,QAAQ,CAAC,IAAI;YAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,4 @@
+import type { AppConfig } from '../../config/config.js';
+import type { CommandIo } from '../io.js';
+export declare function runInitCommand(config: AppConfig, io: CommandIo): Promise<number>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAIxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,wBAAsB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAetF"}

package/dist/cli/commands/init.js

@@ -0,0 +1,23 @@
+import { ensureJwtSecret } from '../../config/jwt-secret.js';
+import { openDatabase } from '../../db/connection.js';
+import { migrateDatabase } from '../../db/migrate.js';
+export async function runInitCommand(config, io) {
+    const readyConfig = ensureJwtSecret(config);
+    const database = openDatabase(readyConfig.dbPath);
+    try {
+        const result = await migrateDatabase(database, { dbPath: readyConfig.dbPath });
+        io.output(`Database: ${readyConfig.dbPath}`);
+        io.output(`Schema version: ${result.currentVersion}`);
+        io.output(result.appliedVersions.length === 0
+            ? 'Database is already initialized.'
+            : `Applied migrations: ${result.appliedVersions.join(', ')}`);
+        if (result.backupPath !== undefined)
+            io.output(`Backup: ${result.backupPath}`);
+        return 0;
+    }
+    finally {
+        if (database.open)
+            database.close();
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAiB,EAAE,EAAa;IACnE,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,YAAY,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/E,EAAE,CAAC,MAAM,CAAC,aAAa,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7C,EAAE,CAAC,MAAM,CAAC,mBAAmB,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QACtD,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC;YAC3C,CAAC,CAAC,kCAAkC;YACpC,CAAC,CAAC,uBAAuB,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChE,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;YAAE,EAAE,CAAC,MAAM,CAAC,WAAW,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QAC/E,OAAO,CAAC,CAAC;IACX,CAAC;YAAS,CAAC;QACT,IAAI,QAAQ,CAAC,IAAI;YAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/cli/commands/migrate.d.ts

@@ -0,0 +1,4 @@
+import type { AppConfig } from '../../config/config.js';
+import type { CommandIo } from '../io.js';
+export declare function runMigrateCommand(config: AppConfig, io: CommandIo): Promise<number>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/cli/commands/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAazF"}

package/dist/cli/commands/migrate.js

@@ -0,0 +1,20 @@
+import { openDatabase } from '../../db/connection.js';
+import { migrateDatabase } from '../../db/migrate.js';
+export async function runMigrateCommand(config, io) {
+    const database = openDatabase(config.dbPath);
+    try {
+        const result = await migrateDatabase(database, { dbPath: config.dbPath });
+        io.output(`Schema version: ${result.currentVersion}`);
+        io.output(result.appliedVersions.length === 0
+            ? 'No pending migrations.'
+            : `Applied migrations: ${result.appliedVersions.join(', ')}`);
+        if (result.backupPath !== undefined)
+            io.output(`Backup: ${result.backupPath}`);
+        return 0;
+    }
+    finally {
+        if (database.open)
+            database.close();
+    }
+}
+//# sourceMappingURL=migrate.js.map

package/dist/cli/commands/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../../src/cli/commands/migrate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAiB,EAAE,EAAa;IACtE,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1E,EAAE,CAAC,MAAM,CAAC,mBAAmB,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QACtD,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC;YAC3C,CAAC,CAAC,wBAAwB;YAC1B,CAAC,CAAC,uBAAuB,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChE,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;YAAE,EAAE,CAAC,MAAM,CAAC,WAAW,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QAC/E,OAAO,CAAC,CAAC;IACX,CAAC;YAAS,CAAC;QACT,IAAI,QAAQ,CAAC,IAAI;YAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/cli/commands/start.d.ts

@@ -0,0 +1,4 @@
+import { type AppConfig } from '../../config/config.js';
+import type { CommandIo } from '../io.js';
+export declare function runStartCommand(config: AppConfig, io: CommandIo): Promise<number>;
+//# sourceMappingURL=start.d.ts.map

package/dist/cli/commands/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAG7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,wBAAsB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAQvF"}

package/dist/cli/commands/start.js

@@ -0,0 +1,13 @@
+import { assertStartSecurity } from '../../config/config.js';
+import { ensureJwtSecret } from '../../config/jwt-secret.js';
+import { installShutdownHandlers, startServer } from '../../server.js';
+export async function runStartCommand(config, io) {
+    io.error('Warning: SQLite DB_PATH must use local storage; NFS and SMB paths are unsupported.');
+    // Reject an unsafe external bind before creating the managed JWT key or database.
+    assertStartSecurity(config);
+    const started = await startServer(ensureJwtSecret(config));
+    installShutdownHandlers(started.app);
+    io.output(`Listening: ${started.address}`);
+    return 0;
+}
+//# sourceMappingURL=start.js.map

package/dist/cli/commands/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../src/cli/commands/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAkB,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGvE,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAiB,EAAE,EAAa;IACpE,EAAE,CAAC,KAAK,CAAC,oFAAoF,CAAC,CAAC;IAC/F,kFAAkF;IAClF,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,uBAAuB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,EAAE,CAAC,MAAM,CAAC,cAAc,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cli/commands/status.d.ts

@@ -0,0 +1,4 @@
+import type { AppConfig } from '../../config/config.js';
+import type { CommandIo } from '../io.js';
+export declare function runStatusCommand(config: AppConfig, io: CommandIo): Promise<number>;
+//# sourceMappingURL=status.d.ts.map

package/dist/cli/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/status.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAmB1C,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBxF"}

package/dist/cli/commands/status.js

@@ -0,0 +1,48 @@
+import { existsSync } from 'node:fs';
+import { getSqliteVersion, openDatabase } from '../../db/connection.js';
+import { getMigrationStatus } from '../../db/migrate.js';
+function statusHost(host) {
+    if (host === '0.0.0.0' || host === '::')
+        return '127.0.0.1';
+    return host.includes(':') && !host.startsWith('[') ? `[${host}]` : host;
+}
+async function checkHttp(config) {
+    const url = `http://${statusHost(config.host)}:${config.port}/health`;
+    try {
+        const response = await fetch(url, { signal: AbortSignal.timeout(3_000) });
+        if (!response.ok)
+            return false;
+        const body = await response.json();
+        return body.status === 'ok' && body.database === 'ok';
+    }
+    catch {
+        return false;
+    }
+}
+export async function runStatusCommand(config, io) {
+    const httpHealthy = await checkHttp(config);
+    io.output(`HTTP: ${httpHealthy ? 'healthy' : 'unavailable'}`);
+    if (!existsSync(config.dbPath)) {
+        io.output(`Database: missing (${config.dbPath})`);
+        return 1;
+    }
+    try {
+        const database = openDatabase(config.dbPath, { fileMustExist: true, readonly: true });
+        try {
+            const status = getMigrationStatus(database);
+            io.output(`Database: available (${config.dbPath})`);
+            io.output(`SQLite version: ${getSqliteVersion(database)}`);
+            io.output(`Schema version: ${status.currentVersion}`);
+            io.output(`Pending migrations: ${status.pending.length}`);
+            return httpHealthy && status.pending.length === 0 ? 0 : 1;
+        }
+        finally {
+            database.close();
+        }
+    }
+    catch {
+        io.output(`Database: unavailable (${config.dbPath})`);
+        return 1;
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/cli/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGzD,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IAC5D,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1E,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,MAAiB;IACxC,MAAM,GAAG,GAAG,UAAU,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,SAAS,CAAC;IACtE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,KAAK,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA8C,CAAC;QAC/E,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAiB,EAAE,EAAa;IACrE,MAAM,WAAW,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5C,EAAE,CAAC,MAAM,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC;IAE9D,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,EAAE,CAAC,MAAM,CAAC,sBAAsB,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAClD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACtF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;YAC5C,EAAE,CAAC,MAAM,CAAC,wBAAwB,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;YACpD,EAAE,CAAC,MAAM,CAAC,mBAAmB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC3D,EAAE,CAAC,MAAM,CAAC,mBAAmB,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;YACtD,EAAE,CAAC,MAAM,CAAC,uBAAuB,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1D,OAAO,WAAW,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,CAAC;gBAAS,CAAC;YACT,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,EAAE,CAAC,MAAM,CAAC,0BAA0B,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACtD,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runCli } from './cli.js';
+process.exitCode = await runCli(process.argv.slice(2));
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,CAAC,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/cli/io.d.ts

@@ -0,0 +1,6 @@
+export interface CommandIo {
+    error(message: string): void;
+    output(message: string): void;
+}
+export declare const consoleIo: CommandIo;
+//# sourceMappingURL=io.d.ts.map

package/dist/cli/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/cli/io.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,eAAO,MAAM,SAAS,EAAE,SAOvB,CAAC"}

package/dist/cli/io.js

@@ -0,0 +1,9 @@
+export const consoleIo = {
+    error(message) {
+        console.error(message);
+    },
+    output(message) {
+        console.log(message);
+    },
+};
+//# sourceMappingURL=io.js.map

package/dist/cli/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../../src/cli/io.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,SAAS,GAAc;IAClC,KAAK,CAAC,OAAO;QACX,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,CAAC,OAAO;QACZ,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;CACF,CAAC"}

package/dist/community/contracts.d.ts

@@ -0,0 +1,29 @@
+export interface PaginationMetadata {
+    hasNext: boolean;
+    hasPrevious: boolean;
+    page: number;
+    pageSize: number;
+    totalCount: number;
+    totalPages: number;
+}
+export interface CommunityApiResponse<T> {
+    pagination: PaginationMetadata;
+    result: T | null;
+    resultCode: string;
+    resultMessage: string;
+}
+export interface PageRequest {
+    page: number;
+    pageSize: number;
+}
+export declare const EMPTY_PAGINATION: PaginationMetadata;
+export declare function pageMetadata(page: number, pageSize: number, totalCount: number): PaginationMetadata;
+export declare function successResponse<T>(result: T, pagination?: PaginationMetadata, resultMessage?: string): CommunityApiResponse<T>;
+export declare function failureResponse(resultCode: string, resultMessage: string): CommunityApiResponse<never>;
+export declare function parsePageRequest(pageValue: unknown, pageSizeValue: unknown): PageRequest;
+export type JsonObject = Record<string, unknown>;
+export interface PageQuery {
+    page?: number;
+    pageSize?: number;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/community/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/community/contracts.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,UAAU,EAAE,kBAAkB,CAAC;IAC/B,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,gBAAgB,EAAE,kBAO7B,CAAC;AAEH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,kBAAkB,CAUnG;AAED,wBAAgB,eAAe,CAAC,CAAC,EAC/B,MAAM,EAAE,CAAC,EACT,UAAU,GAAE,kBAAqC,EACjD,aAAa,SAAK,GACjB,oBAAoB,CAAC,CAAC,CAAC,CAEzB;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAEtG;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,GAAG,WAAW,CAaxF;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,MAAM,WAAW,SAAS;IAAG,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE"}

package/dist/community/contracts.js

@@ -0,0 +1,41 @@
+import { CommunityApiError } from './errors.js';
+export const EMPTY_PAGINATION = Object.freeze({
+    page: 0,
+    pageSize: 0,
+    totalCount: 0,
+    totalPages: 0,
+    hasNext: false,
+    hasPrevious: false,
+});
+export function pageMetadata(page, pageSize, totalCount) {
+    const totalPages = pageSize <= 0 ? 0 : Math.ceil(totalCount / pageSize);
+    return {
+        page,
+        pageSize,
+        totalCount,
+        totalPages,
+        hasNext: page < totalPages,
+        hasPrevious: page > 1 && totalPages > 0,
+    };
+}
+export function successResponse(result, pagination = EMPTY_PAGINATION, resultMessage = '') {
+    return { resultCode: 'SUCCESS', resultMessage, result, pagination };
+}
+export function failureResponse(resultCode, resultMessage) {
+    return { resultCode, resultMessage, result: null, pagination: EMPTY_PAGINATION };
+}
+export function parsePageRequest(pageValue, pageSizeValue) {
+    const page = pageValue === undefined ? 1 : Number(pageValue);
+    const pageSize = pageSizeValue === undefined ? 20 : Number(pageSizeValue);
+    if (!Number.isSafeInteger(page) || page < 1) {
+        throw new CommunityApiError(400, 'invalid-page', 'page는 1 이상이어야 합니다.');
+    }
+    if (!Number.isSafeInteger(pageSize) || pageSize < 1 || pageSize > 100) {
+        throw new CommunityApiError(400, 'invalid-page-size', 'pageSize는 1 이상 100 이하여야 합니다.');
+    }
+    if (!Number.isSafeInteger((page - 1) * pageSize)) {
+        throw new CommunityApiError(400, 'invalid-page', 'page 값이 허용 범위를 초과합니다.');
+    }
+    return { page, pageSize };
+}
+//# sourceMappingURL=contracts.js.map

package/dist/community/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/community/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAuBhD,MAAM,CAAC,MAAM,gBAAgB,GAAuB,MAAM,CAAC,MAAM,CAAC;IAChE,IAAI,EAAE,CAAC;IACP,QAAQ,EAAE,CAAC;IACX,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,CAAC;IACb,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,KAAK;CACnB,CAAC,CAAC;AAEH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,QAAgB,EAAE,UAAkB;IAC7E,MAAM,UAAU,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,CAAC;IACxE,OAAO;QACL,IAAI;QACJ,QAAQ;QACR,UAAU;QACV,UAAU;QACV,OAAO,EAAE,IAAI,GAAG,UAAU;QAC1B,WAAW,EAAE,IAAI,GAAG,CAAC,IAAI,UAAU,GAAG,CAAC;KACxC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,MAAS,EACT,aAAiC,gBAAgB,EACjD,aAAa,GAAG,EAAE;IAElB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,UAAkB,EAAE,aAAqB;IACvE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAkB,EAAE,aAAsB;IACzE,MAAM,IAAI,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC1E,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,oBAAoB,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,GAAG,EAAE,CAAC;QACtE,MAAM,IAAI,iBAAiB,CAAC,GAAG,EAAE,mBAAmB,EAAE,8BAA8B,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,uBAAuB,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC"}

package/dist/community/error-handler.d.ts

@@ -0,0 +1,3 @@
+import type { FastifyInstance } from 'fastify';
+export declare function registerCommunityErrorHandlers(app: FastifyInstance): void;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/community/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/community/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAkC7E,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,CAmFzE"}

package/dist/community/error-handler.js

@@ -0,0 +1,66 @@
+import { failureResponse } from './contracts.js';
+import { CommunityApiError, isSqliteBusyError, isSqliteError, sqliteConstraintKind, } from './errors.js';
+function errorDetails(error) {
+    return typeof error === 'object' && error !== null ? error : {};
+}
+function sendFailure(reply, statusCode, resultCode, resultMessage) {
+    void reply.code(statusCode).send(failureResponse(resultCode, resultMessage));
+}
+export function registerCommunityErrorHandlers(app) {
+    app.setNotFoundHandler((_request, reply) => {
+        sendFailure(reply, 404, 'NOT_FOUND', '요청한 리소스를 찾을 수 없습니다.');
+    });
+    app.setErrorHandler((error, request, reply) => {
+        if (error instanceof CommunityApiError) {
+            if (error.statusCode >= 500) {
+                request.log.error({ err: error, resultCode: error.resultCode }, 'Community API request failed');
+            }
+            else {
+                request.log.warn({ resultCode: error.resultCode }, 'Community API request rejected');
+            }
+            if (error.statusCode === 401) {
+                void reply.header('WWW-Authenticate', 'Bearer');
+            }
+            sendFailure(reply, error.statusCode, error.resultCode, error.message);
+            return;
+        }
+        const knownError = errorDetails(error);
+        if (knownError.validation !== undefined || knownError.statusCode === 400) {
+            sendFailure(reply, 400, 'BAD_REQUEST', '요청 값이 올바르지 않습니다.');
+            return;
+        }
+        if (knownError.code === 'FST_ERR_CTP_BODY_TOO_LARGE') {
+            sendFailure(reply, 413, 'BAD_REQUEST', '요청 본문이 너무 큽니다.');
+            return;
+        }
+        if (knownError.statusCode === 429) {
+            sendFailure(reply, 429, 'TOO_MANY_REQUESTS', '요청이 너무 많습니다. 잠시 후 다시 시도해 주세요.');
+            return;
+        }
+        if (isSqliteBusyError(error)) {
+            request.log.warn({ err: error }, 'SQLite is busy');
+            void reply.header('Retry-After', '1');
+            sendFailure(reply, 503, 'SERVICE_BUSY', '서비스가 일시적으로 사용 중입니다.');
+            return;
+        }
+        const constraintKind = sqliteConstraintKind(error);
+        if (constraintKind === 'conflict') {
+            request.log.warn({ sqliteConstraint: constraintKind }, 'SQLite constraint rejected request');
+            sendFailure(reply, 409, 'resource-conflict', '동일한 값의 리소스가 이미 존재합니다.');
+            return;
+        }
+        if (constraintKind === 'constraint') {
+            request.log.warn({ sqliteConstraint: constraintKind }, 'SQLite constraint rejected request');
+            sendFailure(reply, 409, 'constraint-conflict', '연관 데이터 또는 상태 제약조건으로 요청을 처리할 수 없습니다.');
+            return;
+        }
+        if (isSqliteError(error)) {
+            request.log.error({ err: error }, 'SQLite request failed');
+            sendFailure(reply, 500, 'fivepixels-database-error', 'Fivepixels 데이터 처리 중 오류가 발생했습니다.');
+            return;
+        }
+        request.log.error({ err: error }, 'Unhandled Community API error');
+        sendFailure(reply, 500, 'fivepixels-internal-server-error', 'Fivepixels API 처리 중 오류가 발생했습니다.');
+    });
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/community/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/community/error-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAarB,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAClE,CAAC;AAED,SAAS,WAAW,CAClB,KAAmB,EACnB,UAAkB,EAClB,UAAkB,EAClB,aAAqB;IAErB,KAAK,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,GAAoB;IACjE,GAAG,CAAC,kBAAkB,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;QACzC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,qBAAqB,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,eAAe,CAAC,CAAC,KAAK,EAAE,OAAuB,EAAE,KAAK,EAAE,EAAE;QAC5D,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;YACvC,IAAI,KAAK,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;gBAC5B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,8BAA8B,CAAC,CAAC;YAClG,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,gCAAgC,CAAC,CAAC;YACvF,CAAC;YACD,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;gBAC7B,KAAK,KAAK,CAAC,MAAM,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;YAClD,CAAC;YACD,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACtE,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,UAAU,CAAC,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;YACzE,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,kBAAkB,CAAC,CAAC;YAC3D,OAAO;QACT,CAAC;QAED,IAAI,UAAU,CAAC,IAAI,KAAK,4BAA4B,EAAE,CAAC;YACrD,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,gBAAgB,CAAC,CAAC;YACzD,OAAO;QACT,CAAC;QAED,IAAI,UAAU,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;YAClC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,mBAAmB,EAAE,+BAA+B,CAAC,CAAC;YAC9E,OAAO;QACT,CAAC;QAED,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,gBAAgB,CAAC,CAAC;YACnD,KAAK,KAAK,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;YACtC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,cAAc,EAAE,qBAAqB,CAAC,CAAC;YAC/D,OAAO;QACT,CAAC;QAED,MAAM,cAAc,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,cAAc,KAAK,UAAU,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,cAAc,EAAE,EAAE,oCAAoC,CAAC,CAAC;YAC7F,WAAW,CACT,KAAK,EACL,GAAG,EACH,mBAAmB,EACnB,uBAAuB,CACxB,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,cAAc,KAAK,YAAY,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,cAAc,EAAE,EAAE,oCAAoC,CAAC,CAAC;YAC7F,WAAW,CACT,KAAK,EACL,GAAG,EACH,qBAAqB,EACrB,qCAAqC,CACtC,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,uBAAuB,CAAC,CAAC;YAC3D,WAAW,CACT,KAAK,EACL,GAAG,EACH,2BAA2B,EAC3B,iCAAiC,CAClC,CAAC;YACF,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,+BAA+B,CAAC,CAAC;QACnE,WAAW,CACT,KAAK,EACL,GAAG,EACH,kCAAkC,EAClC,iCAAiC,CAClC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/community/errors.d.ts

@@ -0,0 +1,10 @@
+export declare class CommunityApiError extends Error {
+    readonly resultCode: string;
+    readonly statusCode: number;
+    constructor(statusCode: number, resultCode: string, resultMessage: string);
+}
+export declare function isSqliteBusyError(error: unknown): boolean;
+export declare function isSqliteError(error: unknown): boolean;
+export type SqliteConstraintKind = 'conflict' | 'constraint';
+export declare function sqliteConstraintKind(error: unknown): SqliteConstraintKind | undefined;
+//# sourceMappingURL=errors.d.ts.map

package/dist/community/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/community/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;CAMjF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQzD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIrD;AAED,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,YAAY,CAAC;AAE7D,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,GAAG,SAAS,CAUrF"}

package/dist/community/errors.js

@@ -0,0 +1,39 @@
+export class CommunityApiError extends Error {
+    resultCode;
+    statusCode;
+    constructor(statusCode, resultCode, resultMessage) {
+        super(resultMessage);
+        this.name = 'CommunityApiError';
+        this.resultCode = resultCode;
+        this.statusCode = statusCode;
+    }
+}
+export function isSqliteBusyError(error) {
+    if (typeof error !== 'object' || error === null || !('code' in error))
+        return false;
+    const code = error.code;
+    return typeof code === 'string'
+        && (code === 'SQLITE_BUSY'
+            || code.startsWith('SQLITE_BUSY_')
+            || code === 'SQLITE_LOCKED'
+            || code.startsWith('SQLITE_LOCKED_'));
+}
+export function isSqliteError(error) {
+    if (typeof error !== 'object' || error === null || !('code' in error))
+        return false;
+    const code = error.code;
+    return typeof code === 'string' && code.startsWith('SQLITE_');
+}
+export function sqliteConstraintKind(error) {
+    if (typeof error !== 'object' || error === null || !('code' in error))
+        return undefined;
+    const code = error.code;
+    if (code === 'SQLITE_CONSTRAINT_UNIQUE' || code === 'SQLITE_CONSTRAINT_PRIMARYKEY') {
+        return 'conflict';
+    }
+    if (typeof code === 'string' && code.startsWith('SQLITE_CONSTRAINT')) {
+        return 'constraint';
+    }
+    return undefined;
+}
+//# sourceMappingURL=errors.js.map

package/dist/community/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/community/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1B,UAAU,CAAS;IACnB,UAAU,CAAS;IAEnC,YAAmB,UAAkB,EAAE,UAAkB,EAAE,aAAqB;QAC9E,KAAK,CAAC,aAAa,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACpF,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;IAChD,OAAO,OAAO,IAAI,KAAK,QAAQ;WAC1B,CAAC,IAAI,KAAK,aAAa;eACrB,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;eAC/B,IAAI,KAAK,eAAe;eACxB,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACpF,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;IAChD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AAChE,CAAC;AAID,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACxF,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;IAChD,IAAI,IAAI,KAAK,0BAA0B,IAAI,IAAI,KAAK,8BAA8B,EAAE,CAAC;QACnF,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACrE,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}