@lucern/sdk 0.2.0-alpha.6 → 0.2.0-alpha.8

package/dist/lib/platform/sdk/events.js

@@ -1,261 +0,0 @@
-export const DOMAIN_EVENT_VERSION = "1.0";
-export const EVENT_RETENTION_DEFAULT_DAYS = 30;
-export const WEBHOOK_MAX_ATTEMPTS = 5;
-export const WEBHOOK_RETRY_DELAYS_MS = [1_000, 5_000, 30_000, 300_000];
-export const DOMAIN_EVENT_TYPES = [
-    "belief.created",
-    "belief.forked",
-    "belief.confidence_updated",
-    "belief.archived",
-    "belief.refined",
-    "belief.contract_created",
-    "belief.contract_evaluated",
-    "belief.lineage_queried",
-    "evidence.created",
-    "evidence.linked",
-    "evidence.search_executed",
-    "question.created",
-    "question.answered",
-    "question.refined",
-    "question.status_updated",
-    "question.archived",
-    "edge.created",
-    "contradiction.flagged",
-    "worktree.created",
-    "worktree.activated",
-    "worktree.merged",
-    "worktree.targets_updated",
-    "worktree.metadata_updated",
-    "topic.created",
-    "topic.updated",
-    "topic.archived",
-    "task.created",
-    "task.completed",
-    "task.updated",
-    "ontology.bound",
-    "context.compiled",
-    "identity.key_created",
-    "identity.key_rotated",
-    "identity.key_revoked",
-    "webhook.test",
-];
-function escapeRegex(value) {
-    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-export function eventPatternToRegExp(pattern) {
-    const normalized = pattern.trim();
-    if (!normalized) {
-        return /^$/;
-    }
-    if (normalized === "*") {
-        return /^.*$/;
-    }
-    const source = escapeRegex(normalized).replace(/\\\*/g, ".*");
-    return new RegExp(`^${source}$`);
-}
-export function matchesEventPattern(eventType, pattern) {
-    return eventPatternToRegExp(pattern).test(eventType.trim());
-}
-export function matchesAnyEventPattern(eventType, patterns) {
-    if (patterns.length === 0) {
-        return true;
-    }
-    return patterns.some((pattern) => matchesEventPattern(eventType, pattern));
-}
-function toBase64(value) {
-    if (typeof Buffer !== "undefined") {
-        return Buffer.from(value, "utf8").toString("base64url");
-    }
-    return btoa(unescape(encodeURIComponent(value)))
-        .replace(/\+/g, "-")
-        .replace(/\//g, "_")
-        .replace(/=+$/g, "");
-}
-function fromBase64(value) {
-    if (typeof Buffer !== "undefined") {
-        return Buffer.from(value, "base64url").toString("utf8");
-    }
-    const normalized = value.replace(/-/g, "+").replace(/_/g, "/");
-    return decodeURIComponent(escape(atob(normalized)));
-}
-export function createEventId() {
-    const random = typeof globalThis.crypto?.randomUUID === "function"
-        ? globalThis.crypto.randomUUID().replace(/-/g, "")
-        : Array.from(typeof globalThis.crypto?.getRandomValues === "function"
-            ? globalThis.crypto.getRandomValues(new Uint8Array(16))
-            : Array.from({ length: 16 }, () => Math.floor(Math.random() * 256)), (value) => value.toString(16).padStart(2, "0")).join("");
-    return `evt_${random}`;
-}
-export function normalizeRetentionDays(value) {
-    if (!Number.isFinite(value) || typeof value !== "number" || value <= 0) {
-        return EVENT_RETENTION_DEFAULT_DAYS;
-    }
-    return Math.max(1, Math.trunc(value));
-}
-export function buildDomainEvent(input) {
-    const timestamp = input.timestamp ?? Date.now();
-    const retentionDays = normalizeRetentionDays(input.retentionDays);
-    return {
-        eventId: input.eventId?.trim() || createEventId(),
-        type: input.type.trim(),
-        version: DOMAIN_EVENT_VERSION,
-        timestamp,
-        tenantId: input.tenantId?.trim() || undefined,
-        workspaceId: input.workspaceId?.trim() || undefined,
-        topicId: input.topicId.trim(),
-        resourceId: input.resourceId.trim(),
-        resourceType: input.resourceType.trim(),
-        actorId: input.actorId.trim(),
-        actorType: input.actorType,
-        data: input.data ?? {},
-        correlationId: input.correlationId?.trim() || undefined,
-        expiresAt: timestamp + retentionDays * 24 * 60 * 60 * 1000,
-    };
-}
-export function compareEventCursor(left, right) {
-    if (left.timestamp !== right.timestamp) {
-        return left.timestamp - right.timestamp;
-    }
-    return left.eventId.localeCompare(right.eventId);
-}
-export function encodeEventCursor(cursor) {
-    return toBase64(JSON.stringify(cursor));
-}
-export function decodeEventCursor(cursor) {
-    if (!cursor || cursor.trim().length === 0) {
-        return null;
-    }
-    try {
-        const parsed = JSON.parse(fromBase64(cursor.trim()));
-        if (typeof parsed.timestamp !== "number" ||
-            !Number.isFinite(parsed.timestamp) ||
-            typeof parsed.eventId !== "string" ||
-            parsed.eventId.trim().length === 0) {
-            return null;
-        }
-        return {
-            timestamp: parsed.timestamp,
-            eventId: parsed.eventId.trim(),
-        };
-    }
-    catch {
-        return null;
-    }
-}
-export function isAfterCursor(event, cursor) {
-    if (!cursor) {
-        return true;
-    }
-    return compareEventCursor(event, cursor) > 0;
-}
-export function sortEventsByCursor(events) {
-    return [...events].sort((left, right) => compareEventCursor(left, right));
-}
-export function inferActorType(args) {
-    if (args.sessionType === "agent") {
-        return "agent";
-    }
-    if (args.authMode === "service_principal" ||
-        args.authMode === "tenant_api_key" ||
-        args.principalType === "service") {
-        return "service";
-    }
-    return "human";
-}
-export async function emitDomainEvent(invokeMutation, input) {
-    return await invokeMutation("events:recordEvent", input);
-}
-const LOCALHOST_HOSTS = new Set(["localhost", "127.0.0.1", "::1"]);
-function normalizeUrl(url) {
-    try {
-        return new URL(url.trim());
-    }
-    catch {
-        throw new Error("Webhook URL must be a valid absolute URL.");
-    }
-}
-export function assertValidWebhookUrl(url) {
-    const parsed = normalizeUrl(url);
-    const hostname = parsed.hostname.trim().toLowerCase();
-    const nodeEnv = typeof process !== "undefined" ? process.env?.NODE_ENV : undefined;
-    const allowLocalHttp = nodeEnv === "test" || LOCALHOST_HOSTS.has(hostname);
-    if (parsed.protocol !== "https:" && !(allowLocalHttp && parsed.protocol === "http:")) {
-        throw new Error("Webhook URL must use HTTPS.");
-    }
-    return parsed.toString();
-}
-export function normalizeWebhookPatterns(patterns) {
-    const normalized = Array.from(new Set(patterns
-        .map((pattern) => pattern.trim())
-        .filter((pattern) => pattern.length > 0)));
-    if (normalized.length === 0) {
-        throw new Error("At least one webhook event pattern is required.");
-    }
-    return normalized;
-}
-export function assertValidWebhookSecret(secret) {
-    const normalized = secret.trim();
-    if (normalized.length < 8) {
-        throw new Error("Webhook secret must be at least 8 characters.");
-    }
-    return normalized;
-}
-export async function computeWebhookSignature(payload, secret) {
-    const encoder = new TextEncoder();
-    const key = await crypto.subtle.importKey("raw", encoder.encode(secret), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
-    const signature = await crypto.subtle.sign("HMAC", key, encoder.encode(payload));
-    return Array.from(new Uint8Array(signature))
-        .map((byte) => byte.toString(16).padStart(2, "0"))
-        .join("");
-}
-export function nextDeliveryAttemptAt(currentAttemptCount, now = Date.now()) {
-    if (currentAttemptCount >= WEBHOOK_MAX_ATTEMPTS) {
-        return undefined;
-    }
-    const retryIndex = currentAttemptCount - 1;
-    const delay = WEBHOOK_RETRY_DELAYS_MS[retryIndex];
-    return typeof delay === "number" ? now + delay : undefined;
-}
-export function resolveDeliveryFailureStatus(attemptCount) {
-    return attemptCount >= WEBHOOK_MAX_ATTEMPTS ? "dead_letter" : "failed";
-}
-export function sanitizeWebhookRecord(value) {
-    return {
-        id: String(value.id ?? value.webhookId ?? value._id ?? ""),
-        webhookId: String(value.webhookId ?? value.id ?? value._id ?? ""),
-        tenantId: typeof value.tenantId === "string" && value.tenantId.trim().length > 0
-            ? value.tenantId
-            : undefined,
-        workspaceId: typeof value.workspaceId === "string" && value.workspaceId.trim().length > 0
-            ? value.workspaceId
-            : undefined,
-        topicId: typeof value.topicId === "string" && value.topicId.trim().length > 0
-            ? value.topicId
-            : undefined,
-        url: String(value.url ?? ""),
-        events: Array.isArray(value.events)
-            ? value.events
-                .map((entry) => (typeof entry === "string" ? entry.trim() : ""))
-                .filter(Boolean)
-            : [],
-        active: value.active !== false,
-        secretConfigured: true,
-        createdAt: Number(value.createdAt ?? Date.now()),
-        updatedAt: Number(value.updatedAt ?? value.createdAt ?? Date.now()),
-        createdBy: String(value.createdBy ?? ""),
-        updatedBy: String(value.updatedBy ?? value.createdBy ?? ""),
-        lastDeliveryAt: typeof value.lastDeliveryAt === "number" ? value.lastDeliveryAt : undefined,
-        lastSuccessfulDeliveryAt: typeof value.lastSuccessfulDeliveryAt === "number"
-            ? value.lastSuccessfulDeliveryAt
-            : undefined,
-    };
-}
-export function truncateWebhookResponseBody(responseBody, maxLength = 2_000) {
-    if (!responseBody) {
-        return undefined;
-    }
-    if (responseBody.length <= maxLength) {
-        return responseBody;
-    }
-    return `${responseBody.slice(0, maxLength - 3)}...`;
-}

package/dist/lib/platform/sdk/eventsCore.d.ts

@@ -1,13 +0,0 @@
-/**
- * Internal events/webhooks client factories exposed for testing / audit.
- *
- * These core factories live in `@lucern/client-core` and are bundled
- * into `@lucern/sdk` at build time via the tsup alias map. Re-exported
- * here so downstream test/audit tooling can import them from the
- * public `@lucern/sdk` entry point instead of reaching into the
- * package internals directly.
- *
- * Added: EK-16 T7.3.4 (2026-04-18).
- */
-export { createEventsClientCore, type EventsClientCoreConfig, } from "@/lucern/packages/client-core/src/events";
-export { createWebhooksClientCore, type WebhooksClientCoreConfig, } from "@/lucern/packages/client-core/src/webhooks";

package/dist/lib/platform/sdk/eventsCore.js

@@ -1,13 +0,0 @@
-/**
- * Internal events/webhooks client factories exposed for testing / audit.
- *
- * These core factories live in `@lucern/client-core` and are bundled
- * into `@lucern/sdk` at build time via the tsup alias map. Re-exported
- * here so downstream test/audit tooling can import them from the
- * public `@lucern/sdk` entry point instead of reaching into the
- * package internals directly.
- *
- * Added: EK-16 T7.3.4 (2026-04-18).
- */
-export { createEventsClientCore, } from "@/lucern/packages/client-core/src/events";
-export { createWebhooksClientCore, } from "@/lucern/packages/client-core/src/webhooks";