@terrantula/sdk 0.10.0 → 0.11.0

package/dist/{chunk-D2JXYF4W.mjs → chunk-5JCSB6F5.mjs}

@@ -461,6 +461,32 @@ function createEntitiesClient(projEnv) {
         );
       }
     ),
+    facets: withSchema(
+      z3.object({
+        orgId: z3.string().describe("Organization slug"),
+        projectId: z3.string().describe("Project name"),
+        envName: z3.string().describe("Environment name"),
+        kind: z3.array(z3.string()).optional().describe("Filter: entity type names"),
+        state: z3.array(z3.string()).optional().describe("Filter: states"),
+        owner: z3.array(z3.string()).optional().describe("Filter: owner label values ('' = unset)"),
+        cell: z3.array(z3.string()).optional().describe("Filter: cell label values ('' = unset)"),
+        search: z3.string().optional().describe("Substring match on name + entity type"),
+        cellKey: z3.string().optional().describe("Project cell label key; omit to skip the cell dimension")
+      }),
+      (params) => {
+        const { orgId, projectId, envName, kind, state, owner, cell, search, cellKey } = params;
+        const query = {};
+        if (kind?.length) query.kind = JSON.stringify(kind);
+        if (state?.length) query.state = JSON.stringify(state);
+        if (owner?.length) query.owner = JSON.stringify(owner);
+        if (cell?.length) query.cell = JSON.stringify(cell);
+        if (search) query.search = search;
+        if (cellKey) query.cellKey = cellKey;
+        return call(
+          projEnv(orgId, projectId, envName)["entities"]["facets"].$get({ query })
+        );
+      }
+    ),
     get: withSchema(
       z3.object({
         orgId: z3.string().describe("Organization slug"),
@@ -836,7 +862,8 @@ function createRelationshipsClient(projEnv) {
         toEntity: z6.string().uuid().optional().describe("Filter by to-entity ID"),
         fromEntityCell: z6.string().optional().describe("Filter by from-entity cell membership"),
         toEntityCell: z6.string().optional().describe("Filter by to-entity cell membership"),
-        limit: z6.coerce.number().int().min(1).max(100).optional().describe("Max results (1-100)")
+        limit: z6.coerce.number().int().min(1).max(100).optional().describe("Max results (1-100)"),
+        cursor: z6.string().optional().describe("Pagination cursor")
       }),
       (params) => {
         const { orgId, projectId, envName, ...query } = params;

package/dist/index.d.mts

@@ -302,6 +302,38 @@ declare const projectApp: hono_hono_base.HonoBase<{
         };
     };
 }, "/secrets"> | hono_types.MergeSchemaPath<{
+    "/facets": {
+        $get: {
+            input: {
+                json?: any;
+                query?: {
+                    [x: string]: string | string[];
+                } | undefined;
+            };
+            output: {
+                kind: {
+                    value: string;
+                    count: number;
+                }[];
+                state: {
+                    value: string;
+                    count: number;
+                }[];
+                owner: {
+                    value: string;
+                    count: number;
+                }[];
+                cell: {
+                    value: string;
+                    count: number;
+                }[];
+                total: number;
+            };
+            outputFormat: "json";
+            status: hono_utils_http_status.ContentfulStatusCode;
+        };
+    };
+}, "/entities"> | hono_types.MergeSchemaPath<{
     "/": {
         $get: {
             input: {
@@ -8492,6 +8524,55 @@ declare const createClient: (baseUrl: string, options?: CreateClientOptions | To
             projectId: string;
             envId: string;
         }[]>;
+        facets: SchemaFn<zod.ZodObject<{
+            orgId: zod.ZodString;
+            projectId: zod.ZodString;
+            envName: zod.ZodString;
+            kind: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+            state: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+            owner: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+            cell: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+            search: zod.ZodOptional<zod.ZodString>;
+            cellKey: zod.ZodOptional<zod.ZodString>;
+        }, "strip", zod.ZodTypeAny, {
+            orgId: string;
+            projectId: string;
+            envName: string;
+            search?: string | undefined;
+            owner?: string[] | undefined;
+            cellKey?: string | undefined;
+            state?: string[] | undefined;
+            cell?: string[] | undefined;
+            kind?: string[] | undefined;
+        }, {
+            orgId: string;
+            projectId: string;
+            envName: string;
+            search?: string | undefined;
+            owner?: string[] | undefined;
+            cellKey?: string | undefined;
+            state?: string[] | undefined;
+            cell?: string[] | undefined;
+            kind?: string[] | undefined;
+        }>, {
+            kind: {
+                value: string;
+                count: number;
+            }[];
+            state: {
+                value: string;
+                count: number;
+            }[];
+            owner: {
+                value: string;
+                count: number;
+            }[];
+            cell: {
+                value: string;
+                count: number;
+            }[];
+            total: number;
+        }>;
         get: SchemaFn<zod.ZodObject<{
             orgId: zod.ZodString;
             projectId: zod.ZodString;
@@ -9524,6 +9605,7 @@ declare const createClient: (baseUrl: string, options?: CreateClientOptions | To
             fromEntityCell: zod.ZodOptional<zod.ZodString>;
             toEntityCell: zod.ZodOptional<zod.ZodString>;
             limit: zod.ZodOptional<zod.ZodNumber>;
+            cursor: zod.ZodOptional<zod.ZodString>;
         }, "strip", zod.ZodTypeAny, {
             orgId: string;
             projectId: string;
@@ -9531,6 +9613,7 @@ declare const createClient: (baseUrl: string, options?: CreateClientOptions | To
             limit?: number | undefined;
             state?: string | undefined;
             relationshipType?: string | undefined;
+            cursor?: string | undefined;
             fromEntity?: string | undefined;
             toEntity?: string | undefined;
             fromEntityCell?: string | undefined;
@@ -9542,6 +9625,7 @@ declare const createClient: (baseUrl: string, options?: CreateClientOptions | To
             limit?: number | undefined;
             state?: string | undefined;
             relationshipType?: string | undefined;
+            cursor?: string | undefined;
             fromEntity?: string | undefined;
             toEntity?: string | undefined;
             fromEntityCell?: string | undefined;

package/dist/index.d.ts

@@ -302,6 +302,38 @@ declare const projectApp: hono_hono_base.HonoBase<{
         };
     };
 }, "/secrets"> | hono_types.MergeSchemaPath<{
+    "/facets": {
+        $get: {
+            input: {
+                json?: any;
+                query?: {
+                    [x: string]: string | string[];
+                } | undefined;
+            };
+            output: {
+                kind: {
+                    value: string;
+                    count: number;
+                }[];
+                state: {
+                    value: string;
+                    count: number;
+                }[];
+                owner: {
+                    value: string;
+                    count: number;
+                }[];
+                cell: {
+                    value: string;
+                    count: number;
+                }[];
+                total: number;
+            };
+            outputFormat: "json";
+            status: hono_utils_http_status.ContentfulStatusCode;
+        };
+    };
+}, "/entities"> | hono_types.MergeSchemaPath<{
     "/": {
         $get: {
             input: {
@@ -8492,6 +8524,55 @@ declare const createClient: (baseUrl: string, options?: CreateClientOptions | To
             projectId: string;
             envId: string;
         }[]>;
+        facets: SchemaFn<zod.ZodObject<{
+            orgId: zod.ZodString;
+            projectId: zod.ZodString;
+            envName: zod.ZodString;
+            kind: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+            state: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+            owner: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+            cell: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+            search: zod.ZodOptional<zod.ZodString>;
+            cellKey: zod.ZodOptional<zod.ZodString>;
+        }, "strip", zod.ZodTypeAny, {
+            orgId: string;
+            projectId: string;
+            envName: string;
+            search?: string | undefined;
+            owner?: string[] | undefined;
+            cellKey?: string | undefined;
+            state?: string[] | undefined;
+            cell?: string[] | undefined;
+            kind?: string[] | undefined;
+        }, {
+            orgId: string;
+            projectId: string;
+            envName: string;
+            search?: string | undefined;
+            owner?: string[] | undefined;
+            cellKey?: string | undefined;
+            state?: string[] | undefined;
+            cell?: string[] | undefined;
+            kind?: string[] | undefined;
+        }>, {
+            kind: {
+                value: string;
+                count: number;
+            }[];
+            state: {
+                value: string;
+                count: number;
+            }[];
+            owner: {
+                value: string;
+                count: number;
+            }[];
+            cell: {
+                value: string;
+                count: number;
+            }[];
+            total: number;
+        }>;
         get: SchemaFn<zod.ZodObject<{
             orgId: zod.ZodString;
             projectId: zod.ZodString;
@@ -9524,6 +9605,7 @@ declare const createClient: (baseUrl: string, options?: CreateClientOptions | To
             fromEntityCell: zod.ZodOptional<zod.ZodString>;
             toEntityCell: zod.ZodOptional<zod.ZodString>;
             limit: zod.ZodOptional<zod.ZodNumber>;
+            cursor: zod.ZodOptional<zod.ZodString>;
         }, "strip", zod.ZodTypeAny, {
             orgId: string;
             projectId: string;
@@ -9531,6 +9613,7 @@ declare const createClient: (baseUrl: string, options?: CreateClientOptions | To
             limit?: number | undefined;
             state?: string | undefined;
             relationshipType?: string | undefined;
+            cursor?: string | undefined;
             fromEntity?: string | undefined;
             toEntity?: string | undefined;
             fromEntityCell?: string | undefined;
@@ -9542,6 +9625,7 @@ declare const createClient: (baseUrl: string, options?: CreateClientOptions | To
             limit?: number | undefined;
             state?: string | undefined;
             relationshipType?: string | undefined;
+            cursor?: string | undefined;
             fromEntity?: string | undefined;
             toEntity?: string | undefined;
             fromEntityCell?: string | undefined;

package/dist/index.js

@@ -484,6 +484,32 @@ function createEntitiesClient(projEnv) {
         );
       }
     ),
+    facets: withSchema(
+      import_zod3.z.object({
+        orgId: import_zod3.z.string().describe("Organization slug"),
+        projectId: import_zod3.z.string().describe("Project name"),
+        envName: import_zod3.z.string().describe("Environment name"),
+        kind: import_zod3.z.array(import_zod3.z.string()).optional().describe("Filter: entity type names"),
+        state: import_zod3.z.array(import_zod3.z.string()).optional().describe("Filter: states"),
+        owner: import_zod3.z.array(import_zod3.z.string()).optional().describe("Filter: owner label values ('' = unset)"),
+        cell: import_zod3.z.array(import_zod3.z.string()).optional().describe("Filter: cell label values ('' = unset)"),
+        search: import_zod3.z.string().optional().describe("Substring match on name + entity type"),
+        cellKey: import_zod3.z.string().optional().describe("Project cell label key; omit to skip the cell dimension")
+      }),
+      (params) => {
+        const { orgId, projectId, envName, kind, state, owner, cell, search, cellKey } = params;
+        const query = {};
+        if (kind?.length) query.kind = JSON.stringify(kind);
+        if (state?.length) query.state = JSON.stringify(state);
+        if (owner?.length) query.owner = JSON.stringify(owner);
+        if (cell?.length) query.cell = JSON.stringify(cell);
+        if (search) query.search = search;
+        if (cellKey) query.cellKey = cellKey;
+        return call(
+          projEnv(orgId, projectId, envName)["entities"]["facets"].$get({ query })
+        );
+      }
+    ),
     get: withSchema(
       import_zod3.z.object({
         orgId: import_zod3.z.string().describe("Organization slug"),
@@ -859,7 +885,8 @@ function createRelationshipsClient(projEnv) {
         toEntity: import_zod6.z.string().uuid().optional().describe("Filter by to-entity ID"),
         fromEntityCell: import_zod6.z.string().optional().describe("Filter by from-entity cell membership"),
         toEntityCell: import_zod6.z.string().optional().describe("Filter by to-entity cell membership"),
-        limit: import_zod6.z.coerce.number().int().min(1).max(100).optional().describe("Max results (1-100)")
+        limit: import_zod6.z.coerce.number().int().min(1).max(100).optional().describe("Max results (1-100)"),
+        cursor: import_zod6.z.string().optional().describe("Pagination cursor")
       }),
       (params) => {
         const { orgId, projectId, envName, ...query } = params;

package/dist/index.mjs

@@ -2,7 +2,7 @@ import {
   TerrantulaError,
   createClient,
   withSchema
-} from "./chunk-D2JXYF4W.mjs";
+} from "./chunk-5JCSB6F5.mjs";
 export {
   TerrantulaError,
   createClient,

package/dist/local.d.mts

@@ -1744,6 +1744,55 @@ declare const createLocalClient: (options?: CreateLocalClientOptions) => {
             projectId: string;
             envId: string;
         }[]>;
+        facets: SchemaFn<zod.ZodObject<{
+            orgId: zod.ZodString;
+            projectId: zod.ZodString;
+            envName: zod.ZodString;
+            kind: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+            state: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+            owner: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+            cell: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+            search: zod.ZodOptional<zod.ZodString>;
+            cellKey: zod.ZodOptional<zod.ZodString>;
+        }, "strip", zod.ZodTypeAny, {
+            orgId: string;
+            projectId: string;
+            envName: string;
+            search?: string | undefined;
+            owner?: string[] | undefined;
+            cellKey?: string | undefined;
+            state?: string[] | undefined;
+            cell?: string[] | undefined;
+            kind?: string[] | undefined;
+        }, {
+            orgId: string;
+            projectId: string;
+            envName: string;
+            search?: string | undefined;
+            owner?: string[] | undefined;
+            cellKey?: string | undefined;
+            state?: string[] | undefined;
+            cell?: string[] | undefined;
+            kind?: string[] | undefined;
+        }>, {
+            kind: {
+                value: string;
+                count: number;
+            }[];
+            state: {
+                value: string;
+                count: number;
+            }[];
+            owner: {
+                value: string;
+                count: number;
+            }[];
+            cell: {
+                value: string;
+                count: number;
+            }[];
+            total: number;
+        }>;
         get: SchemaFn<zod.ZodObject<{
             orgId: zod.ZodString;
             projectId: zod.ZodString;
@@ -2776,6 +2825,7 @@ declare const createLocalClient: (options?: CreateLocalClientOptions) => {
             fromEntityCell: zod.ZodOptional<zod.ZodString>;
             toEntityCell: zod.ZodOptional<zod.ZodString>;
             limit: zod.ZodOptional<zod.ZodNumber>;
+            cursor: zod.ZodOptional<zod.ZodString>;
         }, "strip", zod.ZodTypeAny, {
             orgId: string;
             projectId: string;
@@ -2783,6 +2833,7 @@ declare const createLocalClient: (options?: CreateLocalClientOptions) => {
             limit?: number | undefined;
             state?: string | undefined;
             relationshipType?: string | undefined;
+            cursor?: string | undefined;
             fromEntity?: string | undefined;
             toEntity?: string | undefined;
             fromEntityCell?: string | undefined;
@@ -2794,6 +2845,7 @@ declare const createLocalClient: (options?: CreateLocalClientOptions) => {
             limit?: number | undefined;
             state?: string | undefined;
             relationshipType?: string | undefined;
+            cursor?: string | undefined;
             fromEntity?: string | undefined;
             toEntity?: string | undefined;
             fromEntityCell?: string | undefined;

package/dist/local.d.ts

@@ -1744,6 +1744,55 @@ declare const createLocalClient: (options?: CreateLocalClientOptions) => {
             projectId: string;
             envId: string;
         }[]>;
+        facets: SchemaFn<zod.ZodObject<{
+            orgId: zod.ZodString;
+            projectId: zod.ZodString;
+            envName: zod.ZodString;
+            kind: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+            state: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+            owner: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+            cell: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+            search: zod.ZodOptional<zod.ZodString>;
+            cellKey: zod.ZodOptional<zod.ZodString>;
+        }, "strip", zod.ZodTypeAny, {
+            orgId: string;
+            projectId: string;
+            envName: string;
+            search?: string | undefined;
+            owner?: string[] | undefined;
+            cellKey?: string | undefined;
+            state?: string[] | undefined;
+            cell?: string[] | undefined;
+            kind?: string[] | undefined;
+        }, {
+            orgId: string;
+            projectId: string;
+            envName: string;
+            search?: string | undefined;
+            owner?: string[] | undefined;
+            cellKey?: string | undefined;
+            state?: string[] | undefined;
+            cell?: string[] | undefined;
+            kind?: string[] | undefined;
+        }>, {
+            kind: {
+                value: string;
+                count: number;
+            }[];
+            state: {
+                value: string;
+                count: number;
+            }[];
+            owner: {
+                value: string;
+                count: number;
+            }[];
+            cell: {
+                value: string;
+                count: number;
+            }[];
+            total: number;
+        }>;
         get: SchemaFn<zod.ZodObject<{
             orgId: zod.ZodString;
             projectId: zod.ZodString;
@@ -2776,6 +2825,7 @@ declare const createLocalClient: (options?: CreateLocalClientOptions) => {
             fromEntityCell: zod.ZodOptional<zod.ZodString>;
             toEntityCell: zod.ZodOptional<zod.ZodString>;
             limit: zod.ZodOptional<zod.ZodNumber>;
+            cursor: zod.ZodOptional<zod.ZodString>;
         }, "strip", zod.ZodTypeAny, {
             orgId: string;
             projectId: string;
@@ -2783,6 +2833,7 @@ declare const createLocalClient: (options?: CreateLocalClientOptions) => {
             limit?: number | undefined;
             state?: string | undefined;
             relationshipType?: string | undefined;
+            cursor?: string | undefined;
             fromEntity?: string | undefined;
             toEntity?: string | undefined;
             fromEntityCell?: string | undefined;
@@ -2794,6 +2845,7 @@ declare const createLocalClient: (options?: CreateLocalClientOptions) => {
             limit?: number | undefined;
             state?: string | undefined;
             relationshipType?: string | undefined;
+            cursor?: string | undefined;
             fromEntity?: string | undefined;
             toEntity?: string | undefined;
             fromEntityCell?: string | undefined;

package/dist/local.js

@@ -484,6 +484,32 @@ function createEntitiesClient(projEnv) {
         );
       }
     ),
+    facets: withSchema(
+      import_zod3.z.object({
+        orgId: import_zod3.z.string().describe("Organization slug"),
+        projectId: import_zod3.z.string().describe("Project name"),
+        envName: import_zod3.z.string().describe("Environment name"),
+        kind: import_zod3.z.array(import_zod3.z.string()).optional().describe("Filter: entity type names"),
+        state: import_zod3.z.array(import_zod3.z.string()).optional().describe("Filter: states"),
+        owner: import_zod3.z.array(import_zod3.z.string()).optional().describe("Filter: owner label values ('' = unset)"),
+        cell: import_zod3.z.array(import_zod3.z.string()).optional().describe("Filter: cell label values ('' = unset)"),
+        search: import_zod3.z.string().optional().describe("Substring match on name + entity type"),
+        cellKey: import_zod3.z.string().optional().describe("Project cell label key; omit to skip the cell dimension")
+      }),
+      (params) => {
+        const { orgId, projectId, envName, kind, state, owner, cell, search, cellKey } = params;
+        const query = {};
+        if (kind?.length) query.kind = JSON.stringify(kind);
+        if (state?.length) query.state = JSON.stringify(state);
+        if (owner?.length) query.owner = JSON.stringify(owner);
+        if (cell?.length) query.cell = JSON.stringify(cell);
+        if (search) query.search = search;
+        if (cellKey) query.cellKey = cellKey;
+        return call(
+          projEnv(orgId, projectId, envName)["entities"]["facets"].$get({ query })
+        );
+      }
+    ),
     get: withSchema(
       import_zod3.z.object({
         orgId: import_zod3.z.string().describe("Organization slug"),
@@ -859,7 +885,8 @@ function createRelationshipsClient(projEnv) {
         toEntity: import_zod6.z.string().uuid().optional().describe("Filter by to-entity ID"),
         fromEntityCell: import_zod6.z.string().optional().describe("Filter by from-entity cell membership"),
         toEntityCell: import_zod6.z.string().optional().describe("Filter by to-entity cell membership"),
-        limit: import_zod6.z.coerce.number().int().min(1).max(100).optional().describe("Max results (1-100)")
+        limit: import_zod6.z.coerce.number().int().min(1).max(100).optional().describe("Max results (1-100)"),
+        cursor: import_zod6.z.string().optional().describe("Pagination cursor")
       }),
       (params) => {
         const { orgId, projectId, envName, ...query } = params;

package/dist/local.mjs

@@ -1,6 +1,6 @@
 import {
   createClient
-} from "./chunk-D2JXYF4W.mjs";
+} from "./chunk-5JCSB6F5.mjs";
 
 // src/local.ts
 import { createLocalApp, openLocalDb } from "@terrantula/local";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@terrantula/sdk",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "TypeScript SDK for Terrantula — the multi-tenant entity-graph control plane that herds Terraform/OpenTofu cattle.",
   "keywords": [
     "terrantula",
@@ -60,8 +60,8 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@terrantula/local": "^0.3.0",
-    "@terrantula/types": "^0.3.0",
+    "@terrantula/local": "^0.4.0",
+    "@terrantula/types": "^0.4.0",
     "hono": "^4.4.0",
     "zod": "^3.22.0"
   },