@clef-sh/runtime 0.1.6-beta.32

package/dist/telemetry.d.ts

@@ -0,0 +1,129 @@
+/** Base fields present on every telemetry event. */
+interface TelemetryEventBase {
+    type: string;
+    timestamp: string;
+    agentId: string;
+    identity: string;
+    environment: string;
+    sourceType: string;
+}
+export interface AgentStartedEvent extends TelemetryEventBase {
+    type: "agent.started";
+    version: string;
+}
+export interface AgentStoppedEvent extends TelemetryEventBase {
+    type: "agent.stopped";
+    reason: "signal" | "error" | "lambda_shutdown";
+    uptimeSeconds: number;
+}
+export interface ArtifactRefreshedEvent extends TelemetryEventBase {
+    type: "artifact.refreshed";
+    revision: string;
+    keyCount: number;
+    kmsEnvelope: boolean;
+}
+export interface ArtifactRevokedEvent extends TelemetryEventBase {
+    type: "artifact.revoked";
+    revokedAt: string;
+}
+export interface ArtifactExpiredEvent extends TelemetryEventBase {
+    type: "artifact.expired";
+    expiresAt: string;
+}
+export interface FetchFailedEvent extends TelemetryEventBase {
+    type: "fetch.failed";
+    error: string;
+    diskCacheAvailable: boolean;
+}
+export interface CacheExpiredEvent extends TelemetryEventBase {
+    type: "cache.expired";
+    cacheTtlSeconds: number;
+    diskCachePurged: boolean;
+}
+export interface ArtifactInvalidEvent extends TelemetryEventBase {
+    type: "artifact.invalid";
+    reason: string;
+    error: string;
+}
+/** Discriminated union of all telemetry event types. */
+export type TelemetryEvent = AgentStartedEvent | AgentStoppedEvent | ArtifactRefreshedEvent | ArtifactRevokedEvent | ArtifactExpiredEvent | FetchFailedEvent | CacheExpiredEvent | ArtifactInvalidEvent;
+/** Configuration for the telemetry emitter. */
+export interface TelemetryOptions {
+    /** OTLP HTTP endpoint (e.g. `http://localhost:4318/v1/logs`). */
+    url: string;
+    /** Custom HTTP headers for the OTLP endpoint (e.g. `{ Authorization: "Bearer ..." }` or `{ "DD-API-KEY": "..." }`). */
+    headers?: Record<string, string>;
+    /** Service version — used in OTLP resource and scope. */
+    version: string;
+    /** Unique agent/instance ID. */
+    agentId: string;
+    /** Service identity name. */
+    identity: string;
+    /** Target environment. */
+    environment: string;
+    /** Source type: `"vcs"`, `"http"`, or `"file"`. */
+    sourceType: string;
+    /** Flush interval in milliseconds. Default: 10_000 (10s). */
+    flushIntervalMs?: number;
+    /** Max buffered events before auto-flush. Default: 50. */
+    maxBufferSize?: number;
+}
+/**
+ * Telemetry emitter that buffers events and delivers them as OTLP LogRecords
+ * via HTTP POST to any OTLP-compatible endpoint.
+ *
+ * Zero external dependencies — uses built-in `fetch()` and hand-constructed
+ * OTLP JSON (no protobuf, no SDK).
+ *
+ * All event methods are fire-and-forget — telemetry never disrupts the critical path.
+ */
+export declare class TelemetryEmitter {
+    private buffer;
+    private timer;
+    private readonly opts;
+    private readonly maxBufferSize;
+    constructor(options: TelemetryOptions);
+    agentStarted(fields: {
+        version: string;
+    }): void;
+    agentStopped(fields: {
+        reason: AgentStoppedEvent["reason"];
+        uptimeSeconds: number;
+    }): void;
+    artifactRefreshed(fields: {
+        revision: string;
+        keyCount: number;
+        kmsEnvelope: boolean;
+    }): void;
+    artifactRevoked(fields: {
+        revokedAt: string;
+    }): void;
+    artifactExpired(fields: {
+        expiresAt: string;
+    }): void;
+    fetchFailed(fields: {
+        error: string;
+        diskCacheAvailable: boolean;
+    }): void;
+    cacheExpired(fields: {
+        cacheTtlSeconds: number;
+        diskCachePurged: boolean;
+    }): void;
+    artifactInvalid(fields: {
+        reason: string;
+        error: string;
+    }): void;
+    /** Fire-and-forget flush of the current buffer. */
+    flush(): void;
+    /** Awaitable flush for graceful shutdown. */
+    flushAsync(): Promise<void>;
+    /** Stop the flush timer and fire-and-forget remaining events. */
+    stop(): void;
+    /** Stop the flush timer and await final flush. */
+    stopAsync(): Promise<void>;
+    private emit;
+    /** Convert a batch of TelemetryEvents to an OTLP ExportLogsServiceRequest JSON string. */
+    private toOtlpPayload;
+}
+export {};
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

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

package/dist/telemetry.js

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryEmitter = void 0;
+/** OTLP severity levels by event type. */
+const SEVERITY = {
+    "agent.started": { number: 9, text: "INFO" },
+    "agent.stopped": { number: 9, text: "INFO" },
+    "artifact.refreshed": { number: 9, text: "INFO" },
+    "artifact.revoked": { number: 13, text: "WARN" },
+    "artifact.expired": { number: 13, text: "WARN" },
+    "fetch.failed": { number: 13, text: "WARN" },
+    "cache.expired": { number: 17, text: "ERROR" },
+    "artifact.invalid": { number: 17, text: "ERROR" },
+};
+/** Base fields that belong in the OTLP resource, not per-record attributes. */
+const BASE_FIELDS = new Set([
+    "type",
+    "timestamp",
+    "agentId",
+    "identity",
+    "environment",
+    "sourceType",
+]);
+/** Convert a value to an OTLP typed attribute value. */
+function otlpValue(v) {
+    if (typeof v === "boolean")
+        return { boolValue: v };
+    if (typeof v === "number")
+        return { intValue: String(v) };
+    return { stringValue: String(v) };
+}
+/** Convert ISO-8601 timestamp to nanosecond Unix epoch string. */
+function isoToUnixNano(iso) {
+    return String(new Date(iso).getTime() * 1_000_000);
+}
+/**
+ * Telemetry emitter that buffers events and delivers them as OTLP LogRecords
+ * via HTTP POST to any OTLP-compatible endpoint.
+ *
+ * Zero external dependencies — uses built-in `fetch()` and hand-constructed
+ * OTLP JSON (no protobuf, no SDK).
+ *
+ * All event methods are fire-and-forget — telemetry never disrupts the critical path.
+ */
+class TelemetryEmitter {
+    buffer = [];
+    timer = null;
+    opts;
+    maxBufferSize;
+    constructor(options) {
+        this.opts = options;
+        this.maxBufferSize = options.maxBufferSize ?? 50;
+        const intervalMs = options.flushIntervalMs ?? 10_000;
+        this.timer = setInterval(() => this.flush(), intervalMs);
+        this.timer.unref();
+    }
+    agentStarted(fields) {
+        this.emit({ type: "agent.started", ...fields });
+    }
+    agentStopped(fields) {
+        this.emit({ type: "agent.stopped", ...fields });
+    }
+    artifactRefreshed(fields) {
+        this.emit({ type: "artifact.refreshed", ...fields });
+    }
+    artifactRevoked(fields) {
+        this.emit({ type: "artifact.revoked", ...fields });
+    }
+    artifactExpired(fields) {
+        this.emit({ type: "artifact.expired", ...fields });
+    }
+    fetchFailed(fields) {
+        this.emit({ type: "fetch.failed", ...fields });
+    }
+    cacheExpired(fields) {
+        this.emit({ type: "cache.expired", ...fields });
+    }
+    artifactInvalid(fields) {
+        this.emit({ type: "artifact.invalid", ...fields });
+    }
+    /** Fire-and-forget flush of the current buffer. */
+    flush() {
+        if (this.buffer.length === 0)
+            return;
+        const batch = this.buffer;
+        this.buffer = [];
+        fetch(this.opts.url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json", ...this.opts.headers },
+            body: this.toOtlpPayload(batch),
+        }).catch(() => {
+            // Best-effort delivery — telemetry must never disrupt the critical path
+        });
+    }
+    /** Awaitable flush for graceful shutdown. */
+    async flushAsync() {
+        if (this.buffer.length === 0)
+            return;
+        const batch = this.buffer;
+        this.buffer = [];
+        try {
+            await fetch(this.opts.url, {
+                method: "POST",
+                headers: { "Content-Type": "application/json", ...this.opts.headers },
+                body: this.toOtlpPayload(batch),
+            });
+        }
+        catch {
+            // Best-effort delivery
+        }
+    }
+    /** Stop the flush timer and fire-and-forget remaining events. */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        this.flush();
+    }
+    /** Stop the flush timer and await final flush. */
+    async stopAsync() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        await this.flushAsync();
+    }
+    emit(fields) {
+        try {
+            const event = {
+                ...fields,
+                timestamp: new Date().toISOString(),
+                agentId: this.opts.agentId,
+                identity: this.opts.identity,
+                environment: this.opts.environment,
+                sourceType: this.opts.sourceType,
+            };
+            this.buffer.push(event);
+            if (this.buffer.length >= this.maxBufferSize) {
+                this.flush();
+            }
+        }
+        catch {
+            // Telemetry must never disrupt the critical path
+        }
+    }
+    /** Convert a batch of TelemetryEvents to an OTLP ExportLogsServiceRequest JSON string. */
+    toOtlpPayload(events) {
+        const first = events[0];
+        const resourceAttributes = [
+            { key: "service.name", value: { stringValue: "clef-agent" } },
+            { key: "service.version", value: { stringValue: this.opts.version } },
+            { key: "clef.agent.id", value: { stringValue: first.agentId } },
+            { key: "clef.identity", value: { stringValue: first.identity } },
+            { key: "clef.environment", value: { stringValue: first.environment } },
+            { key: "clef.source.type", value: { stringValue: first.sourceType } },
+        ];
+        const logRecords = events.map((event) => {
+            const severity = SEVERITY[event.type] ?? { number: 9, text: "INFO" };
+            const attributes = [
+                { key: "event.name", value: { stringValue: `clef.${event.type}` } },
+            ];
+            for (const [key, val] of Object.entries(event)) {
+                if (BASE_FIELDS.has(key))
+                    continue;
+                attributes.push({ key: `clef.${key}`, value: otlpValue(val) });
+            }
+            return {
+                timeUnixNano: isoToUnixNano(event.timestamp),
+                severityNumber: severity.number,
+                severityText: severity.text,
+                body: { stringValue: event.type },
+                attributes,
+            };
+        });
+        return JSON.stringify({
+            resourceLogs: [
+                {
+                    resource: { attributes: resourceAttributes },
+                    scopeLogs: [
+                        {
+                            scope: { name: "clef.runtime", version: this.opts.version },
+                            logRecords,
+                        },
+                    ],
+                },
+            ],
+        });
+    }
+}
+exports.TelemetryEmitter = TelemetryEmitter;
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

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

package/dist/vcs/bitbucket.d.ts

@@ -0,0 +1,11 @@
+import { VcsProvider, VcsProviderConfig, VcsFileResult } from "./types";
+/** Bitbucket Source API provider. */
+export declare class BitbucketProvider implements VcsProvider {
+    private readonly repo;
+    private readonly token;
+    private readonly ref;
+    private readonly apiUrl;
+    constructor(config: VcsProviderConfig);
+    fetchFile(path: string): Promise<VcsFileResult>;
+}
+//# sourceMappingURL=bitbucket.d.ts.map

package/dist/vcs/bitbucket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitbucket.d.ts","sourceRoot":"","sources":["../../src/vcs/bitbucket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAMxE,qCAAqC;AACrC,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,iBAAiB;IAO/B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAkCtD"}

package/dist/vcs/bitbucket.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BitbucketProvider = void 0;
+/** Bitbucket Source API provider. */
+class BitbucketProvider {
+    repo;
+    token;
+    ref;
+    apiUrl;
+    constructor(config) {
+        this.repo = config.repo;
+        this.token = config.token;
+        this.ref = config.ref ?? "main";
+        this.apiUrl = config.apiUrl ?? "https://api.bitbucket.org";
+    }
+    async fetchFile(path) {
+        const baseUrl = `${this.apiUrl}/2.0/repositories/${this.repo}/src/${this.ref}/${path}`;
+        // Fetch metadata (JSON) for the commit hash
+        const metaRes = await fetch(baseUrl, {
+            headers: {
+                Authorization: `Bearer ${this.token}`,
+                Accept: "application/json",
+            },
+        });
+        if (!metaRes.ok) {
+            throw new Error(`Bitbucket API error: ${metaRes.status} fetching ${path} from ${this.repo}`);
+        }
+        const meta = (await metaRes.json());
+        // Fetch raw file content
+        const rawRes = await fetch(baseUrl, {
+            headers: {
+                Authorization: `Bearer ${this.token}`,
+            },
+        });
+        if (!rawRes.ok) {
+            throw new Error(`Bitbucket API error: ${rawRes.status} fetching raw content of ${path} from ${this.repo}`);
+        }
+        const content = await rawRes.text();
+        return { content, sha: meta.commit.hash };
+    }
+}
+exports.BitbucketProvider = BitbucketProvider;
+//# sourceMappingURL=bitbucket.js.map

package/dist/vcs/bitbucket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitbucket.js","sourceRoot":"","sources":["../../src/vcs/bitbucket.ts"],"names":[],"mappings":";;;AAMA,qCAAqC;AACrC,MAAa,iBAAiB;IACX,IAAI,CAAS;IACb,KAAK,CAAS;IACd,GAAG,CAAS;IACZ,MAAM,CAAS;IAEhC,YAAY,MAAyB;QACnC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,2BAA2B,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAY;QAC1B,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,MAAM,qBAAqB,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;QAEvF,4CAA4C;QAC5C,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE;YACnC,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,IAAI,CAAC,KAAK,EAAE;gBACrC,MAAM,EAAE,kBAAkB;aAC3B;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAO,CAAC,MAAM,aAAa,IAAI,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/F,CAAC;QAED,MAAM,IAAI,GAA0B,CAAC,MAAM,OAAO,CAAC,IAAI,EAAE,CAA0B,CAAC;QAEpF,yBAAyB;QACzB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE;YAClC,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,IAAI,CAAC,KAAK,EAAE;aACtC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,wBAAwB,MAAM,CAAC,MAAM,4BAA4B,IAAI,SAAS,IAAI,CAAC,IAAI,EAAE,CAC1F,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAEpC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;CACF;AA/CD,8CA+CC"}

package/dist/vcs/github.d.ts

@@ -0,0 +1,11 @@
+import { VcsProvider, VcsProviderConfig, VcsFileResult } from "./types";
+/** GitHub Contents API provider. */
+export declare class GitHubProvider implements VcsProvider {
+    private readonly repo;
+    private readonly token;
+    private readonly ref?;
+    private readonly apiUrl;
+    constructor(config: VcsProviderConfig);
+    fetchFile(path: string): Promise<VcsFileResult>;
+}
+//# sourceMappingURL=github.d.ts.map

package/dist/vcs/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/vcs/github.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAQxE,oCAAoC;AACpC,qBAAa,cAAe,YAAW,WAAW;IAChD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,iBAAiB;IAO/B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAoBtD"}

package/dist/vcs/github.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitHubProvider = void 0;
+/** GitHub Contents API provider. */
+class GitHubProvider {
+    repo;
+    token;
+    ref;
+    apiUrl;
+    constructor(config) {
+        this.repo = config.repo;
+        this.token = config.token;
+        this.ref = config.ref;
+        this.apiUrl = config.apiUrl ?? "https://api.github.com";
+    }
+    async fetchFile(path) {
+        const url = new URL(`/repos/${this.repo}/contents/${path}`, this.apiUrl);
+        if (this.ref)
+            url.searchParams.set("ref", this.ref);
+        const res = await fetch(url.toString(), {
+            headers: {
+                Authorization: `Bearer ${this.token}`,
+                Accept: "application/vnd.github+json",
+            },
+        });
+        if (!res.ok) {
+            throw new Error(`GitHub API error: ${res.status} fetching ${path} from ${this.repo}`);
+        }
+        const data = (await res.json());
+        const content = Buffer.from(data.content, "base64").toString("utf-8");
+        return { content, sha: data.sha };
+    }
+}
+exports.GitHubProvider = GitHubProvider;
+//# sourceMappingURL=github.js.map

package/dist/vcs/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/vcs/github.ts"],"names":[],"mappings":";;;AAQA,oCAAoC;AACpC,MAAa,cAAc;IACR,IAAI,CAAS;IACb,KAAK,CAAS;IACd,GAAG,CAAU;IACb,MAAM,CAAS;IAEhC,YAAY,MAAyB;QACnC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,wBAAwB,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAY;QAC1B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,IAAI,CAAC,IAAI,aAAa,IAAI,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACzE,IAAI,IAAI,CAAC,GAAG;YAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAEpD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;YACtC,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,IAAI,CAAC,KAAK,EAAE;gBACrC,MAAM,EAAE,6BAA6B;aACtC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,MAAM,aAAa,IAAI,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACxF,CAAC;QAED,MAAM,IAAI,GAA2B,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA2B,CAAC;QAClF,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAEtE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;IACpC,CAAC;CACF;AAjCD,wCAiCC"}

package/dist/vcs/gitlab.d.ts

@@ -0,0 +1,11 @@
+import { VcsProvider, VcsProviderConfig, VcsFileResult } from "./types";
+/** GitLab Repository Files API provider. */
+export declare class GitLabProvider implements VcsProvider {
+    private readonly repo;
+    private readonly token;
+    private readonly ref?;
+    private readonly apiUrl;
+    constructor(config: VcsProviderConfig);
+    fetchFile(path: string): Promise<VcsFileResult>;
+}
+//# sourceMappingURL=gitlab.d.ts.map

package/dist/vcs/gitlab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab.d.ts","sourceRoot":"","sources":["../../src/vcs/gitlab.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAQxE,4CAA4C;AAC5C,qBAAa,cAAe,YAAW,WAAW;IAChD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,iBAAiB;IAO/B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAwBtD"}

package/dist/vcs/gitlab.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitLabProvider = void 0;
+/** GitLab Repository Files API provider. */
+class GitLabProvider {
+    repo;
+    token;
+    ref;
+    apiUrl;
+    constructor(config) {
+        this.repo = config.repo;
+        this.token = config.token;
+        this.ref = config.ref;
+        this.apiUrl = config.apiUrl ?? "https://gitlab.com";
+    }
+    async fetchFile(path) {
+        const encodedRepo = encodeURIComponent(this.repo);
+        const encodedPath = encodeURIComponent(path);
+        const url = new URL(`/api/v4/projects/${encodedRepo}/repository/files/${encodedPath}`, this.apiUrl);
+        if (this.ref)
+            url.searchParams.set("ref", this.ref);
+        const res = await fetch(url.toString(), {
+            headers: {
+                "PRIVATE-TOKEN": this.token,
+            },
+        });
+        if (!res.ok) {
+            throw new Error(`GitLab API error: ${res.status} fetching ${path} from ${this.repo}`);
+        }
+        const data = (await res.json());
+        const content = Buffer.from(data.content, "base64").toString("utf-8");
+        return { content, sha: data.blob_id };
+    }
+}
+exports.GitLabProvider = GitLabProvider;
+//# sourceMappingURL=gitlab.js.map

package/dist/vcs/gitlab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab.js","sourceRoot":"","sources":["../../src/vcs/gitlab.ts"],"names":[],"mappings":";;;AAQA,4CAA4C;AAC5C,MAAa,cAAc;IACR,IAAI,CAAS;IACb,KAAK,CAAS;IACd,GAAG,CAAU;IACb,MAAM,CAAS;IAEhC,YAAY,MAAyB;QACnC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,oBAAoB,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAY;QAC1B,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,IAAI,GAAG,CACjB,oBAAoB,WAAW,qBAAqB,WAAW,EAAE,EACjE,IAAI,CAAC,MAAM,CACZ,CAAC;QACF,IAAI,IAAI,CAAC,GAAG;YAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAEpD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;YACtC,OAAO,EAAE;gBACP,eAAe,EAAE,IAAI,CAAC,KAAK;aAC5B;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,MAAM,aAAa,IAAI,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACxF,CAAC;QAED,MAAM,IAAI,GAAuB,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAuB,CAAC;QAC1E,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAEtE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IACxC,CAAC;CACF;AArCD,wCAqCC"}

package/dist/vcs/index.d.ts

@@ -0,0 +1,8 @@
+export type { VcsProvider, VcsProviderConfig, VcsFileResult } from "./types";
+export { GitHubProvider } from "./github";
+export { GitLabProvider } from "./gitlab";
+export { BitbucketProvider } from "./bitbucket";
+import { VcsProvider, VcsProviderConfig } from "./types";
+/** Create a VCS provider from configuration. */
+export declare function createVcsProvider(config: VcsProviderConfig): VcsProvider;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vcs/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAKzD,gDAAgD;AAChD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAWxE"}

package/dist/vcs/index.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BitbucketProvider = exports.GitLabProvider = exports.GitHubProvider = void 0;
+exports.createVcsProvider = createVcsProvider;
+var github_1 = require("./github");
+Object.defineProperty(exports, "GitHubProvider", { enumerable: true, get: function () { return github_1.GitHubProvider; } });
+var gitlab_1 = require("./gitlab");
+Object.defineProperty(exports, "GitLabProvider", { enumerable: true, get: function () { return gitlab_1.GitLabProvider; } });
+var bitbucket_1 = require("./bitbucket");
+Object.defineProperty(exports, "BitbucketProvider", { enumerable: true, get: function () { return bitbucket_1.BitbucketProvider; } });
+const github_2 = require("./github");
+const gitlab_2 = require("./gitlab");
+const bitbucket_2 = require("./bitbucket");
+/** Create a VCS provider from configuration. */
+function createVcsProvider(config) {
+    switch (config.provider) {
+        case "github":
+            return new github_2.GitHubProvider(config);
+        case "gitlab":
+            return new gitlab_2.GitLabProvider(config);
+        case "bitbucket":
+            return new bitbucket_2.BitbucketProvider(config);
+        default:
+            throw new Error(`Unsupported VCS provider: ${config.provider}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/vcs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vcs/index.ts"],"names":[],"mappings":";;;AAWA,8CAWC;AArBD,mCAA0C;AAAjC,wGAAA,cAAc,OAAA;AACvB,mCAA0C;AAAjC,wGAAA,cAAc,OAAA;AACvB,yCAAgD;AAAvC,8GAAA,iBAAiB,OAAA;AAG1B,qCAA0C;AAC1C,qCAA0C;AAC1C,2CAAgD;AAEhD,gDAAgD;AAChD,SAAgB,iBAAiB,CAAC,MAAyB;IACzD,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,QAAQ;YACX,OAAO,IAAI,uBAAc,CAAC,MAAM,CAAC,CAAC;QACpC,KAAK,QAAQ;YACX,OAAO,IAAI,uBAAc,CAAC,MAAM,CAAC,CAAC;QACpC,KAAK,WAAW;YACd,OAAO,IAAI,6BAAiB,CAAC,MAAM,CAAC,CAAC;QACvC;YACE,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,CAAC,QAAkB,EAAE,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC"}

package/dist/vcs/types.d.ts

@@ -0,0 +1,29 @@
+/** Result of fetching a file from a VCS provider. */
+export interface VcsFileResult {
+    /** Raw file content. */
+    content: string;
+    /** Git blob SHA for change detection. */
+    sha: string;
+}
+/** Configuration for a VCS provider. */
+export interface VcsProviderConfig {
+    /** VCS platform. */
+    provider: "github" | "gitlab" | "bitbucket";
+    /** Repository identifier, e.g. "owner/repo". */
+    repo: string;
+    /** Authentication token. */
+    token: string;
+    /** Branch, tag, or commit SHA. Defaults to the repo's default branch. */
+    ref?: string;
+    /** Custom base URL for self-hosted instances (GHE, GitLab CE/EE, Bitbucket DC). */
+    apiUrl?: string;
+}
+/** Fetches files from a VCS provider API. */
+export interface VcsProvider {
+    /**
+     * Fetch a single file by path from the repository.
+     * @param path - Repository-relative file path (e.g. `.clef/packed/api/production.age.json`).
+     */
+    fetchFile(path: string): Promise<VcsFileResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/vcs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/vcs/types.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IAChC,oBAAoB;IACpB,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC5C,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,6CAA6C;AAC7C,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACjD"}

package/dist/vcs/types.js

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

package/dist/vcs/types.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@clef-sh/runtime",
+  "version": "0.1.6-beta.32",
+  "description": "Lightweight runtime secrets engine for Clef — VCS-native fetch, age decrypt, in-memory cache",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/clef-sh/clef",
+    "directory": "packages/runtime"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:coverage": "jest --coverage"
+  },
+  "dependencies": {
+    "age-encryption": "^0.3.0"
+  },
+  "optionalDependencies": {
+    "@aws-sdk/client-kms": "^3.500.0",
+    "@azure/identity": "^4.0.0",
+    "@azure/keyvault-keys": "^4.8.0",
+    "@google-cloud/kms": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.11.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.4.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "license": "MIT"
+}