@calmlens/js-sdk 0.0.1 → 0.0.3

package/cjs/CalmLensClient.js

@@ -37,6 +37,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 var api_def_1 = require("api-def");
+var SharedConstants_1 = require("shared/SharedConstants");
 var CalmLensUtils_1 = require("./CalmLensUtils");
 var createApi = function (options) {
     var api = new api_def_1.Api({
@@ -51,40 +52,57 @@ var createApi = function (options) {
                 },
             },
         ],
+        requestBackend: options.requestBackend,
     });
     return api;
 };
-// API endpoint definitions
+// API endpoint definitions using schemas like CalmLensApi.ts
 var createEndpoints = function (api) {
-    var postUploadAsset = api
+    var getAssetsPage = api
         .endpoint()
-        .bodyOf()
+        .queryOf()
         .paramsOf()
         .responseOf()
         .build({
-        id: "postUploadAsset",
-        method: "post",
-        path: "/projects/:projectId/assets",
+        id: "getAssetsPage",
+        method: "get",
+        path: "/projects/:projectId/assets/page",
     });
-    var getAsset = api.endpoint().paramsOf().responseOf().build({
+    var getAsset = api
+        .endpoint()
+        .paramsOf()
+        .responseOf()
+        .build({
         id: "getAsset",
         method: "get",
         path: "/projects/:projectId/assets/:assetId",
     });
-    var getAssetsPage = api
+    var getAssetChildren = api
         .endpoint()
-        .queryOf()
         .paramsOf()
+        .queryOf()
         .responseOf()
         .build({
-        id: "getAssetsPage",
+        id: "getAssetChildren",
         method: "get",
-        path: "/projects/:projectId/assets/page",
+        path: "/projects/:projectId/assets/:assetId/children",
+    });
+    var postUploadAsset = api
+        .endpoint()
+        .bodyOf()
+        .paramsOf()
+        .queryOf()
+        .responseOf()
+        .build({
+        id: "postUploadAsset",
+        method: "post",
+        path: "/projects/:projectId/assets",
     });
     return {
-        postUploadAsset: postUploadAsset,
-        getAsset: getAsset,
         getAssetsPage: getAssetsPage,
+        getAsset: getAsset,
+        getAssetChildren: getAssetChildren,
+        postUploadAsset: postUploadAsset,
     };
 };
 var CalmLensClient = /** @class */ (function () {
@@ -97,7 +115,7 @@ var CalmLensClient = /** @class */ (function () {
         if (!options.projectId) {
             throw new Error("Project ID is required");
         }
-        this.options.baseUrl = (_a = this.options.baseUrl) !== null && _a !== void 0 ? _a : "https://api.calmlens.com";
+        this.options.baseUrl = (_a = this.options.baseUrl) !== null && _a !== void 0 ? _a : "https://api.".concat(SharedConstants_1.DOMAIN, "/v1");
         this.api = createApi(this.options);
         this.endpoints = createEndpoints(this.api);
     }
@@ -128,72 +146,153 @@ var CalmLensClient = /** @class */ (function () {
             });
         });
     };
-    CalmLensClient.prototype.submitAsset = function (options) {
-        return __awaiter(this, void 0, void 0, function () {
-            var result;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        if (!("file" in options) && !("url" in options)) {
-                            throw new Error("Either file content or URL is required");
+    Object.defineProperty(CalmLensClient.prototype, "assets", {
+        get: function () {
+            var _this = this;
+            return {
+                /**
+                 * List all assets for a project
+                 * @param options - Pagination and filtering options
+                 * @returns Promise with paginated assets
+                 */
+                list: function (options) { return __awaiter(_this, void 0, void 0, function () {
+                    var result;
+                    return __generator(this, function (_a) {
+                        switch (_a.label) {
+                            case 0: return [4 /*yield*/, this.endpoints.getAssetsPage.submit({
+                                    params: {
+                                        projectId: this.options.projectId,
+                                    },
+                                    query: options,
+                                })];
+                            case 1:
+                                result = _a.sent();
+                                return [2 /*return*/, result.data];
                         }
-                        if (!options.name) {
-                            throw new Error("Asset name is required");
+                    });
+                }); },
+                /**
+                 * Retrieve a specific asset by ID
+                 * @param assetId - The asset ID
+                 * @returns Promise with asset data
+                 */
+                retrieve: function (assetId) { return __awaiter(_this, void 0, void 0, function () {
+                    var result;
+                    return __generator(this, function (_a) {
+                        switch (_a.label) {
+                            case 0:
+                                if (!assetId) {
+                                    throw new Error("Asset ID is required");
+                                }
+                                return [4 /*yield*/, this.endpoints.getAsset.submit({
+                                        params: {
+                                            projectId: this.options.projectId,
+                                            assetId: assetId,
+                                        },
+                                    })];
+                            case 1:
+                                result = _a.sent();
+                                return [2 /*return*/, result.data];
                         }
-                        return [4 /*yield*/, this.endpoints.postUploadAsset.submit({
-                                body: options,
-                                params: {
-                                    projectId: this.options.projectId,
-                                },
-                            })];
-                    case 1:
-                        result = _a.sent();
-                        return [2 /*return*/, result.data];
-                }
-            });
-        });
-    };
-    CalmLensClient.prototype.getAsset = function (assetId) {
-        return __awaiter(this, void 0, void 0, function () {
-            var result;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        if (!assetId) {
-                            throw new Error("Asset ID is required");
+                    });
+                }); },
+                /**
+                 * Get child assets of a parent asset
+                 * @param assetId - The parent asset ID
+                 * @param options - Pagination options
+                 * @returns Promise with paginated child assets
+                 */
+                listChildren: function (assetId, options) { return __awaiter(_this, void 0, void 0, function () {
+                    var result;
+                    return __generator(this, function (_a) {
+                        switch (_a.label) {
+                            case 0:
+                                if (!assetId) {
+                                    throw new Error("Asset ID is required");
+                                }
+                                return [4 /*yield*/, this.endpoints.getAssetChildren.submit({
+                                        params: {
+                                            projectId: this.options.projectId,
+                                            assetId: assetId,
+                                        },
+                                        query: options,
+                                    })];
+                            case 1:
+                                result = _a.sent();
+                                return [2 /*return*/, result.data];
                         }
-                        return [4 /*yield*/, this.endpoints.getAsset.submit({
-                                params: {
-                                    projectId: this.options.projectId,
-                                    assetId: assetId,
-                                },
-                            })];
-                    case 1:
-                        result = _a.sent();
-                        return [2 /*return*/, result.data];
-                }
-            });
-        });
-    };
-    CalmLensClient.prototype.listAssets = function () {
-        return __awaiter(this, arguments, void 0, function (options) {
-            var result;
-            if (options === void 0) { options = {}; }
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, this.endpoints.getAssetsPage.submit({
-                            params: {
-                                projectId: this.options.projectId,
-                            },
-                            query: options,
-                        })];
-                    case 1:
-                        result = _a.sent();
-                        return [2 /*return*/, result.data];
-                }
-            });
-        });
-    };
+                    });
+                }); },
+                /**
+                 * Submit a new asset for processing (queued asynchronously)
+                 * The asset will be queued for classification and returned immediately.
+                 * @param options - Asset submission options
+                 * @returns Promise with created asset
+                 */
+                create: function (options) { return __awaiter(_this, void 0, void 0, function () {
+                    var result;
+                    return __generator(this, function (_a) {
+                        switch (_a.label) {
+                            case 0:
+                                if (!("file" in options) && !("url" in options)) {
+                                    throw new Error("Either file content or URL is required");
+                                }
+                                if (!options.name) {
+                                    throw new Error("Asset name is required");
+                                }
+                                return [4 /*yield*/, this.endpoints.postUploadAsset.submit({
+                                        body: options,
+                                        params: {
+                                            projectId: this.options.projectId,
+                                        },
+                                        query: {
+                                            queue: true, // Queue for async processing
+                                        },
+                                    })];
+                            case 1:
+                                result = _a.sent();
+                                return [2 /*return*/, result.data];
+                        }
+                    });
+                }); },
+                /**
+                 * Submit a new asset and analyze it synchronously
+                 * The asset will be classified immediately before the response is returned.
+                 * This may take longer but ensures the asset is fully processed.
+                 * @param options - Asset submission options
+                 * @returns Promise with created and analyzed asset
+                 */
+                analyze: function (options) { return __awaiter(_this, void 0, void 0, function () {
+                    var result;
+                    return __generator(this, function (_a) {
+                        switch (_a.label) {
+                            case 0:
+                                if (!("file" in options) && !("url" in options)) {
+                                    throw new Error("Either file content or URL is required");
+                                }
+                                if (!options.name) {
+                                    throw new Error("Asset name is required");
+                                }
+                                return [4 /*yield*/, this.endpoints.postUploadAsset.submit({
+                                        body: options,
+                                        params: {
+                                            projectId: this.options.projectId,
+                                        },
+                                        query: {
+                                            queue: false, // Process synchronously
+                                        },
+                                    })];
+                            case 1:
+                                result = _a.sent();
+                                return [2 /*return*/, result.data];
+                        }
+                    });
+                }); },
+            };
+        },
+        enumerable: false,
+        configurable: true
+    });
     return CalmLensClient;
 }());
 exports.default = CalmLensClient;

package/cjs/CalmLensTypes.d.ts

@@ -1,5 +1,7 @@
+import type { RequestBackend } from "api-def";
 export interface CalmLensClientOptions {
     apiKey: string;
     projectId: string;
     baseUrl?: string;
+    requestBackend?: RequestBackend;
 }

package/cjs/Classification.js

@@ -1,8 +1,41 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CLASSIFICATION_REPORT_SCHEMA = exports.CLASSIFICATION_LABEL_SCHEMA = exports.CATEGORIES_SCHEMA = exports.CLASSIFICATION_CATEGORY_REPORT_SCHEMA = exports.LIKELIHOOD_SCHEMA = exports.getCategoryInfo = exports.CLASSIFICATION_CATEGORY_INFO = exports.CLASSIFICATION_CATEGORY_INFO_SCHEMA = exports.CLASSIFICATION_CATEGORY_SCHEMA = exports.CLASSIFICATION_CATEGORIES = void 0;
-var zod = require("zod/v4");
-var SchemaUtils_1 = require("./SchemaUtils");
+var zod = __importStar(require("zod/v4"));
+var ZodUtils_1 = require("./ZodUtils");
 // OpenAI Content Moderation Categories (Merged subcategories)
 exports.CLASSIFICATION_CATEGORIES = [
     "sexual",
@@ -18,8 +51,8 @@ exports.CLASSIFICATION_CATEGORY_SCHEMA = zod.enum(exports.CLASSIFICATION_CATEGOR
 // Type to define category information including whether it's text-only
 exports.CLASSIFICATION_CATEGORY_INFO_SCHEMA = zod.object({
     category: exports.CLASSIFICATION_CATEGORY_SCHEMA,
-    displayName: (0, SchemaUtils_1.saneStringField)(),
-    description: (0, SchemaUtils_1.saneStringField)(),
+    displayName: (0, ZodUtils_1.saneStringField)(),
+    description: (0, ZodUtils_1.saneStringField)(),
     textOnly: zod.boolean(),
     supportsImages: zod.boolean(),
 });
@@ -101,17 +134,17 @@ exports.CLASSIFICATION_CATEGORY_REPORT_SCHEMA = zod.object({
 });
 exports.CATEGORIES_SCHEMA = zod.partialRecord(exports.CLASSIFICATION_CATEGORY_SCHEMA, exports.CLASSIFICATION_CATEGORY_REPORT_SCHEMA);
 exports.CLASSIFICATION_LABEL_SCHEMA = zod.object({
-    description: (0, SchemaUtils_1.saneStringField)(),
+    description: (0, ZodUtils_1.saneStringField)(),
     score: zod.number(),
     topicalityScore: zod.number().nullish(),
     likelihood: exports.LIKELIHOOD_SCHEMA,
-    knowledgeBaseId: (0, SchemaUtils_1.saneStringField)().nullish(),
+    knowledgeBaseId: (0, ZodUtils_1.saneStringField)().nullish(),
 });
 exports.CLASSIFICATION_REPORT_SCHEMA = zod.object({
     processedAt: zod.number(),
     categories: exports.CATEGORIES_SCHEMA,
     flagged: zod.boolean(),
     score: zod.number(),
-    notes: (0, SchemaUtils_1.saneStringField)().nullish(),
+    notes: (0, ZodUtils_1.saneStringField)().nullish(),
     labels: zod.array(exports.CLASSIFICATION_LABEL_SCHEMA).nullish(),
 });

package/cjs/DocMetaTypes.d.ts

@@ -0,0 +1,7 @@
+export declare const docPropertyInfo: import("zod-meta").ZodMetaFactory<{
+    description: string;
+    defaultValue?: string | number | boolean;
+    placeholder?: string;
+    namedType?: string;
+    example?: any;
+}>;

package/cjs/DocMetaTypes.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.docPropertyInfo = void 0;
+var zod_meta_1 = require("zod-meta");
+exports.docPropertyInfo = (0, zod_meta_1.createMetaType)({
+    id: "docPropertyInfo",
+});

package/cjs/Page.d.ts

@@ -0,0 +1,42 @@
+import * as zod from "zod/v4";
+export declare const DEFAULT_PAGE_SIZE = 10;
+export declare const ORDER_SCHEMA: zod.ZodObject<{
+    field: zod.ZodString;
+    direction: zod.ZodEnum<{
+        ASC: "ASC";
+        DESC: "DESC";
+    }>;
+}, zod.z.core.$strip>;
+export type Order = zod.infer<typeof ORDER_SCHEMA>;
+export declare const PAGE_QUERY_SCHEMA: zod.ZodObject<{
+    pageIndex: zod.ZodDefault<zod.ZodNumber>;
+    pageSize: zod.ZodOptional<zod.ZodNumber>;
+    ordering: zod.ZodOptional<zod.ZodArray<zod.ZodObject<{
+        field: zod.ZodString;
+        direction: zod.ZodEnum<{
+            ASC: "ASC";
+            DESC: "DESC";
+        }>;
+    }, zod.z.core.$strip>>>;
+}, zod.z.core.$strip>;
+export type PageQuery = zod.infer<typeof PAGE_QUERY_SCHEMA>;
+export interface Page<T> extends Required<PageQuery> {
+    items: T[];
+    total: number;
+    hasMore: boolean;
+}
+export declare const createPageSchema: <T extends zod.ZodType>(itemSchema: T) => zod.ZodIntersection<zod.ZodObject<{
+    pageIndex: zod.ZodNonOptional<zod.ZodDefault<zod.ZodNumber>>;
+    pageSize: zod.ZodNonOptional<zod.ZodOptional<zod.ZodNumber>>;
+    ordering: zod.ZodNonOptional<zod.ZodOptional<zod.ZodArray<zod.ZodObject<{
+        field: zod.ZodString;
+        direction: zod.ZodEnum<{
+            ASC: "ASC";
+            DESC: "DESC";
+        }>;
+    }, zod.z.core.$strip>>>>;
+}, zod.z.core.$strip>, zod.ZodObject<{
+    items: zod.ZodArray<T>;
+    total: zod.ZodNumber;
+    hasMore: zod.ZodBoolean;
+}, zod.z.core.$strip>>;

package/cjs/Page.js

@@ -0,0 +1,94 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPageSchema = exports.PAGE_QUERY_SCHEMA = exports.ORDER_SCHEMA = exports.DEFAULT_PAGE_SIZE = void 0;
+var zod = __importStar(require("zod/v4"));
+var zod_meta_1 = require("zod-meta");
+var DocMetaTypes_1 = require("./DocMetaTypes");
+exports.DEFAULT_PAGE_SIZE = 10;
+exports.ORDER_SCHEMA = zod.object({
+    field: zod.string().meta((0, zod_meta_1.metaStore)([
+        (0, DocMetaTypes_1.docPropertyInfo)({
+            description: "The field name to order by",
+            placeholder: "createdAt",
+        }),
+    ])),
+    direction: zod.enum(["ASC", "DESC"]).meta((0, zod_meta_1.metaStore)([
+        (0, DocMetaTypes_1.docPropertyInfo)({
+            description: "The sort direction",
+            defaultValue: "ASC",
+        }),
+    ])),
+});
+exports.PAGE_QUERY_SCHEMA = zod.object({
+    pageIndex: zod
+        .number()
+        .min(0)
+        .default(0)
+        .meta((0, zod_meta_1.metaStore)([
+        (0, DocMetaTypes_1.docPropertyInfo)({
+            description: "The zero-based page index",
+            defaultValue: "0",
+        }),
+    ])),
+    pageSize: zod
+        .number()
+        .min(1)
+        .max(100)
+        .optional()
+        .meta((0, zod_meta_1.metaStore)([
+        (0, DocMetaTypes_1.docPropertyInfo)({
+            description: "Number of items per page (1-100)",
+            placeholder: "10",
+        }),
+    ])),
+    ordering: zod
+        .array(exports.ORDER_SCHEMA)
+        .optional()
+        .meta((0, zod_meta_1.metaStore)([
+        (0, DocMetaTypes_1.docPropertyInfo)({
+            description: "Array of field ordering specifications",
+            placeholder: '[{"field": "createdAt", "direction": "DESC"}]',
+        }),
+    ])),
+});
+var createPageSchema = function (itemSchema) {
+    return exports.PAGE_QUERY_SCHEMA.required().and(zod.object({
+        items: zod.array(itemSchema),
+        total: zod.number(),
+        hasMore: zod.boolean(),
+    }));
+};
+exports.createPageSchema = createPageSchema;