cliodot 1.2.2 → 1.2.4

package/dist/IdentityAppClient.js

@@ -0,0 +1,197 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdentityAppClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const errors_1 = require("./errors");
+const parse_api_error_1 = require("./http/parse-api-error");
+const cliodot_request_1 = require("./http/cliodot-request");
+function trimBaseUrl(url) {
+    return url.trim().replace(/\/+$/, "");
+}
+function resolveInternalProviderId(name) {
+    const trimmed = name.trim();
+    if (!trimmed) {
+        throw new errors_1.CliodotApiError("provider requires a non-empty Identity App id");
+    }
+    if (trimmed.startsWith("ext:") || trimmed.startsWith("ext_")) {
+        throw new errors_1.CliodotApiError("provider() resolves internal Identity Apps only; use extProvider() for external profiles");
+    }
+    return trimmed;
+}
+function resolveExternalProviderId(name) {
+    const trimmed = name.trim();
+    if (!trimmed) {
+        throw new errors_1.CliodotApiError("extProvider requires a non-empty profile slug or id");
+    }
+    if (trimmed.startsWith("ext:") || trimmed.startsWith("ext_")) {
+        return trimmed;
+    }
+    return `ext:${trimmed}`;
+}
+class IdentityAppClient {
+    constructor(config) {
+        if (!config.baseUrl?.trim()) {
+            throw new errors_1.CliodotApiError("IdentityAppClient requires baseUrl");
+        }
+        if (!config.appId?.trim()) {
+            throw new errors_1.CliodotApiError("IdentityAppClient requires appId");
+        }
+        this.baseUrl = trimBaseUrl(config.baseUrl);
+        this.appId = config.appId.trim();
+        this.apiKey =
+            config.apiKey?.trim() || config.appApiKey?.trim() || undefined;
+        this.appSecret = config.appSecret?.trim() || undefined;
+        this.environment = config.environment;
+        this.debug = config.debug ?? false;
+        this.axios = axios_1.default.create({
+            baseURL: `${this.baseUrl}/identity`,
+            timeout: config.timeoutMs ?? 30000,
+            headers: { "Content-Type": "application/json" },
+        });
+    }
+    me() {
+        return this.request("GET", "/v1/me");
+    }
+    authenticate(input) {
+        if (!input?.target_app_id?.trim()) {
+            throw new errors_1.CliodotApiError("authenticate requires target_app_id");
+        }
+        const body = {
+            target_app_id: input.target_app_id.trim(),
+        };
+        if (input.scopes !== undefined) {
+            body.scopes = input.scopes;
+        }
+        return this.request("POST", "/v1/authenticate", body);
+    }
+    verify(input) {
+        if (!input?.access_token?.trim()) {
+            throw new errors_1.CliodotApiError("verify requires access_token");
+        }
+        const body = {
+            access_token: input.access_token.trim(),
+        };
+        if (input.required_scopes !== undefined) {
+            body.required_scopes = input.required_scopes;
+        }
+        const target = input.target_app_id?.trim();
+        if (target) {
+            return this.request("POST", `/v1/apps/${encodeURIComponent(target)}/verify`, body);
+        }
+        return this.request("POST", "/v1/verify", body);
+    }
+    refresh(input) {
+        if (!input?.refresh_token?.trim()) {
+            throw new errors_1.CliodotApiError("refresh requires refresh_token");
+        }
+        return this.request("POST", "/v1/token/refresh", {
+            refresh_token: input.refresh_token.trim(),
+        });
+    }
+    revoke(input) {
+        const access = input?.access_token?.trim();
+        const refresh = input?.refresh_token?.trim();
+        if (!access && !refresh) {
+            throw new errors_1.CliodotApiError("revoke requires access_token or refresh_token");
+        }
+        const body = {};
+        if (access)
+            body.access_token = access;
+        if (refresh)
+            body.refresh_token = refresh;
+        return this.request("POST", "/v1/token/revoke", body);
+    }
+    async getJwks(appId) {
+        if (!appId?.trim()) {
+            throw new errors_1.CliodotApiError("getJwks requires appId");
+        }
+        try {
+            const { data } = await this.axios({
+                method: "GET",
+                url: `/v1/apps/${encodeURIComponent(appId.trim())}/jwks.json`,
+            });
+            if (data?.ok === false) {
+                throw new errors_1.CliodotApiError((0, parse_api_error_1.parseApiErrorMessage)(data) || "JWKS request failed", {
+                    data,
+                    code: (0, parse_api_error_1.parseApiErrorCode)(data),
+                });
+            }
+            return data;
+        }
+        catch (err) {
+            if (err instanceof errors_1.CliodotApiError)
+                throw err;
+            throw (0, errors_1.cliodotApiErrorFromAxios)(err, `Request failed: GET jwks`);
+        }
+    }
+    provider(name) {
+        const target_app_id = resolveInternalProviderId(name);
+        return this.buildProviderHandle(target_app_id);
+    }
+    extProvider(name) {
+        const target_app_id = resolveExternalProviderId(name);
+        return this.buildProviderHandle(target_app_id);
+    }
+    buildProviderHandle(target_app_id) {
+        return {
+            target_app_id,
+            authenticate: (scopes) => {
+                const input = { target_app_id };
+                if (scopes !== undefined)
+                    input.scopes = scopes;
+                return this.authenticate(input);
+            },
+            verify: (accessToken, required_scopes) => {
+                const input = {
+                    access_token: accessToken,
+                    target_app_id,
+                };
+                if (required_scopes !== undefined) {
+                    input.required_scopes = required_scopes;
+                }
+                return this.verify(input);
+            },
+            refresh: (refreshToken) => this.refresh({ refresh_token: refreshToken }),
+        };
+    }
+    buildAuthHeaders() {
+        const headers = (0, cliodot_request_1.applyEnvironmentHeader)({
+            "x-cliodot-app-id": this.appId,
+        }, this.environment);
+        if (this.apiKey) {
+            headers.Authorization = `Bearer ${this.apiKey}`;
+            return headers;
+        }
+        if (this.appSecret) {
+            headers["x-cliodot-app-secret"] = this.appSecret;
+            return headers;
+        }
+        throw new errors_1.CliodotApiError("Identity app credentials required (apiKey/appApiKey or appSecret)");
+    }
+    async request(method, path, body) {
+        try {
+            const { data } = await this.axios({
+                method,
+                url: path,
+                headers: this.buildAuthHeaders(),
+                data: body,
+            });
+            if (data?.ok === false) {
+                throw new errors_1.CliodotApiError((0, parse_api_error_1.parseApiErrorMessage)(data) || "Identity request failed", {
+                    data,
+                    code: (0, parse_api_error_1.parseApiErrorCode)(data),
+                });
+            }
+            return data;
+        }
+        catch (err) {
+            if (err instanceof errors_1.CliodotApiError)
+                throw err;
+            throw (0, errors_1.cliodotApiErrorFromAxios)(err, `Request failed: ${method} ${path}`);
+        }
+    }
+}
+exports.IdentityAppClient = IdentityAppClient;

package/dist/MemoryAppClient.d.ts

@@ -0,0 +1,28 @@
+import type { MemoryAddressInput, MemoryAppClientApi, MemoryAppClientConfig, MemoryDeleteInput, MemoryFindInput, MemoryFindResponse, MemoryObject, MemorySearchInput, MemorySearchResponse, MemoryStoreInput, MemoryStoreManyInput, MemoryStoreManyResponse, MemoryStoreResponse, MemoryUpdateInput } from "./types/memory-app.api";
+export declare class MemoryAppClient implements MemoryAppClientApi {
+    private readonly baseUrl;
+    private readonly appId;
+    private readonly apiKey?;
+    private readonly appSecret?;
+    private readonly environment?;
+    private readonly axios;
+    readonly debug: boolean;
+    constructor(config: MemoryAppClientConfig);
+    store(input: MemoryStoreInput): Promise<MemoryStoreResponse>;
+    storeMany(input: MemoryStoreManyInput): Promise<MemoryStoreManyResponse>;
+    get(input: MemoryAddressInput): Promise<{
+        ok: true;
+        object: MemoryObject;
+    }>;
+    update(input: MemoryUpdateInput): Promise<MemoryStoreResponse>;
+    delete(input: MemoryDeleteInput): Promise<{
+        ok: true;
+        deleted: boolean;
+        mode: "soft" | "permanent";
+    }>;
+    find(input: MemoryFindInput): Promise<MemoryFindResponse>;
+    search(input: MemorySearchInput): Promise<MemorySearchResponse>;
+    private buildAuthHeaders;
+    private request;
+}
+//# sourceMappingURL=MemoryAppClient.d.ts.map

package/dist/MemoryAppClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryAppClient.d.ts","sourceRoot":"","sources":["../src/MemoryAppClient.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAMhC,qBAAa,eAAgB,YAAW,kBAAkB;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,SAAgB,KAAK,EAAE,OAAO,CAAC;gBAEnB,MAAM,EAAE,qBAAqB;IAqBzC,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAa5D,SAAS,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAaxE,GAAG,CACD,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,CAAC;IAU9C,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiB9D,MAAM,CACJ,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;KAAE,CAAC;IAWtE,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAezD,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAI/D,OAAO,CAAC,gBAAgB;YAoBV,OAAO;CAgCtB"}

package/dist/MemoryAppClient.js

@@ -0,0 +1,149 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryAppClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const errors_1 = require("./errors");
+const parse_api_error_1 = require("./http/parse-api-error");
+const cliodot_request_1 = require("./http/cliodot-request");
+function trimBaseUrl(url) {
+    return url.trim().replace(/\/+$/, "");
+}
+class MemoryAppClient {
+    constructor(config) {
+        if (!config.baseUrl?.trim()) {
+            throw new errors_1.CliodotApiError("MemoryAppClient requires baseUrl");
+        }
+        if (!config.appId?.trim()) {
+            throw new errors_1.CliodotApiError("MemoryAppClient requires appId");
+        }
+        this.baseUrl = trimBaseUrl(config.baseUrl);
+        this.appId = config.appId.trim();
+        this.apiKey =
+            config.apiKey?.trim() || config.appApiKey?.trim() || undefined;
+        this.appSecret = config.appSecret?.trim() || undefined;
+        this.environment = config.environment;
+        this.debug = config.debug ?? false;
+        this.axios = axios_1.default.create({
+            baseURL: `${this.baseUrl}/memory`,
+            timeout: 60000,
+            headers: { "Content-Type": "application/json" },
+        });
+    }
+    store(input) {
+        if (!input?.collection?.trim()) {
+            throw new errors_1.CliodotApiError("collection is required");
+        }
+        if (input.content === undefined) {
+            throw new errors_1.CliodotApiError("content is required");
+        }
+        return this.request("POST", "/v1/store", {
+            ...input,
+            collection: input.collection.trim(),
+        });
+    }
+    storeMany(input) {
+        if (!input?.collection?.trim()) {
+            throw new errors_1.CliodotApiError("collection is required");
+        }
+        if (!Array.isArray(input.items) || input.items.length === 0) {
+            throw new errors_1.CliodotApiError("items is required");
+        }
+        return this.request("POST", "/v1/store-many", {
+            collection: input.collection.trim(),
+            items: input.items,
+        });
+    }
+    get(input) {
+        if (!input?.collection?.trim() || !input?.id?.trim()) {
+            throw new errors_1.CliodotApiError("collection and id are required");
+        }
+        return this.request("POST", "/v1/get", {
+            collection: input.collection.trim(),
+            id: input.id.trim(),
+        });
+    }
+    update(input) {
+        if (!input?.collection?.trim() || !input?.id?.trim()) {
+            throw new errors_1.CliodotApiError("collection and id are required");
+        }
+        return this.request("POST", "/v1/update", {
+            collection: input.collection.trim(),
+            id: input.id.trim(),
+            content: input.content,
+            type: input.type,
+            title: input.title,
+            metadata: input.metadata,
+            tags: input.tags,
+            source: input.source,
+            async: input.async,
+        });
+    }
+    delete(input) {
+        if (!input?.collection?.trim() || !input?.id?.trim()) {
+            throw new errors_1.CliodotApiError("collection and id are required");
+        }
+        return this.request("POST", "/v1/delete", {
+            collection: input.collection.trim(),
+            id: input.id.trim(),
+            mode: input.mode || "soft",
+        });
+    }
+    find(input) {
+        if (!input?.collection?.trim()) {
+            throw new errors_1.CliodotApiError("collection is required");
+        }
+        return this.request("POST", "/v1/find", {
+            collection: input.collection.trim(),
+            filter: input.filter,
+            type: input.type,
+            tags: input.tags,
+            metadata: input.metadata,
+            limit: input.limit,
+            offset: input.offset,
+        });
+    }
+    search(input) {
+        return this.request("POST", "/v1/search", input);
+    }
+    buildAuthHeaders() {
+        const headers = (0, cliodot_request_1.applyEnvironmentHeader)({
+            "x-cliodot-app-id": this.appId,
+        }, this.environment);
+        if (this.apiKey) {
+            headers.Authorization = `Bearer ${this.apiKey}`;
+            return headers;
+        }
+        if (this.appSecret) {
+            headers["x-cliodot-app-secret"] = this.appSecret;
+            return headers;
+        }
+        throw new errors_1.CliodotApiError("MemoryAppClient credentials required (apiKey/appApiKey or appSecret)");
+    }
+    async request(method, path, body) {
+        try {
+            const { data } = await this.axios({
+                method,
+                url: path,
+                headers: this.buildAuthHeaders(),
+                data: body,
+            });
+            if (data?.ok === false) {
+                throw new errors_1.CliodotApiError((0, parse_api_error_1.parseApiErrorMessage)(data) || "Memory request failed", {
+                    data,
+                    code: (0, parse_api_error_1.parseApiErrorCode)(data),
+                });
+            }
+            return data;
+        }
+        catch (err) {
+            if (err instanceof errors_1.CliodotApiError) {
+                throw err;
+            }
+            throw (0, errors_1.cliodotApiErrorFromAxios)(err, `Request failed: ${method} ${path}`);
+        }
+    }
+}
+exports.MemoryAppClient = MemoryAppClient;

package/dist/MemoryClient.d.ts

@@ -0,0 +1,8 @@
+import { MemoryAppClient } from "./MemoryAppClient";
+import type { MemoryClientApi, MemoryClientConfig, MemoryCrossSearchInput, MemorySearchInput, MemorySearchResponse } from "./types/memory-app.api";
+export declare class MemoryClient extends MemoryAppClient implements MemoryClientApi {
+    constructor(config: MemoryClientConfig);
+    search(input: MemorySearchInput): Promise<MemorySearchResponse>;
+    searchCross(input: MemoryCrossSearchInput): Promise<MemorySearchResponse>;
+}
+//# sourceMappingURL=MemoryClient.d.ts.map

package/dist/MemoryClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryClient.d.ts","sourceRoot":"","sources":["../src/MemoryClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAGhC,qBAAa,YAAa,SAAQ,eAAgB,YAAW,eAAe;gBAC9D,MAAM,EAAE,kBAAkB;IAItC,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAI/D,WAAW,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAM1E"}

package/dist/MemoryClient.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryClient = void 0;
+const MemoryAppClient_1 = require("./MemoryAppClient");
+const errors_1 = require("./errors");
+class MemoryClient extends MemoryAppClient_1.MemoryAppClient {
+    constructor(config) {
+        super(config);
+    }
+    search(input) {
+        return super.search(input);
+    }
+    searchCross(input) {
+        if (!input?.apps?.length && !input?.group?.trim()) {
+            throw new errors_1.CliodotApiError("apps[] or group is required");
+        }
+        return this.search(input);
+    }
+}
+exports.MemoryClient = MemoryClient;

package/dist/OAuthAppClient.d.ts

@@ -4,6 +4,7 @@ export declare class OAuthAppClient {
     private readonly appId;
     private readonly appApiKey?;
     private readonly appSecret?;
+    private readonly environment?;
     private readonly axios;
     readonly debug: boolean;
     constructor(config: OAuthAppClientConfig);

package/dist/OAuthAppClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OAuthAppClient.d.ts","sourceRoot":"","sources":["../src/OAuthAppClient.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EAOf,mBAAmB,EAEnB,kBAAkB,EAClB,qBAAqB,EAKtB,MAAM,uBAAuB,CAAC;AAwF/B,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,SAAgB,KAAK,EAAE,OAAO,CAAC;gBAEnB,MAAM,EAAE,oBAAoB;IAmBxC,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,eAAe;YAaT,OAAO;IA+CrB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAqE/B;IAEI,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAUzE,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAoDvC;CACH"}
+{"version":3,"file":"OAuthAppClient.d.ts","sourceRoot":"","sources":["../src/OAuthAppClient.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EAOf,mBAAmB,EAEnB,kBAAkB,EAClB,qBAAqB,EAKtB,MAAM,uBAAuB,CAAC;AAwF/B,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,SAAgB,KAAK,EAAE,OAAO,CAAC;gBAEnB,MAAM,EAAE,oBAAoB;IAoBxC,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,eAAe;YAmBT,OAAO;IA+CrB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAqE/B;IAEI,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAUzE,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAoDvC;CACH"}