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

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

@@ -1,277 +0,0 @@
-import { createGatewayRequestClient, LucernApiError, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
-import { createListResult, mapGatewayData } from "./sdkSurface.js";
-export { LucernApiError };
-function asTopicArray(data) {
-    if (Array.isArray(data)) {
-        return data.filter((row) => Boolean(row) && typeof row === "object");
-    }
-    return [];
-}
-function asWritePolicyRecord(data) {
-    if (!data || typeof data !== "object") {
-        return null;
-    }
-    return data;
-}
-function asWritePolicyArray(data) {
-    if (!Array.isArray(data)) {
-        return [];
-    }
-    return data
-        .map(asWritePolicyRecord)
-        .filter((row) => Boolean(row));
-}
-function asRolePolicyRecord(data) {
-    if (!data || typeof data !== "object") {
-        return null;
-    }
-    return data;
-}
-function asRolePolicyArray(data) {
-    if (!Array.isArray(data)) {
-        return [];
-    }
-    return data
-        .map(asRolePolicyRecord)
-        .filter((row) => Boolean(row));
-}
-/**
- * Create the policy client for permission checks, grants, and write policies.
- * @param config - Gateway transport configuration.
- * @returns An object with methods to check permissions, manage grants, and manage write policies.
- */
-export function createPolicyClient(config = {}) {
-    const gateway = createGatewayRequestClient(config);
-    return {
-        /**
-         * List policy decisions in the current scope.
-         */
-        async listDecisions(query = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/policy/decisions${toQueryString(query)}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "decisions")));
-        },
-        /**
-         * Create a permission grant.
-         */
-        async grant(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/policy/grant",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Delete a permission grant by revoking it.
-         */
-        async revoke(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/policy/revoke",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * List write policy rules for the current scope.
-         */
-        async listWritePolicies(query = {}) {
-            const response = await gateway.request({
-                path: `/api/platform/v1/policy/write-policies${toQueryString(query)}`,
-            });
-            const rawPolicies = response.data && typeof response.data === "object"
-                ? response.data.policies
-                : response.data;
-            return {
-                ...response,
-                data: {
-                    policies: asWritePolicyArray(rawPolicies),
-                },
-            };
-        },
-        /**
-         * Create a write policy rule.
-         */
-        async createWritePolicy(input, idempotencyKey) {
-            const response = await gateway.request({
-                path: "/api/platform/v1/policy/write-policies",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-            return {
-                ...response,
-                data: {
-                    id: typeof response.data?.id === "string" ? response.data.id : undefined,
-                    created: response.data?.created === true,
-                    policy: asWritePolicyRecord(response.data?.policy),
-                },
-            };
-        },
-        /**
-         * Update an existing write policy rule by identifier.
-         */
-        async updateWritePolicy(id, input, idempotencyKey) {
-            const response = await gateway.request({
-                path: `/api/platform/v1/policy/write-policies/${encodeURIComponent(id)}`,
-                method: "PATCH",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-            return {
-                ...response,
-                data: {
-                    id: typeof response.data?.id === "string" ? response.data.id : undefined,
-                    updated: response.data?.updated === true,
-                    policy: asWritePolicyRecord(response.data?.policy),
-                },
-            };
-        },
-        /**
-         * Delete a write policy rule by identifier.
-         */
-        async deleteWritePolicy(id, scope = {}, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/policy/write-policies/${encodeURIComponent(id)}${toQueryString(scope)}`,
-                method: "DELETE",
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * List tenant role policies for the current scope.
-         */
-        async listRolePolicies(query = {}) {
-            const response = await gateway.request({
-                path: `/api/platform/v1/policy/roles${toQueryString(query)}`,
-            });
-            return {
-                ...response,
-                data: {
-                    policies: asRolePolicyArray(response.data?.policies),
-                },
-            };
-        },
-        /**
-         * Create a tenant role policy.
-         */
-        async createRolePolicy(input, idempotencyKey) {
-            const response = await gateway.request({
-                path: "/api/platform/v1/policy/roles",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-            return {
-                ...response,
-                data: {
-                    policy: asRolePolicyRecord(response.data?.policy),
-                },
-            };
-        },
-        /**
-         * Update a tenant role policy by identifier.
-         */
-        async updateRolePolicy(id, input, idempotencyKey) {
-            const response = await gateway.request({
-                path: `/api/platform/v1/policy/roles/${encodeURIComponent(id)}`,
-                method: "PATCH",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-            return {
-                ...response,
-                data: {
-                    policy: asRolePolicyRecord(response.data?.policy),
-                },
-            };
-        },
-        /**
-         * Delete a tenant role policy by identifier.
-         */
-        async deleteRolePolicy(id, scope = {}, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/policy/roles/${encodeURIComponent(id)}${toQueryString(scope)}`,
-                method: "DELETE",
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Check a permission decision for a topic or project scope.
-         */
-        async checkPermission(query) {
-            if (!query.topicId) {
-                throw new Error("topicId is required");
-            }
-            return gateway.request({
-                path: `/api/platform/v1/policy/check${toQueryString(query)}`,
-            });
-        },
-        /**
-         * List accessible topics for a principal.
-         */
-        async listAccessibleTopics(query = {}) {
-            const permission = query.permission ?? "read";
-            const principal = query.principal ?? query.principalId;
-            const response = await gateway.request({
-                path: `/api/platform/v1/policy/topics${toQueryString({
-                    tenantId: query.tenantId,
-                    workspaceId: query.workspaceId,
-                    permission,
-                    includeShared: query.includeShared,
-                    principal,
-                    limit: query.limit,
-                })}`,
-            });
-            return {
-                ...response,
-                data: {
-                    permission,
-                    topics: asTopicArray(response.data?.topics),
-                    total: typeof response.data?.total === "number"
-                        ? response.data.total
-                        : asTopicArray(response.data?.topics).length,
-                    deniedTopics: Array.isArray(response.data?.deniedTopics)
-                        ? response.data.deniedTopics
-                        : [],
-                },
-            };
-        },
-        /**
-         * Filter topic identifiers by permission.
-         */
-        async filterByPermission(input) {
-            const permission = input.permission ?? "read";
-            const principal = input.principal ?? input.principalId;
-            const uniqueTopicIds = [...new Set(input.topicIds ?? [])].filter((topicId) => typeof topicId === "string" && topicId.trim().length > 0);
-            const response = await gateway.request({
-                path: "/api/platform/v1/policy/filter",
-                method: "POST",
-                body: {
-                    tenantId: input.tenantId,
-                    workspaceId: input.workspaceId,
-                    topicIds: uniqueTopicIds,
-                    permission,
-                    principal,
-                },
-            });
-            const allowedTopicIds = Array.isArray(response.data?.allowedTopicIds)
-                ? response.data.allowedTopicIds
-                : [];
-            const deniedTopics = Array.isArray(response.data?.deniedTopics)
-                ? response.data.deniedTopics
-                : [];
-            return {
-                success: true,
-                data: {
-                    permission,
-                    allowedTopicIds,
-                    deniedTopics,
-                    count: typeof response.data?.count === "number"
-                        ? response.data.count
-                        : allowedTopicIds.length,
-                },
-            };
-        },
-    };
-}

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

@@ -1 +0,0 @@
-export { getPromptCatalogSnapshot } from "@/lib/langfuse/prompt-catalog";

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

@@ -1 +0,0 @@
-export { getPromptCatalogSnapshot } from "@/lib/langfuse/prompt-catalog";

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

@@ -1,34 +0,0 @@
-import { type GatewayClientConfig } from "./coreClient";
-import type { TopicIdentifierInput, ReportTemplatesResponse, ReportWithSectionsResponse } from "./types";
-/** Configuration for the reports client. */
-export type ReportsClientConfig = GatewayClientConfig;
-export type { ProjectReportsResponse, ReportTemplatesResponse, ReportWithSectionsResponse, } from "./types";
-/**
- * Create the reports client for report templates and generated reports.
- * @param config - Gateway transport configuration.
- * @returns An object with methods to list templates, list reports, and get a report.
- */
-export declare function createReportsClient(config?: ReportsClientConfig): {
-    /**
-     * List report templates.
-     */
-    listTemplates(args?: {
-        slug?: string;
-    }): Promise<import("./coreClient").PlatformGatewaySuccess<ReportTemplatesResponse>>;
-    /**
-     * @deprecated Use listTemplates.
-     */
-    getTemplates(args?: {
-        slug?: string;
-    }): Promise<import("./coreClient").PlatformGatewaySuccess<ReportTemplatesResponse>>;
-    /**
-     * List reports for a topic scope.
-     */
-    listReports(input: TopicIdentifierInput, args?: {
-        summary?: boolean;
-    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "reports">>>;
-    /**
-     * Get a generated report.
-     */
-    getReport(reportId: string): Promise<import("./coreClient").PlatformGatewaySuccess<ReportWithSectionsResponse>>;
-};

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

@@ -1,64 +0,0 @@
-import { createGatewayRequestClient, toQueryString, } from "./coreClient.js";
-import { createListResult, mapGatewayData, resolveTopicId } from "./sdkSurface.js";
-/**
- * Create the reports client for report templates and generated reports.
- * @param config - Gateway transport configuration.
- * @returns An object with methods to list templates, list reports, and get a report.
- */
-export function createReportsClient(config = {}) {
-    const gateway = createGatewayRequestClient(config);
-    return {
-        /**
-         * List report templates.
-         */
-        async listTemplates(args = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/reports/templates${toQueryString({
-                    slug: args.slug,
-                })}`,
-            }).then((response) => mapGatewayData(response, (data) => {
-                const record = data && typeof data === "object"
-                    ? data
-                    : {};
-                const rows = Array.isArray(data)
-                    ? data
-                    : Array.isArray(record.templates)
-                        ? record.templates
-                        : [];
-                return createListResult(rows, "templates");
-            }));
-        },
-        /**
-         * @deprecated Use listTemplates.
-         */
-        async getTemplates(args = {}) {
-            return this.listTemplates(args);
-        },
-        /**
-         * List reports for a topic scope.
-         */
-        async listReports(input, args = {}) {
-            const topicId = resolveTopicId(input);
-            if (!topicId) {
-                throw new Error("topicId is required");
-            }
-            return gateway.request({
-                path: `/api/platform/v1/reports/topics/${encodeURIComponent(topicId)}${toQueryString({
-                    summary: typeof args.summary === "boolean"
-                        ? args.summary
-                            ? "true"
-                            : "false"
-                        : undefined,
-                })}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "reports")));
-        },
-        /**
-         * Get a generated report.
-         */
-        async getReport(reportId) {
-            return gateway.request({
-                path: `/api/platform/v1/reports/${encodeURIComponent(reportId)}`,
-            });
-        },
-    };
-}

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

@@ -1,71 +0,0 @@
-import { createGatewayRequestClient, LucernApiError, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
-import { createListResult, mapGatewayData } from "./sdkSurface.js";
-export { LucernApiError };
-/**
- * Create the schema client for pack catalog and entitlement operations.
- * @param config - Gateway transport configuration.
- * @returns An object with methods to manage schema packs and entitlements.
- */
-export function createSchemaClient(config = {}) {
-    const gateway = createGatewayRequestClient(config);
-    return {
-        /**
-         * List schema packs.
-         */
-        async listPacks(scope = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/schema/packs${toQueryString(scope)}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "packs")));
-        },
-        /**
-         * Install a schema pack.
-         */
-        async installPack(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/schema/packs",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Get a schema pack by identifier.
-         */
-        async getPack(packId, scope = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/schema/packs/${encodeURIComponent(packId)}${toQueryString(scope)}`,
-            });
-        },
-        /**
-         * List schema entitlements.
-         */
-        async listEntitlements(scope = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/schema/entitlements${toQueryString(scope)}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "entitlements")));
-        },
-        /**
-         * Create a schema entitlement.
-         */
-        async createEntitlement(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/schema/entitlements",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Update a schema entitlement.
-         */
-        async updateEntitlement(input, idempotencyKey) {
-            return this.createEntitlement(input, idempotencyKey);
-        },
-        /**
-         * @deprecated Use createEntitlement or updateEntitlement.
-         */
-        async upsertEntitlement(input, idempotencyKey) {
-            return this.createEntitlement(input, idempotencyKey);
-        },
-    };
-}

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

@@ -1,56 +0,0 @@
-import type { PlatformGatewaySuccess } from "./coreClient";
-import type { JsonObject, ListResult } from "./types";
-type TopicScopedValue = {
-    topicId?: string;
-};
-type TextScopedValue = {
-    text?: string;
-    canonicalText?: string;
-};
-type AnyRecord = Record<string, unknown>;
-/**
- * Resolve the canonical topic identifier.
- */
-export declare function resolveTopicId(value: TopicScopedValue): string | undefined;
-/**
- * Resolve the canonical text field from text-first or legacy canonicalText-first inputs.
- */
-export declare function resolveText(value: TextScopedValue): string | undefined;
-/**
- * Attach the topicId to a record.
- */
-export declare function withTopicAlias<T extends AnyRecord>(value: T): T;
-/**
- * Attach the text/canonicalText alias pair to a record.
- */
-export declare function withTextAlias<T extends AnyRecord>(value: T): T;
-/**
- * Attach topic and text aliases to SDK node-like records.
- */
-export declare function withSdkAliases<T extends AnyRecord>(value: T): T;
-/**
- * Normalize a belief/question/evidence write payload to the canonical gateway shape.
- */
-export declare function normalizeNodeWriteInput<T extends JsonObject>(value: T): T;
-export declare function normalizeNodeVerificationStatus(value: unknown): string | undefined;
-/**
- * Build a topic-aware query object.
- */
-export declare function normalizeTopicQuery<T extends JsonObject>(value: T): T;
-/**
- * Extract list items from array or list-envelope payloads.
- */
-export declare function asListItems<T>(data: unknown, legacyKey?: string): T[];
-/**
- * Standardize list data to { items, total } while retaining an optional legacy array key.
- */
-export declare function createListResult<T, LegacyKey extends string>(items: T[], legacyKey?: LegacyKey): ListResult<T, LegacyKey>;
-/**
- * Map a gateway success envelope's data while preserving the transport metadata.
- */
-export declare function mapGatewayData<T, U>(response: PlatformGatewaySuccess<T>, mapper: (data: T) => U): PlatformGatewaySuccess<U>;
-/**
- * Apply SDK aliases across all items in a list-like payload.
- */
-export declare function mapAliasedList<TItem extends AnyRecord, LegacyKey extends string>(data: unknown, legacyKey?: LegacyKey): ListResult<TItem, LegacyKey>;
-export {};

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

@@ -1,140 +0,0 @@
-function asRecord(value) {
-    return value && typeof value === "object" ? value : {};
-}
-function cleanString(value) {
-    return typeof value === "string" && value.trim().length > 0
-        ? value.trim()
-        : undefined;
-}
-function normalizeVerificationStatus(value) {
-    const status = cleanString(value);
-    if (!status) {
-        return undefined;
-    }
-    if (status === "verified") {
-        return "human_verified";
-    }
-    if (status === "rejected") {
-        return "contradicted";
-    }
-    return status;
-}
-function cloneWith(value, patch) {
-    return { ...value, ...patch };
-}
-/**
- * Resolve the canonical topic identifier.
- */
-export function resolveTopicId(value) {
-    return cleanString(value.topicId);
-}
-/**
- * Resolve the canonical text field from text-first or legacy canonicalText-first inputs.
- */
-export function resolveText(value) {
-    return cleanString(value.text) ?? cleanString(value.canonicalText);
-}
-/**
- * Attach the topicId to a record.
- */
-export function withTopicAlias(value) {
-    const topicId = cleanString(value.topicId) ?? undefined;
-    if (!topicId) {
-        return value;
-    }
-    return cloneWith(value, { topicId });
-}
-/**
- * Attach the text/canonicalText alias pair to a record.
- */
-export function withTextAlias(value) {
-    const text = cleanString(value.text) ?? cleanString(value.canonicalText) ?? undefined;
-    if (!text) {
-        return value;
-    }
-    return cloneWith(value, { text, canonicalText: text });
-}
-/**
- * Attach topic and text aliases to SDK node-like records.
- */
-export function withSdkAliases(value) {
-    return withTopicAlias(withTextAlias(value));
-}
-/**
- * Normalize a belief/question/evidence write payload to the canonical gateway shape.
- */
-export function normalizeNodeWriteInput(value) {
-    const topicId = resolveTopicId(value);
-    const text = resolveText(value);
-    const verificationStatus = normalizeVerificationStatus(value.verificationStatus);
-    const next = { ...value };
-    if (topicId) {
-        next.topicId = topicId;
-    }
-    if (text) {
-        next.text = text;
-        next.canonicalText = text;
-    }
-    if (verificationStatus) {
-        next.verificationStatus = verificationStatus;
-    }
-    return next;
-}
-export function normalizeNodeVerificationStatus(value) {
-    return normalizeVerificationStatus(value);
-}
-/**
- * Build a topic-aware query object.
- */
-export function normalizeTopicQuery(value) {
-    const topicId = cleanString(value.topicId);
-    if (!topicId) {
-        return value;
-    }
-    return { ...value, topicId };
-}
-/**
- * Extract list items from array or list-envelope payloads.
- */
-export function asListItems(data, legacyKey) {
-    if (Array.isArray(data)) {
-        return data;
-    }
-    const record = asRecord(data);
-    if (Array.isArray(record.items)) {
-        return record.items;
-    }
-    if (legacyKey && Array.isArray(record[legacyKey])) {
-        return record[legacyKey];
-    }
-    return [];
-}
-/**
- * Standardize list data to { items, total } while retaining an optional legacy array key.
- */
-export function createListResult(items, legacyKey) {
-    const result = {
-        items,
-        total: items.length,
-    };
-    if (legacyKey) {
-        result[legacyKey] = items;
-    }
-    return result;
-}
-/**
- * Map a gateway success envelope's data while preserving the transport metadata.
- */
-export function mapGatewayData(response, mapper) {
-    return {
-        ...response,
-        data: mapper(response.data),
-    };
-}
-/**
- * Apply SDK aliases across all items in a list-like payload.
- */
-export function mapAliasedList(data, legacyKey) {
-    const items = asListItems(data, legacyKey).map((item) => withSdkAliases(item));
-    return createListResult(items, legacyKey);
-}