@lucern/sdk 0.2.0-alpha.5 → 0.2.0-alpha.7

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

@@ -1,384 +0,0 @@
-import { createGatewayRequestClient, LucernApiError, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
-import { createListResult, mapGatewayData } from "./sdkSurface.js";
-export { LucernApiError };
-function asTenantApiKeyRecord(data) {
-    if (!data || typeof data !== "object") {
-        return null;
-    }
-    return data;
-}
-function asTenantApiKeyArray(data) {
-    if (!Array.isArray(data)) {
-        return [];
-    }
-    return data
-        .map(asTenantApiKeyRecord)
-        .filter((row) => Boolean(row));
-}
-function asTenantVaultSecretRecord(data) {
-    if (!data || typeof data !== "object") {
-        return null;
-    }
-    return data;
-}
-function asTenantVaultSecretArray(data) {
-    if (!Array.isArray(data)) {
-        return [];
-    }
-    return data
-        .map(asTenantVaultSecretRecord)
-        .filter((row) => Boolean(row));
-}
-/**
- * Create the admin client for tenant, workspace, and membership administration.
- * @param config - Gateway transport configuration.
- * @returns An object with methods to manage tenants, workspaces, and memberships.
- */
-export function createAdminClient(config = {}) {
-    const gateway = createGatewayRequestClient(config);
-    return {
-        /**
-         * List tenants visible to the current principal.
-         */
-        async listTenants(query = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/tenants${toQueryString(query)}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "tenants")));
-        },
-        /**
-         * Create a tenant.
-         */
-        async createTenant(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/tenants",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Get the control-object ownership contract.
-         */
-        async getControlObjectOwnership() {
-            return gateway.request({
-                path: "/api/platform/v1/admin/control-ownership",
-            });
-        },
-        /**
-         * @deprecated Use getControlObjectOwnership.
-         */
-        async getControlObjectOwnershipContract() {
-            return gateway.request({
-                path: "/api/platform/v1/admin/control-ownership",
-            });
-        },
-        /**
-         * List workspaces for the current admin scope.
-         */
-        async listWorkspaces(query = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/workspaces${toQueryString(query)}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "workspaces")));
-        },
-        /**
-         * Create a workspace.
-         */
-        async createWorkspace(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/workspaces",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * List memberships for the current admin scope.
-         */
-        async listMemberships(query = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/memberships${toQueryString(query)}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "memberships")));
-        },
-        /**
-         * Create a membership.
-         */
-        async createMembership(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/memberships",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Update a membership.
-         */
-        async updateMembership(input, idempotencyKey) {
-            return this.createMembership(input, idempotencyKey);
-        },
-        /**
-         * @deprecated Use createMembership or updateMembership.
-         */
-        async upsertMembership(input, idempotencyKey) {
-            return this.createMembership(input, idempotencyKey);
-        },
-        /**
-         * List tenant API keys in the current admin scope.
-         */
-        async listTenantApiKeys(scope) {
-            const response = await gateway.request({
-                path: `/api/platform/v1/tenant-api-keys${toQueryString(scope)}`,
-            });
-            return {
-                ...response,
-                data: {
-                    keys: asTenantApiKeyArray(response.data?.keys),
-                },
-            };
-        },
-        /**
-         * Create a tenant API key.
-         */
-        async createTenantApiKey(input, idempotencyKey) {
-            const response = await gateway.request({
-                path: "/api/platform/v1/tenant-api-keys",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-            return {
-                ...response,
-                data: {
-                    key: asTenantApiKeyRecord(response.data?.key),
-                    plaintextKey: typeof response.data?.plaintextKey === "string"
-                        ? response.data.plaintextKey
-                        : undefined,
-                },
-            };
-        },
-        /**
-         * Revoke a tenant API key.
-         */
-        async revokeTenantApiKey(keyId, input = {}, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/tenant-api-keys/${encodeURIComponent(keyId)}/revoke`,
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * List tenant vault secrets.
-         */
-        async listTenantVaultSecrets(scope) {
-            const response = await gateway.request({
-                path: `/api/platform/v1/tenant-vault-secrets${toQueryString(scope)}`,
-            });
-            return {
-                ...response,
-                data: {
-                    secrets: asTenantVaultSecretArray(response.data?.secrets),
-                },
-            };
-        },
-        /**
-         * Create a tenant vault secret.
-         */
-        async createTenantVaultSecret(input, idempotencyKey) {
-            const response = await gateway.request({
-                path: "/api/platform/v1/tenant-vault-secrets",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-            return {
-                ...response,
-                data: {
-                    secret: asTenantVaultSecretRecord(response.data?.secret),
-                },
-            };
-        },
-        /**
-         * Update a tenant vault secret.
-         */
-        async updateTenantVaultSecret(secretId, input, idempotencyKey) {
-            const response = await gateway.request({
-                path: `/api/platform/v1/tenant-vault-secrets/${encodeURIComponent(secretId)}`,
-                method: "PATCH",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-            return {
-                ...response,
-                data: {
-                    secret: asTenantVaultSecretRecord(response.data?.secret),
-                },
-            };
-        },
-        /**
-         * Delete a tenant vault secret.
-         */
-        async deleteTenantVaultSecret(secretId, scope, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/tenant-vault-secrets/${encodeURIComponent(secretId)}${toQueryString(scope)}`,
-                method: "DELETE",
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * List tenant provider secrets.
-         */
-        async listTenantSecrets(scope) {
-            return gateway.request({
-                path: `/api/platform/v1/tenant-secrets${toQueryString(scope)}`,
-            });
-        },
-        /**
-         * Upsert a tenant provider secret.
-         */
-        async upsertTenantSecret(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/tenant-secrets",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Revoke a tenant provider secret.
-         */
-        async revokeTenantSecret(secretRef, input, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/tenant-secrets/${encodeURIComponent(secretRef)}/revoke`,
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Get tenant configuration.
-         */
-        async getTenantConfig(scope) {
-            return gateway.request({
-                path: `/api/platform/v1/tenant-config${toQueryString(scope)}`,
-            });
-        },
-        /**
-         * Get tenant model routing.
-         */
-        async getTenantModelRouting(scope) {
-            return gateway.request({
-                path: `/api/platform/v1/tenant-config/model-routing${toQueryString(scope)}`,
-            });
-        },
-        /**
-         * Upsert tenant configuration.
-         */
-        async upsertTenantConfig(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/tenant-config",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * List groups.
-         */
-        async listGroups(scope = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/groups${toQueryString(scope)}`,
-            });
-        },
-        /**
-         * Create a group.
-         */
-        async createGroup(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/groups",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Update a group.
-         */
-        async updateGroup(groupId, input, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/groups/${encodeURIComponent(groupId)}`,
-                method: "PATCH",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Delete a group.
-         */
-        async deleteGroup(groupId, input = {}, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/groups/${encodeURIComponent(groupId)}${toQueryString(input)}`,
-                method: "DELETE",
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * List group members.
-         */
-        async listGroupMembers(query) {
-            return gateway.request({
-                path: `/api/platform/v1/groups/members${toQueryString(query)}`,
-            });
-        },
-        /**
-         * Add a group member.
-         */
-        async addGroupMember(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/groups/members",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Remove a group member.
-         */
-        async removeGroupMember(input, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/groups/members${toQueryString(input)}`,
-                method: "DELETE",
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * List pack-to-group assignments.
-         */
-        async listPackGroupAssignments(query = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/groups/packs${toQueryString(query)}`,
-            });
-        },
-        /**
-         * Assign a pack to a group.
-         */
-        async assignPackToGroup(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/groups/packs",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Remove a pack from a group.
-         */
-        async removePackFromGroup(input, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/groups/packs${toQueryString(input)}`,
-                method: "DELETE",
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-    };
-}

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

@@ -1,21 +0,0 @@
-import { createGatewayRequestClient, } from "./coreClient.js";
-/**
- * Create the answers client for retrieving question answers.
- * @param config - Gateway transport configuration.
- * @returns An object with a `get` method to fetch the answer for a question.
- */
-export function createAnswersClient(config = {}) {
-    const gateway = createGatewayRequestClient(config);
-    return {
-        /**
-         * Get the current answer for a question.
-         * @param questionId - The question node identifier.
-         * @returns The answer record for the given question.
-         */
-        async get(questionId) {
-            return gateway.request({
-                path: `/api/platform/v1/questions/${encodeURIComponent(questionId)}/answer`,
-            });
-        },
-    };
-}

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

@@ -1,93 +0,0 @@
-import { type GatewayClientConfig, type GatewayScope } from "./coreClient";
-import type { JsonObject } from "./types";
-/** Configuration for the audiences client. */
-export type AudiencesClientConfig = GatewayClientConfig;
-/** Input for creating or updating an audience registry entry. */
-export type AudienceRegistryInput = GatewayScope & {
-    audienceKey: string;
-    audienceLabel: string;
-    audienceClass: "internal" | "restricted_external" | "public";
-    status?: "active" | "disabled" | "archived";
-    description?: string;
-    metadata?: JsonObject;
-};
-/** Input for creating an audience access grant. */
-export type AudienceGrantInput = GatewayScope & {
-    audienceKey: string;
-    audienceClass?: "internal" | "restricted_external" | "public";
-    principalId?: string;
-    groupId?: string;
-    expiresAt?: number;
-    metadata?: JsonObject;
-};
-/** Input for revoking an audience grant by its identifier. */
-export type AudienceGrantRevokeInput = GatewayScope & {
-    grantId: string;
-};
-/**
- * Create the audiences client for registry entries and grants.
- * @param config - Gateway transport configuration.
- * @returns An object with methods to manage audience registry entries and grants.
- */
-export declare function createAudiencesClient(config?: AudiencesClientConfig): {
-    /**
-     * List audience registry entries.
-     */
-    listRegistry(query?: GatewayScope & {
-        effective?: boolean;
-        status?: "active" | "disabled" | "archived";
-    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "registryEntries">>>;
-    /**
-     * @deprecated Use listRegistry.
-     */
-    getRegistry(query?: GatewayScope & {
-        effective?: boolean;
-        status?: "active" | "disabled" | "archived";
-    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "registryEntries">>>;
-    /**
-     * Create an audience registry entry.
-     */
-    createRegistryEntry(input: AudienceRegistryInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
-    /**
-     * Update an audience registry entry.
-     */
-    updateRegistryEntry(input: AudienceRegistryInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
-    /**
-     * @deprecated Use createRegistryEntry or updateRegistryEntry.
-     */
-    upsertRegistry(input: AudienceRegistryInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
-    /**
-     * List audience grants.
-     */
-    listGrants(query?: GatewayScope & {
-        audienceKey?: string;
-        principalId?: string;
-        groupId?: string;
-        status?: "active" | "revoked" | "expired";
-    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "grants">>>;
-    /**
-     * @deprecated Use listGrants.
-     */
-    getGrants(query?: GatewayScope & {
-        audienceKey?: string;
-        principalId?: string;
-        groupId?: string;
-        status?: "active" | "revoked" | "expired";
-    }): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "grants">>>;
-    /**
-     * Create an audience grant.
-     */
-    createGrant(input: AudienceGrantInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
-    /**
-     * @deprecated Use createGrant.
-     */
-    grant(input: AudienceGrantInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
-    /**
-     * Delete an audience grant by revoking it.
-     */
-    deleteGrant(input: AudienceGrantRevokeInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
-    /**
-     * @deprecated Use deleteGrant.
-     */
-    revokeGrant(input: AudienceGrantRevokeInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<unknown>>;
-};

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

@@ -1,111 +0,0 @@
-import { createGatewayRequestClient, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
-import { createListResult, mapGatewayData } from "./sdkSurface.js";
-/**
- * Create the audiences client for registry entries and grants.
- * @param config - Gateway transport configuration.
- * @returns An object with methods to manage audience registry entries and grants.
- */
-export function createAudiencesClient(config = {}) {
-    const gateway = createGatewayRequestClient(config);
-    return {
-        /**
-         * List audience registry entries.
-         */
-        async listRegistry(query = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/audiences/registry${toQueryString({
-                    ...query,
-                    effective: typeof query.effective === "boolean"
-                        ? query.effective
-                            ? "true"
-                            : "false"
-                        : undefined,
-                    status: query.status,
-                })}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "registryEntries")));
-        },
-        /**
-         * @deprecated Use listRegistry.
-         */
-        async getRegistry(query = {}) {
-            return this.listRegistry(query);
-        },
-        /**
-         * Create an audience registry entry.
-         */
-        async createRegistryEntry(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/audiences/registry",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Update an audience registry entry.
-         */
-        async updateRegistryEntry(input, idempotencyKey) {
-            return this.createRegistryEntry(input, idempotencyKey);
-        },
-        /**
-         * @deprecated Use createRegistryEntry or updateRegistryEntry.
-         */
-        async upsertRegistry(input, idempotencyKey) {
-            return this.createRegistryEntry(input, idempotencyKey);
-        },
-        /**
-         * List audience grants.
-         */
-        async listGrants(query = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/audiences/grants${toQueryString({
-                    ...query,
-                    audienceKey: query.audienceKey,
-                    principalId: query.principalId,
-                    groupId: query.groupId,
-                    status: query.status,
-                })}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "grants")));
-        },
-        /**
-         * @deprecated Use listGrants.
-         */
-        async getGrants(query = {}) {
-            return this.listGrants(query);
-        },
-        /**
-         * Create an audience grant.
-         */
-        async createGrant(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/audiences/grants",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * @deprecated Use createGrant.
-         */
-        async grant(input, idempotencyKey) {
-            return this.createGrant(input, idempotencyKey);
-        },
-        /**
-         * Delete an audience grant by revoking it.
-         */
-        async deleteGrant(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/audiences/grants/revoke",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * @deprecated Use deleteGrant.
-         */
-        async revokeGrant(input, idempotencyKey) {
-            return this.deleteGrant(input, idempotencyKey);
-        },
-    };
-}

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

@@ -1,24 +0,0 @@
-import { type GatewayClientConfig, type GatewayScope, LucernApiError } from "./coreClient";
-import type { TopicIdentifierInput } from "./types";
-export { LucernApiError };
-export type { GatewayScope, PlatformGatewaySuccess } from "./coreClient";
-/** Configuration for the audit client. */
-export type AuditClientConfig = GatewayClientConfig;
-/**
- * Create the audit client for transport-level audit event reads.
- * @param config - Gateway transport configuration.
- * @returns An object with methods to list audit events.
- */
-export declare function createAuditClient(config?: AuditClientConfig): {
-    /**
-     * List audit events for the current scope.
-     */
-    listEvents(query?: GatewayScope & {
-        action?: string;
-        decision?: string;
-        traceId?: string;
-        principalId?: string;
-        topicId?: string;
-        limit?: number;
-    } & TopicIdentifierInput): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "events">>>;
-};

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

@@ -1,21 +0,0 @@
-import { createGatewayRequestClient, LucernApiError, toQueryString, } from "./coreClient.js";
-import { createListResult, mapGatewayData, normalizeTopicQuery } from "./sdkSurface.js";
-export { LucernApiError };
-/**
- * Create the audit client for transport-level audit event reads.
- * @param config - Gateway transport configuration.
- * @returns An object with methods to list audit events.
- */
-export function createAuditClient(config = {}) {
-    const gateway = createGatewayRequestClient(config);
-    return {
-        /**
-         * List audit events for the current scope.
-         */
-        async listEvents(query = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/audit/events${toQueryString(normalizeTopicQuery(query))}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "events")));
-        },
-    };
-}