@logscopeai/logscope 0.1.0-beta.2

package/dist/pipeline/pipeline-ingress.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPipelineIngress = void 0;
+const level_filter_1 = require("../filter/level-filter");
+const normalize_log_1 = require("../normalization/normalize-log");
+const runSafe = (callback) => {
+    try {
+        callback();
+    }
+    catch {
+        // Never throw into user code.
+    }
+};
+const createPipelineIngress = (input) => {
+    const allowsLevel = (0, level_filter_1.createLevelFilterEvaluator)(input.logFilter);
+    return {
+        dispatch(log) {
+            if (!allowsLevel(log.level)) {
+                return;
+            }
+            runSafe(() => {
+                const normalizedLog = (0, normalize_log_1.normalizeLog)({
+                    source: input.source,
+                    level: log.level,
+                    message: log.message,
+                    metadata: log.metadata,
+                    timestamp: log.timestamp,
+                }, {
+                    now: input.now,
+                });
+                input.pipeline.enqueue(normalizedLog);
+            });
+        },
+    };
+};
+exports.createPipelineIngress = createPipelineIngress;
+//# sourceMappingURL=pipeline-ingress.js.map

package/dist/pipeline/pipeline-ingress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-ingress.js","sourceRoot":"","sources":["../../src/pipeline/pipeline-ingress.ts"],"names":[],"mappings":";;;AAAA,yDAAoE;AACpE,kEAA8D;AAuB9D,MAAM,OAAO,GAAG,CAAC,QAAoB,EAAQ,EAAE;IAC7C,IAAI,CAAC;QACH,QAAQ,EAAE,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;IAChC,CAAC;AACH,CAAC,CAAC;AAEK,MAAM,qBAAqB,GAAG,CAAC,KAAiC,EAAmB,EAAE;IAC1F,MAAM,WAAW,GAAG,IAAA,yCAA0B,EAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAEhE,OAAO;QACL,QAAQ,CAAC,GAA4B;YACnC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5B,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,EAAE;gBACX,MAAM,aAAa,GAAG,IAAA,4BAAY,EAChC;oBACE,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,QAAQ,EAAE,GAAG,CAAC,QAAQ;oBACtB,SAAS,EAAE,GAAG,CAAC,SAAS;iBACzB,EACD;oBACE,GAAG,EAAE,KAAK,CAAC,GAAG;iBACf,CACF,CAAC;gBAEF,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YACxC,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AA3BW,QAAA,qBAAqB,yBA2BhC"}

package/dist/pipeline/pipeline.d.ts

@@ -0,0 +1,21 @@
+import { DEFAULT_FLUSH_INTERVAL_MS } from '../config/runtime-config';
+import type { RetryPolicy } from '../retry/retry-policy';
+import type { IngestionRequestResult, SendIngestionRequestInput } from '../transport/transport-types';
+import type { IngestionLogEntry } from '../types';
+export declare const MAX_BATCH_SIZE = 50;
+export { DEFAULT_FLUSH_INTERVAL_MS };
+export interface BatchingPipeline {
+    enqueue(log: IngestionLogEntry): void;
+    flushNow(): Promise<void>;
+    stop(): Promise<void>;
+}
+export interface CreateBatchingPipelineInput {
+    endpoint: string;
+    apiKey: string;
+    sendBatch: (input: SendIngestionRequestInput) => Promise<IngestionRequestResult>;
+    onBatchResult?: (result: IngestionRequestResult) => void;
+    maxBatchSize?: number;
+    flushIntervalMs?: number;
+    retryPolicy?: Partial<RetryPolicy>;
+}
+export declare const createBatchingPipeline: (input: CreateBatchingPipelineInput) => BatchingPipeline;

package/dist/pipeline/pipeline.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBatchingPipeline = exports.DEFAULT_FLUSH_INTERVAL_MS = exports.MAX_BATCH_SIZE = void 0;
+const runtime_config_1 = require("../config/runtime-config");
+Object.defineProperty(exports, "DEFAULT_FLUSH_INTERVAL_MS", { enumerable: true, get: function () { return runtime_config_1.DEFAULT_FLUSH_INTERVAL_MS; } });
+const batch_queue_1 = require("./batch-queue");
+const delivery_runner_1 = require("./delivery-runner");
+const flush_scheduler_1 = require("./flush-scheduler");
+exports.MAX_BATCH_SIZE = runtime_config_1.DEFAULT_MAX_BATCH_SIZE;
+const runSafe = (callback) => {
+    try {
+        callback();
+    }
+    catch {
+        // Internal callbacks must not surface to user code.
+    }
+};
+const createBatchingPipeline = (input) => {
+    const runtimeConfig = (0, runtime_config_1.resolveRuntimeConfig)({
+        maxBatchSize: input.maxBatchSize,
+        flushIntervalMs: input.flushIntervalMs,
+        maxRetries: input.retryPolicy?.maxRetries,
+        retryBaseDelayMs: input.retryPolicy?.baseDelayMs,
+        retryMaxDelayMs: input.retryPolicy?.maxDelayMs,
+    });
+    const queue = (0, batch_queue_1.createBatchQueue)();
+    let activeFlushPromise = null;
+    let isStopped = false;
+    const emitBatchResult = (result) => {
+        if (input.onBatchResult === undefined) {
+            return;
+        }
+        runSafe(() => input.onBatchResult?.(result));
+    };
+    const scheduler = (0, flush_scheduler_1.createFlushScheduler)({
+        intervalMs: runtimeConfig.flushIntervalMs,
+        onFlush: () => {
+            if (isStopped || queue.isEmpty()) {
+                return;
+            }
+            void flushInternal();
+        },
+    });
+    const flushInternal = () => {
+        if (activeFlushPromise !== null) {
+            return activeFlushPromise;
+        }
+        activeFlushPromise = (async () => {
+            scheduler.cancel();
+            while (!queue.isEmpty()) {
+                const batch = queue.dequeueBatch(runtimeConfig.maxBatchSize);
+                if (batch.length === 0) {
+                    break;
+                }
+                try {
+                    const result = await (0, delivery_runner_1.runBatchDelivery)({
+                        endpoint: input.endpoint,
+                        apiKey: input.apiKey,
+                        sendBatch: input.sendBatch,
+                        logs: batch,
+                        retryPolicy: runtimeConfig.retryPolicy,
+                    });
+                    emitBatchResult(result);
+                }
+                catch {
+                    // Never throw into user code.
+                }
+            }
+        })().finally(() => {
+            activeFlushPromise = null;
+            if (isStopped || queue.isEmpty()) {
+                scheduler.cancel();
+                return;
+            }
+            scheduler.schedule();
+        });
+        return activeFlushPromise;
+    };
+    return {
+        enqueue(log) {
+            if (isStopped) {
+                return;
+            }
+            queue.enqueue(log);
+            if (queue.size() >= runtimeConfig.maxBatchSize) {
+                void flushInternal();
+                return;
+            }
+            scheduler.schedule();
+        },
+        async flushNow() {
+            if (isStopped || queue.isEmpty()) {
+                return;
+            }
+            await flushInternal();
+        },
+        async stop() {
+            if (isStopped) {
+                return;
+            }
+            isStopped = true;
+            scheduler.cancel();
+            await flushInternal();
+            queue.clear();
+        },
+    };
+};
+exports.createBatchingPipeline = createBatchingPipeline;
+//# sourceMappingURL=pipeline.js.map

package/dist/pipeline/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/pipeline/pipeline.ts"],"names":[],"mappings":";;;AAAA,6DAIkC;AAYzB,0GAfP,0CAAyB,OAeO;AALlC,+CAAiD;AACjD,uDAAqD;AACrD,uDAAyD;AAE5C,QAAA,cAAc,GAAG,uCAAsB,CAAC;AAmBrD,MAAM,OAAO,GAAG,CAAC,QAAoB,EAAQ,EAAE;IAC7C,IAAI,CAAC;QACH,QAAQ,EAAE,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,oDAAoD;IACtD,CAAC;AACH,CAAC,CAAC;AAEK,MAAM,sBAAsB,GAAG,CAAC,KAAkC,EAAoB,EAAE;IAC7F,MAAM,aAAa,GAAG,IAAA,qCAAoB,EAAC;QACzC,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,UAAU,EAAE,KAAK,CAAC,WAAW,EAAE,UAAU;QACzC,gBAAgB,EAAE,KAAK,CAAC,WAAW,EAAE,WAAW;QAChD,eAAe,EAAE,KAAK,CAAC,WAAW,EAAE,UAAU;KAC/C,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,IAAA,8BAAgB,GAAE,CAAC;IACjC,IAAI,kBAAkB,GAAyB,IAAI,CAAC;IACpD,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,MAAM,eAAe,GAAG,CAAC,MAA8B,EAAQ,EAAE;QAC/D,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACtC,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,IAAA,sCAAoB,EAAC;QACrC,UAAU,EAAE,aAAa,CAAC,eAAe;QACzC,OAAO,EAAE,GAAG,EAAE;YACZ,IAAI,SAAS,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBACjC,OAAO;YACT,CAAC;YAED,KAAK,aAAa,EAAE,CAAC;QACvB,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,GAAkB,EAAE;QACxC,IAAI,kBAAkB,KAAK,IAAI,EAAE,CAAC;YAChC,OAAO,kBAAkB,CAAC;QAC5B,CAAC;QAED,kBAAkB,GAAG,CAAC,KAAK,IAAmB,EAAE;YAC9C,SAAS,CAAC,MAAM,EAAE,CAAC;YAEnB,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBACxB,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;gBAE7D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACvB,MAAM;gBACR,CAAC;gBAED,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,IAAA,kCAAgB,EAAC;wBACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,MAAM,EAAE,KAAK,CAAC,MAAM;wBACpB,SAAS,EAAE,KAAK,CAAC,SAAS;wBAC1B,IAAI,EAAE,KAAK;wBACX,WAAW,EAAE,aAAa,CAAC,WAAW;qBACvC,CAAC,CAAC;oBACH,eAAe,CAAC,MAAM,CAAC,CAAC;gBAC1B,CAAC;gBAAC,MAAM,CAAC;oBACP,8BAA8B;gBAChC,CAAC;YACH,CAAC;QACH,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;YAChB,kBAAkB,GAAG,IAAI,CAAC;YAE1B,IAAI,SAAS,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBACjC,SAAS,CAAC,MAAM,EAAE,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,SAAS,CAAC,QAAQ,EAAE,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,OAAO,kBAAkB,CAAC;IAC5B,CAAC,CAAC;IAEF,OAAO;QACL,OAAO,CAAC,GAAsB;YAC5B,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO;YACT,CAAC;YAED,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAEnB,IAAI,KAAK,CAAC,IAAI,EAAE,IAAI,aAAa,CAAC,YAAY,EAAE,CAAC;gBAC/C,KAAK,aAAa,EAAE,CAAC;gBACrB,OAAO;YACT,CAAC;YAED,SAAS,CAAC,QAAQ,EAAE,CAAC;QACvB,CAAC;QACD,KAAK,CAAC,QAAQ;YACZ,IAAI,SAAS,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBACjC,OAAO;YACT,CAAC;YAED,MAAM,aAAa,EAAE,CAAC;QACxB,CAAC;QACD,KAAK,CAAC,IAAI;YACR,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO;YACT,CAAC;YAED,SAAS,GAAG,IAAI,CAAC;YACjB,SAAS,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,aAAa,EAAE,CAAC;YACtB,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AA1GW,QAAA,sBAAsB,0BA0GjC"}

package/dist/retry/backoff.d.ts

@@ -0,0 +1,2 @@
+import type { RetryPolicy } from './retry-policy';
+export declare const calculateRetryDelayMs: (attempt: number, policy: RetryPolicy) => number;

package/dist/retry/backoff.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateRetryDelayMs = void 0;
+const calculateRetryDelayMs = (attempt, policy) => {
+    if (attempt <= 0 || policy.baseDelayMs === 0 || policy.maxDelayMs === 0) {
+        return 0;
+    }
+    const growthFactor = 2 ** (attempt - 1);
+    const rawDelay = policy.baseDelayMs * growthFactor;
+    if (!Number.isFinite(rawDelay)) {
+        return policy.maxDelayMs;
+    }
+    return Math.min(policy.maxDelayMs, Math.trunc(rawDelay));
+};
+exports.calculateRetryDelayMs = calculateRetryDelayMs;
+//# sourceMappingURL=backoff.js.map

package/dist/retry/backoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.js","sourceRoot":"","sources":["../../src/retry/backoff.ts"],"names":[],"mappings":";;;AAEO,MAAM,qBAAqB,GAAG,CAAC,OAAe,EAAE,MAAmB,EAAU,EAAE;IACpF,IAAI,OAAO,IAAI,CAAC,IAAI,MAAM,CAAC,WAAW,KAAK,CAAC,IAAI,MAAM,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,GAAG,YAAY,CAAC;IAEnD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC3D,CAAC,CAAC;AAbW,QAAA,qBAAqB,yBAahC"}

package/dist/retry/retry-policy.d.ts

@@ -0,0 +1,7 @@
+export interface RetryPolicy {
+    maxRetries: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+}
+export declare const DEFAULT_RETRY_POLICY: RetryPolicy;
+export declare const resolveRetryPolicy: (policy?: Partial<RetryPolicy>) => RetryPolicy;

package/dist/retry/retry-policy.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRetryPolicy = exports.DEFAULT_RETRY_POLICY = void 0;
+exports.DEFAULT_RETRY_POLICY = {
+    maxRetries: 3,
+    baseDelayMs: 250,
+    maxDelayMs: 2_000,
+};
+const normalizeNonNegativeInteger = (value, fallback) => {
+    if (value === undefined || !Number.isFinite(value) || value < 0) {
+        return fallback;
+    }
+    return Math.trunc(value);
+};
+const resolveRetryPolicy = (policy) => {
+    const maxRetries = normalizeNonNegativeInteger(policy?.maxRetries, exports.DEFAULT_RETRY_POLICY.maxRetries);
+    const baseDelayMs = normalizeNonNegativeInteger(policy?.baseDelayMs, exports.DEFAULT_RETRY_POLICY.baseDelayMs);
+    const maxDelayMs = normalizeNonNegativeInteger(policy?.maxDelayMs, exports.DEFAULT_RETRY_POLICY.maxDelayMs);
+    return {
+        maxRetries,
+        baseDelayMs,
+        maxDelayMs: Math.max(baseDelayMs, maxDelayMs),
+    };
+};
+exports.resolveRetryPolicy = resolveRetryPolicy;
+//# sourceMappingURL=retry-policy.js.map

package/dist/retry/retry-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-policy.js","sourceRoot":"","sources":["../../src/retry/retry-policy.ts"],"names":[],"mappings":";;;AAMa,QAAA,oBAAoB,GAAgB;IAC/C,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,GAAG;IAChB,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF,MAAM,2BAA2B,GAAG,CAAC,KAAyB,EAAE,QAAgB,EAAU,EAAE;IAC1F,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAChE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC,CAAC;AAEK,MAAM,kBAAkB,GAAG,CAAC,MAA6B,EAAe,EAAE;IAC/E,MAAM,UAAU,GAAG,2BAA2B,CAC5C,MAAM,EAAE,UAAU,EAClB,4BAAoB,CAAC,UAAU,CAChC,CAAC;IACF,MAAM,WAAW,GAAG,2BAA2B,CAC7C,MAAM,EAAE,WAAW,EACnB,4BAAoB,CAAC,WAAW,CACjC,CAAC;IACF,MAAM,UAAU,GAAG,2BAA2B,CAC5C,MAAM,EAAE,UAAU,EAClB,4BAAoB,CAAC,UAAU,CAChC,CAAC;IAEF,OAAO;QACL,UAAU;QACV,WAAW;QACX,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,UAAU,CAAC;KAC9C,CAAC;AACJ,CAAC,CAAC;AAnBW,QAAA,kBAAkB,sBAmB7B"}

package/dist/transport/send-ingestion-request.d.ts

@@ -0,0 +1,4 @@
+import type { FetchLike, IngestionRequestResult, SendIngestionRequestInput } from './transport-types';
+export declare const sendIngestionRequest: (input: SendIngestionRequestInput, dependencies?: {
+    fetch: FetchLike;
+}) => Promise<IngestionRequestResult>;

package/dist/transport/send-ingestion-request.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendIngestionRequest = void 0;
+const INGESTION_PATH = '/api/logs/ingest';
+// Explicit status classification for ingestion delivery behavior.
+const classifyIngestionStatus = (status) => {
+    switch (status) {
+        case 202:
+            return 'success';
+        case 400:
+        case 413:
+            return 'drop';
+        case 401:
+            return 'unauthorized';
+        case 429:
+        case 500:
+            return 'retry';
+        default:
+            return status >= 500 ? 'retry' : 'drop';
+    }
+};
+const buildIngestionUrl = (endpoint) => {
+    return new URL(INGESTION_PATH, endpoint).toString();
+};
+const buildRequestInit = (input) => {
+    return {
+        method: 'POST',
+        headers: {
+            'x-api-key': input.apiKey,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            logs: input.logs,
+        }),
+    };
+};
+const sendIngestionRequest = async (input, dependencies = { fetch: globalThis.fetch }) => {
+    let requestUrl;
+    try {
+        requestUrl = buildIngestionUrl(input.endpoint);
+    }
+    catch {
+        return {
+            action: 'drop',
+            shouldWarnUnauthorized: false,
+            errorKind: 'invalid_endpoint',
+        };
+    }
+    try {
+        console.log(`[logscope] Sending logs batch to ${requestUrl}`);
+        const response = await dependencies.fetch(requestUrl, buildRequestInit(input));
+        const action = classifyIngestionStatus(response.status);
+        if (action === 'unauthorized') {
+            return {
+                action,
+                status: response.status,
+                shouldWarnUnauthorized: true,
+            };
+        }
+        return {
+            action,
+            status: response.status,
+            shouldWarnUnauthorized: false,
+        };
+    }
+    catch {
+        return {
+            action: 'retry',
+            shouldWarnUnauthorized: false,
+            errorKind: 'network_error',
+        };
+    }
+};
+exports.sendIngestionRequest = sendIngestionRequest;
+//# sourceMappingURL=send-ingestion-request.js.map

package/dist/transport/send-ingestion-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-ingestion-request.js","sourceRoot":"","sources":["../../src/transport/send-ingestion-request.ts"],"names":[],"mappings":";;;AAQA,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAE1C,kEAAkE;AAClE,MAAM,uBAAuB,GAAG,CAAC,MAAc,EAA0B,EAAE;IACzE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,GAAG;YACN,OAAO,SAAS,CAAC;QACnB,KAAK,GAAG,CAAC;QACT,KAAK,GAAG;YACN,OAAO,MAAM,CAAC;QAChB,KAAK,GAAG;YACN,OAAO,cAAc,CAAC;QACxB,KAAK,GAAG,CAAC;QACT,KAAK,GAAG;YACN,OAAO,OAAO,CAAC;QACjB;YACE,OAAO,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IAC5C,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,QAAgB,EAAU,EAAE;IACrD,OAAO,IAAI,GAAG,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;AACtD,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,KAAgC,EAAoB,EAAE;IAC9E,OAAO;QACL,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,WAAW,EAAE,KAAK,CAAC,MAAM;YACzB,cAAc,EAAE,kBAAkB;SACnC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC;KACH,CAAC;AACJ,CAAC,CAAC;AAEK,MAAM,oBAAoB,GAAG,KAAK,EACvC,KAAgC,EAChC,eAAqC,EAAE,KAAK,EAAE,UAAU,CAAC,KAA6B,EAAE,EACvD,EAAE;IACnC,IAAI,UAAkB,CAAC;IAEvB,IAAI,CAAC;QACH,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,MAAM,EAAE,MAAM;YACd,sBAAsB,EAAE,KAAK;YAC7B,SAAS,EAAE,kBAAkB;SAC9B,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,oCAAoC,UAAU,EAAE,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/E,MAAM,MAAM,GAAG,uBAAuB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAExD,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;YAC9B,OAAO;gBACL,MAAM;gBACN,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,sBAAsB,EAAE,IAAI;aAC7B,CAAC;QACJ,CAAC;QAED,OAAO;YACL,MAAM;YACN,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,sBAAsB,EAAE,KAAK;SAC9B,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,MAAM,EAAE,OAAO;YACf,sBAAsB,EAAE,KAAK;YAC7B,SAAS,EAAE,eAAe;SAC3B,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAzCW,QAAA,oBAAoB,wBAyC/B"}

package/dist/transport/transport-types.d.ts

@@ -0,0 +1,39 @@
+import type { IngestionLogEntry } from '../types';
+export type IngestionRequestAction = 'success' | 'drop' | 'retry' | 'unauthorized';
+export type IngestionDropErrorKind = 'invalid_endpoint' | 'max_retries_exceeded';
+export type IngestionRetryErrorKind = 'network_error';
+export type IngestionRequestResult = {
+    action: 'success';
+    status?: number;
+    shouldWarnUnauthorized: false;
+    errorKind?: never;
+} | {
+    action: 'drop';
+    status?: number;
+    shouldWarnUnauthorized: false;
+    errorKind?: IngestionDropErrorKind;
+} | {
+    action: 'retry';
+    status?: number;
+    shouldWarnUnauthorized: false;
+    errorKind?: IngestionRetryErrorKind;
+} | {
+    action: 'unauthorized';
+    status?: number;
+    shouldWarnUnauthorized: true;
+    errorKind?: never;
+};
+export interface SendIngestionRequestInput {
+    endpoint: string;
+    apiKey: string;
+    logs: IngestionLogEntry[];
+}
+export interface FetchRequestInit {
+    method: 'POST';
+    headers: Record<string, string>;
+    body: string;
+}
+export interface FetchResponseLike {
+    status: number;
+}
+export type FetchLike = (url: string, init: FetchRequestInit) => Promise<FetchResponseLike>;

package/dist/transport/transport-types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=transport-types.js.map

package/dist/transport/transport-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-types.js","sourceRoot":"","sources":["../../src/transport/transport-types.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -0,0 +1,69 @@
+export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+export interface LogFilterConfig {
+    levels?: LogLevel[];
+}
+export interface LogscopeRuntimeConfig {
+    maxBatchSize?: number;
+    flushIntervalMs?: number;
+    maxRetries?: number;
+    retryBaseDelayMs?: number;
+    retryMaxDelayMs?: number;
+}
+interface LogscopeConfigBase {
+    apiKey: string;
+    captureConsole?: boolean;
+    context?: {
+        /**
+         * @deprecated Source input is optional and falls back safely when omitted.
+         */
+        source?: string;
+    };
+    logFilter?: LogFilterConfig;
+    runtime?: LogscopeRuntimeConfig;
+}
+export interface LogscopeInitConfig {
+    apiKey: string;
+    ingestionBaseUrl?: string;
+    /**
+     * @deprecated Use ingestionBaseUrl instead.
+     */
+    endpoint?: string;
+    captureConsole?: boolean;
+    context?: {
+        /**
+         * @deprecated Source input is optional and falls back safely when omitted.
+         */
+        source?: string;
+    };
+    logFilter?: LogFilterConfig;
+    runtime?: LogscopeRuntimeConfig;
+}
+interface LogscopeIngestionTarget {
+    ingestionBaseUrl?: string;
+    /**
+     * @deprecated Use ingestionBaseUrl instead.
+     */
+    endpoint?: string;
+}
+export type LogscopeConfig = LogscopeConfigBase & LogscopeIngestionTarget;
+export interface LogscopeClient {
+    trace(message: string, metadata?: unknown): void;
+    debug(message: string, metadata?: unknown): void;
+    info(message: string, metadata?: unknown): void;
+    warn(message: string, metadata?: unknown): void;
+    error(message: string, metadata?: unknown): void;
+    fatal(message: string, metadata?: unknown): void;
+}
+export type JsonSafePrimitive = string | number | boolean | null;
+export type JsonSafeValue = JsonSafePrimitive | JsonSafeObject | JsonSafeValue[];
+export interface JsonSafeObject {
+    [key: string]: JsonSafeValue;
+}
+export interface IngestionLogEntry {
+    source: string;
+    level: LogLevel;
+    timestamp: string;
+    message: string;
+    metadata?: Record<string, unknown>;
+}
+export {};

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@logscopeai/logscope",
+  "version": "0.1.0-beta.2",
+  "description": "`logscope` is the official Node.js client SDK for Logscope.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./pino": {
+      "types": "./dist/pino.d.ts",
+      "default": "./dist/pino.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run --coverage",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "format": "prettier --config .prettierrc --write .",
+    "format:check": "prettier --config .prettierrc --check ."
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/logscopeai/logscope.git"
+  },
+  "keywords": [
+    "logscope",
+    "logging",
+    "sdk",
+    "nodejs"
+  ],
+  "author": "",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/logscopeai/logscope/issues"
+  },
+  "homepage": "https://github.com/logscopeai/logscope#readme",
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "@vitest/coverage-v8": "^2.1.8",
+    "lint-staged": "^15.4.3",
+    "prettier": "^3.4.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "lint-staged": {
+    "*.{ts,js,tsx,jsx,html,css,scss,json,md}": "npx prettier --config .prettierrc --write"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}