@lark-base-open/base-database-cli 1.4.0 → 1.4.5

package/dist/dev.js

@@ -0,0 +1,244 @@
+import { devSDKMissingMessage } from './sdk-install.js';
+import { DEVELOPMENT_PAIRING } from './development-pairing.generated.js';
+import { fork } from 'node:child_process';
+import { createServer } from 'node:net';
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { projectPairingToken, redactPairing } from './dev-pairing.js';
+import { readConfig } from './config.js';
+import { assertProjectRuntimeProfile, ONLINE_RUNTIME_PROFILE, } from './environment.js';
+import { resolveLarkProfileEnvironment, responseData, runLarkCli, } from './lark-cli.js';
+import { maintainManagedAgentDocs } from './managed-agent-docs.js';
+import { projectLayout } from './project-layout.js';
+import { workspaceInputFingerprint } from './workspace-fingerprint.js';
+import { DEV_PORTS, developmentUrl } from './dev-url.js';
+import { localDiagnostic } from './diagnostics.js';
+import { DevEvents, devHostTimeout } from './dev-events.js';
+import { acquireDevLock, DevWatcher } from './dev-watch.js';
+import { bootstrapGuidance, inspectDevBootstrap, sdkPackageRoot, } from './dev-bootstrap.js';
+export async function selectDevPort(requested) {
+    if (requested !== undefined && !DEV_PORTS.includes(requested))
+        throw new Error('DEV_PORT_INVALID: Only ports 43100-43109 are supported.');
+    for (const port of requested === undefined ? DEV_PORTS : [requested]) {
+        const available = await new Promise((yes, no) => {
+            const server = createServer();
+            server.once('error', (e) => e.code === 'EADDRINUSE' ? yes(false) : no(e));
+            server.listen(port, '127.0.0.1', () => server.close(() => yes(true)));
+        });
+        if (available)
+            return port;
+    }
+    throw new Error('DEV_PORT_BUSY: The requested port or all supported ports are busy. Free a port in 43100-43109 and restart dev.');
+}
+export function viteEnvironment(pairingToken) {
+    const env = { NODE_ENV: 'development' };
+    for (const key of ['PATH', 'SystemRoot', 'WINDIR', 'TEMP', 'TMP', 'TMPDIR'])
+        if (process.env[key])
+            env[key] = process.env[key];
+    if (pairingToken)
+        env[DEVELOPMENT_PAIRING.tokenEnv] = pairingToken;
+    return env;
+}
+export function launchDevVite(input, observe, pairingToken) {
+    const child = fork(fileURLToPath(new URL('./dev-vite.js', import.meta.url)), [], {
+        env: viteEnvironment(pairingToken),
+        execArgv: [],
+        stdio: ['ignore', 'ignore', 'ignore', 'ipc'],
+    });
+    let timer;
+    const listening = new Promise((yes, no) => {
+        timer = setTimeout(() => no(new Error('DEV_VITE_TIMEOUT: Local Vite startup timed out.')), 30_000);
+        child.once('error', no);
+        child.once('exit', () => no(new Error('DEV_VITE_EXITED: Local Vite exited before startup completed.')));
+        child.on('message', (message) => {
+            if (message.event === 'listening')
+                yes();
+            else if (message.event === 'ready' && message.localOrigin)
+                observe(message.localOrigin);
+            else if (message.event === 'error')
+                no(new Error(`DEV_VITE_FAILED: ${redactPairing(String(message.message), pairingToken)}`));
+        });
+        child.send(input);
+    }).finally(() => clearTimeout(timer));
+    return {
+        child,
+        listening,
+        async close() {
+            if (child.exitCode !== null || child.signalCode !== null)
+                return;
+            await new Promise((done) => {
+                const kill = setTimeout(() => child.kill('SIGKILL'), 5000);
+                child.once('exit', () => {
+                    clearTimeout(kill);
+                    done();
+                });
+                child.kill('SIGTERM');
+            });
+        },
+    };
+}
+export async function devProject(options) {
+    try {
+        return await runDevProject(options);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        const message = detail;
+        if (!options.json)
+            throw new Error(message);
+        process.stdout.write(JSON.stringify({
+            event: 'dev.error',
+            code: detail.match(/^(DEV_[A-Z_]+):/)?.[1] ?? 'DEV_PREFLIGHT_FAILED',
+            message,
+        }) + '\n');
+        process.exitCode = 1;
+    }
+}
+async function runDevProject(options) {
+    const hostTimeoutMs = devHostTimeout();
+    const workspace = resolve(options.directory), config = readConfig(workspace);
+    if (!sdkPackageRoot(workspace))
+        throw new Error(devSDKMissingMessage());
+    if (!options.skipBootstrapCheck) {
+        const status = inspectDevBootstrap(workspace);
+        if (status !== 'ready') {
+            const message = bootstrapGuidance(status);
+            throw new Error(message);
+        }
+    }
+    const runtime = options.runtimeProfile ?? ONLINE_RUNTIME_PROFILE;
+    assertProjectRuntimeProfile(config.runtimeProfile, runtime);
+    let hostOrigin;
+    if (options.hostOrigin) {
+        const url = new URL(options.hostOrigin);
+        if (url.protocol !== 'https:' ||
+            url.origin !== options.hostOrigin ||
+            url.username ||
+            url.password)
+            throw new Error('DEV_HOST_ORIGIN_INVALID: An exact HTTPS origin is required.');
+        hostOrigin = url.origin;
+    }
+    await maintainManagedAgentDocs(workspace, {
+        command: runtime.checkCommand.split(' ')[0],
+    });
+    const release = options.deployPreview
+        ? acquireDevLock(config.appToken, runtime.name)
+        : () => { };
+    let vite;
+    let watcher;
+    let interval;
+    let events;
+    let stopping = false;
+    let resolveStop;
+    const stopped = new Promise((done) => {
+        resolveStop = done;
+    });
+    const stop = () => {
+        stopping = true;
+        events?.cancelHostWait();
+        resolveStop();
+    };
+    process.once('SIGINT', stop);
+    process.once('SIGTERM', stop);
+    options.signal?.addEventListener('abort', stop, { once: true });
+    try {
+        const port = await selectDevPort(options.port);
+        if (options.signal?.aborted)
+            return;
+        const selected = resolveLarkProfileEnvironment(await runtime.commandEnvironment(), options.larkProfile, config.larkProfile, runtime);
+        const larkProfile = selected.larkProfile;
+        const catalog = responseData(runLarkCli([
+            'api',
+            'GET',
+            `/open-apis/base/v3/sites/${encodeURIComponent(config.appToken)}/catalog`,
+        ], selected.env, workspace));
+        if (typeof catalog.baseAppUrl !== 'string')
+            throw new Error('DEV_BASE_APP_URL_REQUIRED: Catalog is missing baseAppUrl.');
+        const pairingToken = projectPairingToken(workspace, options.resetPairing);
+        const hostUrl = developmentUrl(catalog.baseAppUrl, port, hostOrigin, pairingToken);
+        hostOrigin = new URL(hostUrl).origin;
+        if (stopping)
+            return;
+        const localOrigin = `http://${DEVELOPMENT_PAIRING.host}:${port}`;
+        const context = {
+            appToken: config.appToken,
+            projectEnv: 'preview',
+            platformEnv: runtime.name,
+            hostUrl: redactPairing(hostUrl, pairingToken),
+            localOrigin,
+            localUrl: `${localOrigin}/`,
+            pageRevision: `sha256:${workspaceInputFingerprint(resolve(workspace, 'page')).sha256}`,
+            faas: { mode: 'remote-preview', deployGranularity: 'application' },
+            diagnostics: '.base-database-cli/state/diagnostics/events.ndjson',
+        };
+        const emit = (event) => {
+            if (options.json)
+                process.stdout.write(redactPairing(JSON.stringify(event), pairingToken) + '\n');
+            if (!options.json || event.event === 'dev.host_not_connected')
+                process.stderr.write(redactPairing(JSON.stringify(event), pairingToken) + '\n');
+            if (event.event === 'dev.host_not_connected') {
+                localDiagnostic(workspace, 'cli.dev', {
+                    event: 'dev.host_not_connected',
+                    hint: 'DEV_HOST_NOT_CONNECTED',
+                    code: 'DEV_HOST_NOT_CONNECTED',
+                    elapsedMs: Number(event.elapsedMs),
+                    durationMs: Number(event.elapsedMs),
+                    outcome: 'unknown',
+                });
+                process.stderr.write(String(event.message) + '\n');
+            }
+        };
+        events = new DevEvents(context, emit, hostTimeoutMs);
+        process.stderr.write(`Development data scope: ${JSON.stringify({ bindings: config.bindings ?? {}, cliProfile: larkProfile ?? 'CLI default profile', browserIdentity: 'The editor currently signed in to the host', projectEnv: 'preview', platformEnv: runtime.name })}\n${options.deployPreview ? 'Application-wide Preview deployment is enabled and modifies the shared draft. The local lock cannot prevent writes from other machines; use a separate test application.' : 'Local builds only; automatic remote deployment is disabled.'}\n`);
+        vite = launchDevVite({
+            workspace,
+            port,
+            hostOrigin,
+            templateVersion: projectLayout(workspace).version,
+        }, (id) => {
+            if (!stopping)
+                events?.observe(id);
+        }, pairingToken);
+        vite.child.once('exit', stop);
+        await vite.listening;
+        if (stopping)
+            return;
+        events.send('dev.listening');
+        process.stderr.write(`Development URL: ${options.json ? redactPairing(hostUrl, pairingToken) : hostUrl}\nOpen the link printed by the CLI. Sharing the address-bar URL opens the published application. Allow local network or device access when prompted by the browser, then retry. A local development banner appears after pairing.${options.json ? ' Run dev without --json to obtain the full pairing link.' : ''}\n`);
+        watcher = new DevWatcher({
+            workspace,
+            appToken: config.appToken,
+            runtimeProfile: runtime,
+            buildEnvironment: { ...runtime.pageBuildEnvironment(), ...selected.env },
+            larkProfile,
+            deployPreview: options.deployPreview ?? false,
+            emit: (event, detail) => {
+                events?.send(event, detail);
+            },
+        });
+        if (options.deployPreview)
+            void watcher.initialPreview();
+        interval = setInterval(() => {
+            try {
+                watcher?.scan();
+            }
+            catch {
+                events?.send('dev.watch.failed');
+                stop();
+            }
+        }, 200);
+        await stopped;
+    }
+    finally {
+        stopping = true;
+        clearInterval(interval);
+        events?.cancelHostWait();
+        await Promise.all([vite?.close(), watcher?.stop()]);
+        events?.send('dev.stopped');
+        release();
+        process.removeListener('SIGINT', stop);
+        process.removeListener('SIGTERM', stop);
+        options.signal?.removeEventListener('abort', stop);
+    }
+}
+//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

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

package/dist/development-pairing.generated.d.ts

@@ -0,0 +1,12 @@
+export declare const DEVELOPMENT_PAIRING: {
+    readonly tokenEnv: 'BASE_APP_DEV_PAIRING_TOKEN';
+    readonly endpoint: '/__base_app/dev-pair';
+    readonly proofPrefix: 'base-app-dev-pair.v1';
+    readonly pairApi: 'site.v1.development.pair';
+    readonly pairedEvent: 'site.v1.development.paired';
+    readonly host: '127.0.0.1';
+    readonly portMin: 43100;
+    readonly portMax: 43109;
+    readonly secretBytes: 32;
+};
+//# sourceMappingURL=development-pairing.generated.d.ts.map

package/dist/development-pairing.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"development-pairing.generated.d.ts","sourceRoot":"","sources":["../src/development-pairing.generated.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,mBAAmB;aAC9B,QAAQ,EAAE,4BAA4B;aACtC,QAAQ,EAAE,sBAAsB;aAChC,WAAW,EAAE,sBAAsB;aACnC,OAAO,EAAE,0BAA0B;aACnC,WAAW,EAAE,4BAA4B;aACzC,IAAI,EAAE,WAAW;aACjB,OAAO,EAAE,KAAK;aACd,OAAO,EAAE,KAAK;aACd,WAAW,EAAE,EAAE;CACP,CAAC"}

package/dist/development-pairing.generated.js

@@ -0,0 +1,13 @@
+// Generated from SDK development-pairing.json; run scripts/sync-development-pairing.mjs.
+export const DEVELOPMENT_PAIRING = {
+    tokenEnv: 'BASE_APP_DEV_PAIRING_TOKEN',
+    endpoint: '/__base_app/dev-pair',
+    proofPrefix: 'base-app-dev-pair.v1',
+    pairApi: 'site.v1.development.pair',
+    pairedEvent: 'site.v1.development.paired',
+    host: '127.0.0.1',
+    portMin: 43100,
+    portMax: 43109,
+    secretBytes: 32,
+};
+//# sourceMappingURL=development-pairing.generated.js.map

package/dist/development-pairing.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"development-pairing.generated.js","sourceRoot":"","sources":["../src/development-pairing.generated.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ,EAAE,4BAA4B;IACtC,QAAQ,EAAE,sBAAsB;IAChC,WAAW,EAAE,sBAAsB;IACnC,OAAO,EAAE,0BAA0B;IACnC,WAAW,EAAE,4BAA4B;IACzC,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,KAAK;IACd,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,EAAE;CACP,CAAC"}

package/dist/diagnostic-platforms.d.ts

@@ -0,0 +1,3 @@
+export declare const DIAGNOSTIC_PLATFORMS: readonly ['online', 'pre', 'internal'];
+export type DiagnosticPlatform = (typeof DIAGNOSTIC_PLATFORMS)[number];
+//# sourceMappingURL=diagnostic-platforms.d.ts.map

package/dist/diagnostic-platforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-platforms.d.ts","sourceRoot":"","sources":["../src/diagnostic-platforms.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,oBAAoB,YAAI,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAU,CAAC;AAC3E,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/diagnostic-platforms.js

@@ -0,0 +1,3 @@
+// Public diagnostic wire vocabulary; contains no routing or internal endpoints.
+export const DIAGNOSTIC_PLATFORMS = ['online', 'pre', 'internal'];
+//# sourceMappingURL=diagnostic-platforms.js.map

package/dist/diagnostic-platforms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-platforms.js","sourceRoot":"","sources":["../src/diagnostic-platforms.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAU,CAAC"}

package/dist/diagnostic-schema.d.ts

@@ -0,0 +1,151 @@
+export declare const diagnosticSchema: {
+    readonly $schema: 'https://json-schema.org/draft/2020-12/schema';
+    readonly $id: 'urn:base-database:diagnostic:v1';
+    readonly type: 'object';
+    readonly additionalProperties: false;
+    readonly required: readonly ['schemaVersion', 'id', 'timestamp', 'source', 'evidence', 'application', 'environment', 'artifactVersion', 'requestId', 'logid', 'functionId', 'sessionId', 'code', 'upstreamCode', 'category', 'message', 'retryable', 'outcome', 'durationMs', 'redaction'];
+    readonly allOf: readonly [{
+        readonly if: {
+            readonly properties: {
+                readonly outcome: {
+                    readonly const: 'unknown';
+                };
+            };
+        };
+        readonly then: {
+            readonly properties: {
+                readonly retryable: {
+                    readonly const: false;
+                };
+            };
+        };
+    }];
+    readonly properties: {
+        readonly schemaVersion: {
+            readonly const: 1;
+        };
+        readonly event: {
+            readonly const: 'dev.host_not_connected';
+        };
+        readonly hint: {
+            readonly const: 'DEV_HOST_NOT_CONNECTED';
+        };
+        readonly elapsedMs: {
+            readonly type: 'number';
+            readonly minimum: 0;
+        };
+        readonly id: {
+            readonly type: 'string';
+            readonly minLength: 1;
+            readonly maxLength: 128;
+        };
+        readonly timestamp: {
+            readonly type: 'string';
+            readonly format: 'date-time';
+        };
+        readonly source: {
+            readonly enum: readonly ['cli.check', 'cli.dev', 'cli.build', 'cli.deploy', 'host', 'sdk.page', 'sdk.server', 'devcenter', 'faas'];
+        };
+        readonly evidence: {
+            readonly enum: readonly ['local', 'browser', 'response', 'platform-log'];
+        };
+        readonly application: {
+            readonly type: 'object';
+            readonly additionalProperties: false;
+            readonly required: readonly ['appToken', 'projectId'];
+            readonly properties: {
+                readonly appToken: {
+                    readonly type: readonly ['string', 'null'];
+                    readonly maxLength: 128;
+                };
+                readonly projectId: {
+                    readonly type: readonly ['string', 'null'];
+                    readonly maxLength: 64;
+                };
+            };
+        };
+        readonly environment: {
+            readonly type: 'object';
+            readonly additionalProperties: false;
+            readonly required: readonly ['project', 'platform', 'lane'];
+            readonly properties: {
+                readonly project: {
+                    readonly enum: readonly ['preview', 'prod', null];
+                };
+                readonly platform: {
+                    readonly enum: readonly (string | null)[];
+                };
+                readonly lane: {
+                    readonly type: readonly ['string', 'null'];
+                    readonly maxLength: 128;
+                };
+            };
+        };
+        readonly artifactVersion: {
+            readonly type: readonly ['string', 'null'];
+            readonly maxLength: 256;
+        };
+        readonly requestId: {
+            readonly type: readonly ['string', 'null'];
+            readonly maxLength: 128;
+        };
+        readonly logid: {
+            readonly type: readonly ['string', 'null'];
+            readonly maxLength: 128;
+        };
+        readonly functionId: {
+            readonly type: readonly ['string', 'null'];
+            readonly maxLength: 64;
+        };
+        readonly sessionId: {
+            readonly type: readonly ['string', 'null'];
+            readonly maxLength: 128;
+        };
+        readonly code: {
+            readonly type: readonly ['string', 'null'];
+            readonly maxLength: 128;
+        };
+        readonly upstreamCode: {
+            readonly type: readonly ['string', 'null'];
+            readonly maxLength: 128;
+        };
+        readonly category: {
+            readonly enum: readonly ['host-unsupported', 'permission-denied', 'region-unavailable', 'temporary', 'validation', 'protocol', 'business', 'unknown', null];
+        };
+        readonly message: {
+            readonly type: 'string';
+            readonly maxLength: 512;
+        };
+        readonly retryable: {
+            readonly type: 'boolean';
+        };
+        readonly outcome: {
+            readonly enum: readonly ['success', 'partial', 'failed', 'unknown'];
+        };
+        readonly durationMs: {
+            readonly type: readonly ['number', 'null'];
+            readonly minimum: 0;
+        };
+        readonly redaction: {
+            readonly type: 'object';
+            readonly additionalProperties: false;
+            readonly required: readonly ['policy', 'omitted', 'truncated'];
+            readonly properties: {
+                readonly policy: {
+                    readonly const: 'allowlist-v1';
+                };
+                readonly omitted: {
+                    readonly type: 'array';
+                    readonly uniqueItems: true;
+                    readonly items: {
+                        readonly enum: readonly ['credentials', 'headers', 'request-body', 'response-body', 'sql', 'user-content', 'url-query', 'stack'];
+                    };
+                };
+                readonly truncated: {
+                    readonly type: 'boolean';
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=diagnostic-schema.d.ts.map

package/dist/diagnostic-schema.d.ts.map

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

package/dist/diagnostic-schema.js

@@ -0,0 +1,129 @@
+import { DIAGNOSTIC_PLATFORMS } from './diagnostic-platforms.js';
+// Diagnostic v1, DESIGN §5.3. Keep in sync with the SDK/host contract.
+export const diagnosticSchema = {
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    $id: 'urn:base-database:diagnostic:v1',
+    type: 'object',
+    additionalProperties: false,
+    required: [
+        'schemaVersion',
+        'id',
+        'timestamp',
+        'source',
+        'evidence',
+        'application',
+        'environment',
+        'artifactVersion',
+        'requestId',
+        'logid',
+        'functionId',
+        'sessionId',
+        'code',
+        'upstreamCode',
+        'category',
+        'message',
+        'retryable',
+        'outcome',
+        'durationMs',
+        'redaction',
+    ],
+    allOf: [
+        {
+            if: { properties: { outcome: { const: 'unknown' } } },
+            then: { properties: { retryable: { const: false } } },
+        },
+    ],
+    properties: {
+        schemaVersion: { const: 1 },
+        event: { const: 'dev.host_not_connected' },
+        hint: { const: 'DEV_HOST_NOT_CONNECTED' },
+        elapsedMs: { type: 'number', minimum: 0 },
+        id: { type: 'string', minLength: 1, maxLength: 128 },
+        timestamp: { type: 'string', format: 'date-time' },
+        source: {
+            enum: [
+                'cli.check',
+                'cli.dev',
+                'cli.build',
+                'cli.deploy',
+                'host',
+                'sdk.page',
+                'sdk.server',
+                'devcenter',
+                'faas',
+            ],
+        },
+        evidence: { enum: ['local', 'browser', 'response', 'platform-log'] },
+        application: {
+            type: 'object',
+            additionalProperties: false,
+            required: ['appToken', 'projectId'],
+            properties: {
+                appToken: { type: ['string', 'null'], maxLength: 128 },
+                projectId: { type: ['string', 'null'], maxLength: 64 },
+            },
+        },
+        environment: {
+            type: 'object',
+            additionalProperties: false,
+            required: ['project', 'platform', 'lane'],
+            properties: {
+                project: { enum: ['preview', 'prod', null] },
+                platform: {
+                    enum: [...DIAGNOSTIC_PLATFORMS, null],
+                },
+                lane: { type: ['string', 'null'], maxLength: 128 },
+            },
+        },
+        artifactVersion: { type: ['string', 'null'], maxLength: 256 },
+        requestId: { type: ['string', 'null'], maxLength: 128 },
+        logid: { type: ['string', 'null'], maxLength: 128 },
+        functionId: { type: ['string', 'null'], maxLength: 64 },
+        sessionId: { type: ['string', 'null'], maxLength: 128 },
+        code: { type: ['string', 'null'], maxLength: 128 },
+        upstreamCode: { type: ['string', 'null'], maxLength: 128 },
+        category: {
+            enum: [
+                'host-unsupported',
+                'permission-denied',
+                'region-unavailable',
+                'temporary',
+                'validation',
+                'protocol',
+                'business',
+                'unknown',
+                null,
+            ],
+        },
+        message: { type: 'string', maxLength: 512 },
+        retryable: { type: 'boolean' },
+        outcome: { enum: ['success', 'partial', 'failed', 'unknown'] },
+        durationMs: { type: ['number', 'null'], minimum: 0 },
+        redaction: {
+            type: 'object',
+            additionalProperties: false,
+            required: ['policy', 'omitted', 'truncated'],
+            properties: {
+                policy: { const: 'allowlist-v1' },
+                omitted: {
+                    type: 'array',
+                    uniqueItems: true,
+                    items: {
+                        enum: [
+                            'credentials',
+                            'headers',
+                            'request-body',
+                            'response-body',
+                            'sql',
+                            'user-content',
+                            'url-query',
+                            'stack',
+                        ],
+                    },
+                },
+                truncated: { type: 'boolean' },
+            },
+        },
+    },
+};
+//# sourceMappingURL=diagnostic-schema.js.map

package/dist/diagnostic-schema.js.map

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