@agentuity/core 1.0.31 → 1.0.33

package/dist/api/project/list.js

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+import { APIResponseSchema } from "../api.js";
+import { ProjectResponseError } from "./util.js";
+export const ProjectListItemSchema = z.object({
+    id: z.string().describe('the project id'),
+    name: z.string().describe('the project name'),
+    description: z.string().nullable().optional().describe('the project description'),
+    orgId: z.string().describe('the organization id that this project is registered with'),
+    orgName: z.string().describe('the organization name'),
+    cloudRegion: z.string().nullable().optional().describe('the cloud region'),
+    latestDeploymentId: z.string().nullable().describe('the latest deployment id'),
+});
+export const ProjectListSchema = z.array(ProjectListItemSchema);
+export const ProjectListResponseSchema = APIResponseSchema(ProjectListSchema);
+/**
+ * List all projects
+ *
+ * @param client
+ * @param hasDeployment if true, filter by projects with at least one deployment
+ * @param limit maximum number of projects to return (default: 1000, max: 10000)
+ * @returns
+ */
+export async function projectList(client, hasDeployment, limit) {
+    const params = new URLSearchParams();
+    if (hasDeployment) {
+        params.append('hasDeployment', 'true');
+    }
+    if (limit !== undefined) {
+        params.append('limit', limit.toString());
+    }
+    const queryString = params.toString();
+    const resp = await client.request('GET', `/cli/project${queryString ? `?${queryString}` : ''}`, ProjectListResponseSchema);
+    if (resp.success) {
+        return resp.data;
+    }
+    throw new ProjectResponseError({ message: resp.message });
+}
+//# sourceMappingURL=list.js.map

package/dist/api/project/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/api/project/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEjD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAC7C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IACjF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;IACtF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACrD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAC1E,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CAC9E,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;AAEhE,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;AAK9E;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAChC,MAAiB,EACjB,aAAuB,EACvB,KAAc;IAEd,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,IAAI,aAAa,EAAE,CAAC;QACnB,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAChC,KAAK,EACL,eAAe,WAAW,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EACrD,yBAAyB,CACzB,CAAC;IAEF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,oBAAoB,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;AAC3D,CAAC"}

package/dist/api/project/malware.d.ts

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+import { type APIClient } from '../api.ts';
+export declare const PackageRefSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+}, z.core.$strip>;
+export type PackageRef = z.infer<typeof PackageRefSchema>;
+export declare const MalwareFindingSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export type MalwareFinding = z.infer<typeof MalwareFindingSchema>;
+export declare const MalwareCheckSummarySchema: z.ZodObject<{
+    scanned: z.ZodNumber;
+    flagged: z.ZodNumber;
+}, z.core.$strip>;
+export declare const MalwareCheckListMetadataSchema: z.ZodObject<{
+    fetchedAt: z.ZodString;
+    count: z.ZodNumber;
+}, z.core.$strip>;
+export declare const MalwareCheckResultSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        allow: "allow";
+        block: "block";
+    }>;
+    summary: z.ZodObject<{
+        scanned: z.ZodNumber;
+        flagged: z.ZodNumber;
+    }, z.core.$strip>;
+    findings: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strip>>;
+    list: z.ZodOptional<z.ZodObject<{
+        fetchedAt: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const MalwareCheckResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        action: z.ZodEnum<{
+            allow: "allow";
+            block: "block";
+        }>;
+        summary: z.ZodObject<{
+            scanned: z.ZodNumber;
+            flagged: z.ZodNumber;
+        }, z.core.$strip>;
+        findings: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            version: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$strip>>;
+        list: z.ZodOptional<z.ZodObject<{
+            fetchedAt: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$strip>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export type MalwareCheckResult = z.infer<typeof MalwareCheckResultSchema>;
+export declare function projectDeploymentMalwareCheck(client: APIClient, deploymentId: string, packages: PackageRef[], signal?: AbortSignal): Promise<MalwareCheckResult>;
+//# sourceMappingURL=malware.d.ts.map

package/dist/api/project/malware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"malware.d.ts","sourceRoot":"","sources":["../../../src/api/project/malware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,WAAW,CAAC;AAG9D,eAAO,MAAM,gBAAgB;;;iBAG3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,oBAAoB;;;;iBAI/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,yBAAyB;;;iBAGpC,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;iBAGzC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;iBAMnC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;8BAA8C,CAAC;AAEtF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,wBAAsB,6BAA6B,CAClD,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,UAAU,EAAE,EACtB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAqB7B"}

package/dist/api/project/malware.js

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import { APIResponseSchema } from "../api.js";
+import { MalwareCheckError } from "./util.js";
+export const PackageRefSchema = z.object({
+    name: z.string(),
+    version: z.string(),
+});
+export const MalwareFindingSchema = z.object({
+    name: z.string(),
+    version: z.string(),
+    reason: z.string(),
+});
+export const MalwareCheckSummarySchema = z.object({
+    scanned: z.number(),
+    flagged: z.number(),
+});
+export const MalwareCheckListMetadataSchema = z.object({
+    fetchedAt: z.string(),
+    count: z.number(),
+});
+export const MalwareCheckResultSchema = z.object({
+    action: z.enum(['allow', 'block']),
+    summary: MalwareCheckSummarySchema,
+    findings: z.array(MalwareFindingSchema),
+    list: MalwareCheckListMetadataSchema.optional(),
+    error: z.string().optional(),
+});
+export const MalwareCheckResponseSchema = APIResponseSchema(MalwareCheckResultSchema);
+export async function projectDeploymentMalwareCheck(client, deploymentId, packages, signal) {
+    const resp = await client.request('POST', `/security/${encodeURIComponent(deploymentId)}/malware-check`, MalwareCheckResponseSchema, {
+        ecosystem: 'npm',
+        packages,
+    }, undefined, signal);
+    if (!resp.success) {
+        throw new MalwareCheckError({
+            message: resp.message || 'Malware check request failed',
+            deploymentId,
+        });
+    }
+    return resp.data;
+}
+//# sourceMappingURL=malware.js.map

package/dist/api/project/malware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"malware.js","sourceRoot":"","sources":["../../../src/api/project/malware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,EAAE,yBAAyB;IAClC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC;IACvC,IAAI,EAAE,8BAA8B,CAAC,QAAQ,EAAE;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,iBAAiB,CAAC,wBAAwB,CAAC,CAAC;AAItF,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAClD,MAAiB,EACjB,YAAoB,EACpB,QAAsB,EACtB,MAAoB;IAEpB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAChC,MAAM,EACN,aAAa,kBAAkB,CAAC,YAAY,CAAC,gBAAgB,EAC7D,0BAA0B,EAC1B;QACC,SAAS,EAAE,KAAK;QAChB,QAAQ;KACR,EACD,SAAS,EACT,MAAM,CACN,CAAC;IAEF,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,iBAAiB,CAAC;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,8BAA8B;YACvD,YAAY;SACZ,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC;AAClB,CAAC"}

package/dist/api/project/update-region.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { type APIClient } from '../api.ts';
+export declare const UpdateRegionRequestSchema: z.ZodObject<{
+    cloudRegion: z.ZodString;
+}, z.core.$strip>;
+export declare const UpdateRegionResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        id: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+/**
+ * Update a project's cloud region
+ *
+ * @param client - The API client
+ * @param projectId - The project id to update
+ * @param region - The new cloud region
+ * @returns The project id on success
+ */
+export declare function projectUpdateRegion(client: APIClient, projectId: string, region: string): Promise<{
+    id: string;
+}>;
+//# sourceMappingURL=update-region.d.ts.map

package/dist/api/project/update-region.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-region.d.ts","sourceRoot":"","sources":["../../../src/api/project/update-region.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,WAAW,CAAC;AAG9D,eAAO,MAAM,yBAAyB;;iBAEpC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;8BAItC,CAAC;AAKF;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAczB"}

package/dist/api/project/update-region.js

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { APIResponseSchema } from "../api.js";
+import { ProjectResponseError } from "./util.js";
+export const UpdateRegionRequestSchema = z.object({
+    cloudRegion: z.string().describe('the cloud region to update the project to'),
+});
+export const UpdateRegionResponseSchema = APIResponseSchema(z.object({
+    id: z.string().describe('the project id'),
+}));
+/**
+ * Update a project's cloud region
+ *
+ * @param client - The API client
+ * @param projectId - The project id to update
+ * @param region - The new cloud region
+ * @returns The project id on success
+ */
+export async function projectUpdateRegion(client, projectId, region) {
+    const resp = await client.request('PATCH', `/cli/project/${projectId}`, UpdateRegionResponseSchema, { cloudRegion: region }, UpdateRegionRequestSchema);
+    if (resp.success) {
+        return resp.data;
+    }
+    throw new ProjectResponseError({ message: resp.message ?? 'failed to update project region' });
+}
+//# sourceMappingURL=update-region.js.map

package/dist/api/project/update-region.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-region.js","sourceRoot":"","sources":["../../../src/api/project/update-region.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEjD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;CAC7E,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,iBAAiB,CAC1D,CAAC,CAAC,MAAM,CAAC;IACR,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;CACzC,CAAC,CACF,CAAC;AAKF;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,MAAiB,EACjB,SAAiB,EACjB,MAAc;IAEd,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAChC,OAAO,EACP,gBAAgB,SAAS,EAAE,EAC3B,0BAA0B,EAC1B,EAAE,WAAW,EAAE,MAAM,EAAE,EACvB,yBAAyB,CACzB,CAAC;IAEF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,oBAAoB,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,iCAAiC,EAAE,CAAC,CAAC;AAChG,CAAC"}

package/dist/api/project/util.d.ts

@@ -0,0 +1,62 @@
+export declare const ProjectResponseError: {
+    new (args?: {
+        message?: string;
+        cause?: unknown;
+    } | undefined): import("../../error.ts").RichError & {
+        readonly _tag: "ProjectResponseError";
+    } & Readonly<Record<string, never>>;
+    readonly defaultMessage?: string;
+} & (<Shape extends {
+    [x: string]: any;
+} = Record<string, never>>() => {
+    new (args?: (Shape extends Record<string, never> ? {
+        message?: string;
+        cause?: unknown;
+    } : Shape & {
+        message?: string;
+        cause?: unknown;
+    }) | undefined): import("../../error.ts").RichError & {
+        readonly _tag: "ProjectResponseError";
+    } & Readonly<Shape>;
+    readonly defaultMessage?: string;
+});
+export declare const ProjectNotFoundError: {
+    new (args?: ({
+        id: string;
+    } & {
+        message?: string;
+        cause?: unknown;
+    }) | undefined): import("../../error.ts").RichError & {
+        readonly _tag: "ProjectNotFoundError";
+    } & Readonly<{
+        id: string;
+    }>;
+    readonly defaultMessage?: string;
+};
+export declare const AgentNotFoundError: {
+    new (args?: ({
+        id: string;
+    } & {
+        message?: string;
+        cause?: unknown;
+    }) | undefined): import("../../error.ts").RichError & {
+        readonly _tag: "AgentNotFoundError";
+    } & Readonly<{
+        id: string;
+    }>;
+    readonly defaultMessage?: string;
+};
+export declare const MalwareCheckError: {
+    new (args?: ({
+        deploymentId: string;
+    } & {
+        message?: string;
+        cause?: unknown;
+    }) | undefined): import("../../error.ts").RichError & {
+        readonly _tag: "MalwareCheckError";
+    } & Readonly<{
+        deploymentId: string;
+    }>;
+    readonly defaultMessage?: string;
+};
+//# sourceMappingURL=util.d.ts.map

package/dist/api/project/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/api/project/util.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;EAA0C,CAAC;AAC5E,eAAO,MAAM,oBAAoB;;YAAiD,MAAM;;;;;;;YAAN,MAAM;;;CAAK,CAAC;AAC9F,eAAO,MAAM,kBAAkB;;YAA+C,MAAM;;;;;;;YAAN,MAAM;;;CAAK,CAAC;AAC1F,eAAO,MAAM,iBAAiB;;sBACf,MAAM;;;;;;;sBAAN,MAAM;;;CACjB,CAAC"}

package/dist/api/project/util.js

@@ -0,0 +1,6 @@
+import { StructuredError } from "../../error.js";
+export const ProjectResponseError = StructuredError('ProjectResponseError');
+export const ProjectNotFoundError = StructuredError('ProjectNotFoundError')();
+export const AgentNotFoundError = StructuredError('AgentNotFoundError')();
+export const MalwareCheckError = StructuredError('MalwareCheckError')();
+//# sourceMappingURL=util.js.map

package/dist/api/project/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../../src/api/project/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC,sBAAsB,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC,sBAAsB,CAAC,EAAkB,CAAC;AAC9F,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC,oBAAoB,CAAC,EAAkB,CAAC;AAC1F,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC,mBAAmB,CAAC,EAEjE,CAAC"}

package/dist/api/queue/analytics.d.ts

@@ -0,0 +1,250 @@
+import { z } from 'zod';
+import { type APIClient } from '../api.ts';
+import { type AnalyticsOptions, type OrgAnalytics, type QueueAnalytics, type SSEStatsEvent, type StreamAnalyticsOptions, type TimeSeriesData } from './types.ts';
+export declare const OrgAnalyticsResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        analytics: z.ZodObject<{
+            org_id: z.ZodString;
+            period: z.ZodObject<{
+                start: z.ZodString;
+                end: z.ZodString;
+                granularity: z.ZodOptional<z.ZodEnum<{
+                    minute: "minute";
+                    hour: "hour";
+                    day: "day";
+                }>>;
+            }, z.core.$strip>;
+            summary: z.ZodObject<{
+                total_queues: z.ZodNumber;
+                total_messages_published: z.ZodNumber;
+                total_messages_delivered: z.ZodNumber;
+                total_messages_acknowledged: z.ZodNumber;
+                total_dlq_messages: z.ZodNumber;
+                total_bytes_published: z.ZodNumber;
+                avg_latency_ms: z.ZodNumber;
+                p95_latency_ms: z.ZodNumber;
+                error_rate_percent: z.ZodNumber;
+            }, z.core.$strip>;
+            queues: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                queue_type: z.ZodString;
+                messages_published: z.ZodNumber;
+                messages_delivered: z.ZodNumber;
+                messages_acknowledged: z.ZodNumber;
+                backlog: z.ZodNumber;
+                dlq_count: z.ZodNumber;
+                avg_latency_ms: z.ZodNumber;
+                error_rate_percent: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export declare const QueueAnalyticsResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        analytics: z.ZodObject<{
+            queue_id: z.ZodString;
+            queue_name: z.ZodString;
+            queue_type: z.ZodString;
+            period: z.ZodObject<{
+                start: z.ZodString;
+                end: z.ZodString;
+                granularity: z.ZodOptional<z.ZodEnum<{
+                    minute: "minute";
+                    hour: "hour";
+                    day: "day";
+                }>>;
+            }, z.core.$strip>;
+            current: z.ZodObject<{
+                backlog: z.ZodNumber;
+                dlq_count: z.ZodNumber;
+                messages_in_flight: z.ZodNumber;
+                active_consumers: z.ZodNumber;
+                oldest_message_age_seconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            }, z.core.$strip>;
+            period_stats: z.ZodObject<{
+                messages_published: z.ZodNumber;
+                messages_delivered: z.ZodNumber;
+                messages_acknowledged: z.ZodNumber;
+                messages_failed: z.ZodNumber;
+                messages_replayed: z.ZodNumber;
+                bytes_published: z.ZodNumber;
+                delivery_attempts: z.ZodNumber;
+                retry_count: z.ZodNumber;
+            }, z.core.$strip>;
+            latency: z.ZodObject<{
+                avg_ms: z.ZodNumber;
+                p50_ms: z.ZodOptional<z.ZodNumber>;
+                p95_ms: z.ZodOptional<z.ZodNumber>;
+                p99_ms: z.ZodOptional<z.ZodNumber>;
+                max_ms: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>;
+            consumer_latency: z.ZodObject<{
+                avg_ms: z.ZodNumber;
+                p50_ms: z.ZodOptional<z.ZodNumber>;
+                p95_ms: z.ZodOptional<z.ZodNumber>;
+                p99_ms: z.ZodOptional<z.ZodNumber>;
+                max_ms: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>;
+            destinations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                type: z.ZodString;
+                url: z.ZodString;
+                success_count: z.ZodNumber;
+                failure_count: z.ZodNumber;
+                avg_response_time_ms: z.ZodOptional<z.ZodNumber>;
+                last_success_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                last_failure_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export declare const TimeSeriesResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        timeseries: z.ZodObject<{
+            queue_id: z.ZodString;
+            queue_name: z.ZodString;
+            period: z.ZodObject<{
+                start: z.ZodString;
+                end: z.ZodString;
+                granularity: z.ZodOptional<z.ZodEnum<{
+                    minute: "minute";
+                    hour: "hour";
+                    day: "day";
+                }>>;
+            }, z.core.$strip>;
+            series: z.ZodArray<z.ZodObject<{
+                timestamp: z.ZodString;
+                throughput: z.ZodNumber;
+                delivery_rate: z.ZodNumber;
+                ack_rate: z.ZodNumber;
+                error_rate: z.ZodNumber;
+                avg_latency_ms: z.ZodNumber;
+                p95_latency_ms: z.ZodOptional<z.ZodNumber>;
+                backlog: z.ZodOptional<z.ZodNumber>;
+                messages_in_flight: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+/**
+ * Get org-level analytics for all queues.
+ *
+ * Returns aggregated statistics across all queues in the organization.
+ *
+ * @param client - The API client instance
+ * @param options - Analytics options (time range, filters)
+ * @returns Org-level analytics summary
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const analytics = await getOrgAnalytics(client, {
+ *   start: '2026-01-14T00:00:00Z',
+ *   end: '2026-01-15T00:00:00Z',
+ * });
+ * console.log(`Total queues: ${analytics.summary.total_queues}`);
+ * console.log(`Messages published: ${analytics.summary.total_messages_published}`);
+ * ```
+ */
+export declare function getOrgAnalytics(client: APIClient, options?: AnalyticsOptions): Promise<OrgAnalytics>;
+/**
+ * Get detailed analytics for a specific queue.
+ *
+ * Returns current state, period statistics, latency metrics, and destination stats.
+ *
+ * @param client - The API client instance
+ * @param name - The queue name
+ * @param options - Analytics options (time range, filters)
+ * @returns Queue analytics
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const analytics = await getQueueAnalytics(client, 'order-processing', {
+ *   start: '2026-01-14T00:00:00Z',
+ * });
+ * console.log(`Backlog: ${analytics.current.backlog}`);
+ * console.log(`P95 latency: ${analytics.latency.p95_ms}ms`);
+ * ```
+ */
+export declare function getQueueAnalytics(client: APIClient, name: string, options?: AnalyticsOptions): Promise<QueueAnalytics>;
+/**
+ * Get time series analytics data for a queue.
+ *
+ * Returns time-bucketed metrics for visualization in charts and graphs.
+ *
+ * @param client - The API client instance
+ * @param name - The queue name
+ * @param options - Analytics options (time range, granularity)
+ * @returns Time series data
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const timeseries = await getQueueTimeSeries(client, 'order-processing', {
+ *   granularity: 'hour',
+ *   start: '2026-01-14T00:00:00Z',
+ * });
+ * for (const point of timeseries.series) {
+ *   console.log(`${point.timestamp}: ${point.throughput} msg/h`);
+ * }
+ * ```
+ */
+export declare function getQueueTimeSeries(client: APIClient, name: string, options?: AnalyticsOptions): Promise<TimeSeriesData>;
+/**
+ * Stream real-time analytics for all queues via SSE.
+ *
+ * Returns an async iterator that yields stats events at the specified interval.
+ * The connection stays open until the iterator is closed or an error occurs.
+ *
+ * @param client - The API client instance
+ * @param options - Stream options (interval, orgId)
+ * @returns Async iterator of SSE stats events
+ *
+ * @example
+ * ```typescript
+ * const stream = streamOrgAnalytics(client, { interval: 5 });
+ * for await (const event of stream) {
+ *   console.log(`Backlog: ${event.backlog}, Throughput: ${event.throughput_1m}/min`);
+ * }
+ * ```
+ */
+export declare function streamOrgAnalytics(client: APIClient, options?: StreamAnalyticsOptions): AsyncGenerator<SSEStatsEvent, void, unknown>;
+/**
+ * Stream real-time analytics for a specific queue via SSE.
+ *
+ * Returns an async iterator that yields stats events at the specified interval.
+ *
+ * @param client - The API client instance
+ * @param name - The queue name
+ * @param options - Stream options (interval, orgId)
+ * @returns Async iterator of SSE stats events
+ *
+ * @example
+ * ```typescript
+ * const stream = streamQueueAnalytics(client, 'order-processing', { interval: 5 });
+ * for await (const event of stream) {
+ *   console.log(`Backlog: ${event.backlog}, In-flight: ${event.messages_in_flight}`);
+ * }
+ * ```
+ */
+export declare function streamQueueAnalytics(client: APIClient, name: string, options?: StreamAnalyticsOptions): AsyncGenerator<SSEStatsEvent, void, unknown>;
+//# sourceMappingURL=analytics.d.ts.map

package/dist/api/queue/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../../src/api/queue/analytics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,WAAW,CAAC;AAC9D,OAAO,EACN,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAEjB,KAAK,cAAc,EAEnB,KAAK,aAAa,EAElB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EAEnB,MAAM,YAAY,CAAC;AAUpB,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAEtC,CAAC;AACF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAExC,CAAC;AACF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAEpC,CAAC;AAmBF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,eAAe,CACpC,MAAM,EAAE,SAAS,EACjB,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,YAAY,CAAC,CAiBvB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,cAAc,CAAC,CAuBzB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,kBAAkB,CACvC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,cAAc,CAAC,CAiBzB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAuB,kBAAkB,CACxC,MAAM,EAAE,SAAS,EACjB,OAAO,CAAC,EAAE,sBAAsB,GAC9B,cAAc,CAAC,aAAa,EAAE,IAAI,EAAE,OAAO,CAAC,CAQ9C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAuB,oBAAoB,CAC1C,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,sBAAsB,GAC9B,cAAc,CAAC,aAAa,EAAE,IAAI,EAAE,OAAO,CAAC,CAU9C"}