@vertesia/common 1.5.0-dev.20260725.083715Z → 1.5.0-dev.20260804.124748Z

package/lib/api-schemas/audit-trail.js

@@ -0,0 +1,218 @@
+import { z } from 'zod';
+import { AUDIT_ACTIONS, AUDIT_AGGREGATION_DIMENSIONS } from '../audit-trail.js';
+import { NumberValueMapSchema } from './interaction.js';
+// The audit trail: the events `GET /audit-trail` pages through and the aggregation `POST
+// /audit-trail/aggregate` computes over them.
+//
+// `//` rather than `/** */` throughout: a JSDoc block immediately preceding an exported declaration
+// is picked up by the OpenAPI scanner and published as that component's `description`, which would
+// double up with the `description` stated in `.meta()`.
+export const AuditMeterSchema = z
+    .strictObject({
+    category: z.string(),
+    type: z.string(),
+    quantity: z.number(),
+})
+    .meta({
+    id: 'AuditMeter',
+    description: 'Generic metering entry attached to audit events. Used for cost attribution, usage tracking, and billing.\n\nExamples:   { category: "tokens", type: "input", quantity: 1234 }   { category: "tokens", type: "output", quantity: 567 }   { category: "compute", type: "duration_ms", quantity: 2100 }   { category: "processing", type: "pages", quantity: 12 }',
+});
+// The two action/dimension vocabularies read their members off the `as const` arrays in
+// `../audit-trail.js` rather than restating them: those arrays are what the readers and the
+// aggregation validator iterate, so a member added there reaches the document with nothing here
+// changing. Everything else in this file is spelled out.
+export const KnownAuditActionSchema = z.enum(AUDIT_ACTIONS).meta({ id: 'KnownAuditAction' });
+export const EventCategorySchema = z
+    .enum(['content', 'workflow', 'security', 'billing', 'system', 'external'])
+    .meta({ id: 'EventCategory' });
+export const AuditAggregationDimensionMapSchema = z
+    .strictObject({
+    time: z.string().nullable().optional(),
+    action: z.string().nullable().optional(),
+    resource_type: z.string().nullable().optional(),
+    event_category: z.string().nullable().optional(),
+    provider: z.string().nullable().optional(),
+    project_id: z.string().nullable().optional(),
+    'details.pipeline': z.string().nullable().optional(),
+    'details.verdict': z.string().nullable().optional(),
+    'details.workflow_type': z.string().nullable().optional(),
+    'details.rule_id': z.string().nullable().optional(),
+    model: z.string().nullable().optional(),
+})
+    .meta({ id: 'AuditAggregationDimensionMap' });
+export const AuditAggregationDistinctFieldSchema = z
+    .enum(['resource_id', 'request_id'])
+    .meta({ id: 'AuditAggregationDistinctField' });
+export const AuditAggregationOperationSchema = z
+    .enum(['count', 'count_distinct', 'sum_meter', 'average_meter'])
+    .meta({ id: 'AuditAggregationOperation' });
+export const AuditAggregationResolutionSchema = z
+    .enum(['hour', 'day', 'week', 'month'])
+    .meta({ id: 'AuditAggregationResolution' });
+export const AuditAggregationDimensionSchema = z
+    .enum(AUDIT_AGGREGATION_DIMENSIONS)
+    .meta({ id: 'AuditAggregationDimension' });
+export const AuditAggregationDetailFieldSchema = z
+    .enum(['pipeline', 'verdict', 'workflow_type', 'rule_id'])
+    .meta({ id: 'AuditAggregationDetailField' });
+export const AuditActionSchema = z.union([KnownAuditActionSchema, z.string()]).meta({ id: 'AuditAction' });
+export const AuditAggregationRowSchema = z
+    .strictObject({
+    dimensions: AuditAggregationDimensionMapSchema,
+    metrics: NumberValueMapSchema,
+})
+    .meta({ id: 'AuditAggregationRow' });
+export const AuditAggregationMetricSchema = z
+    .strictObject({
+    id: z.string().meta({
+        description: 'Stable key used in response rows. Must contain only letters, numbers, underscores, or hyphens.',
+    }),
+    operation: AuditAggregationOperationSchema,
+    field: AuditAggregationDistinctFieldSchema.meta({ description: 'Required for count_distinct.' }).optional(),
+    meterCategory: z.string().meta({ description: 'Required for meter operations.' }).optional(),
+    meterType: z.string().meta({ description: 'Required for meter operations.' }).optional(),
+})
+    .meta({ id: 'AuditAggregationMetric' });
+export const AuditAggregationGroupSchema = z
+    .strictObject({
+    dimension: AuditAggregationDimensionSchema,
+    resolution: AuditAggregationResolutionSchema.meta({
+        description: 'Required for the time dimension; defaults to day.',
+    }).optional(),
+})
+    .meta({ id: 'AuditAggregationGroup' });
+export const AuditAggregationDetailFilterSchema = z
+    .strictObject({
+    field: AuditAggregationDetailFieldSchema,
+    values: z.array(z.string()),
+})
+    .meta({ id: 'AuditAggregationDetailFilter' });
+export const AuditTrailEventSchema = z
+    .strictObject({
+    event_type: z.literal('audit'),
+    event_id: z.string().optional(),
+    event_category: EventCategorySchema.optional(),
+    source: z.string().nullable().optional(),
+    root_event_id: z.string().optional(),
+    caused_by_event_id: z.string().optional(),
+    hop_count: z.number().optional(),
+    audit_trail: z.boolean().optional(),
+    replay_of: z.string().optional(),
+    replay_root_event_id: z.string().optional(),
+    replayed_by: z.string().optional(),
+    action: AuditActionSchema,
+    resource_type: z.string(),
+    resource_id: z.string(),
+    timestamp: z.string(),
+    request_id: z.string(),
+    status: z.number(),
+    success: z.boolean(),
+    principal_id: z.string().nullable(),
+    principal_type: z.string().nullable(),
+    effective_principal_id: z.string().nullable(),
+    roles: z.array(z.string()),
+    account_id: z.string().nullable(),
+    project_id: z.string().nullable(),
+    tenant_id: z.string().nullable(),
+    account_name: z.string().nullable(),
+    project_name: z.string().nullable(),
+    provider: z
+        .string()
+        .nullable()
+        .meta({ description: 'Provider type for billable/provider-backed events, e.g. vertexai, bedrock.' })
+        .optional(),
+    meters: z
+        .array(AuditMeterSchema)
+        .meta({ description: 'Generic metering data for cost attribution and usage tracking' })
+        .optional(),
+    details: z
+        .looseObject({})
+        .meta({ description: 'Event-specific metadata — shape varies by action/resource_type' })
+        .optional(),
+})
+    .meta({ id: 'AuditTrailEvent' });
+export const AuditAggregationResponseSchema = z
+    .strictObject({
+    rows: z.array(AuditAggregationRowSchema),
+    from: z.string(),
+    to: z.string(),
+})
+    .meta({ id: 'AuditAggregationResponse' });
+export const AuditAggregationFilterSchema = z
+    .strictObject({
+    actions: z.array(AuditActionSchema).optional(),
+    resourceTypes: z.array(z.string()).optional(),
+    eventCategories: z.array(EventCategorySchema).optional(),
+    providers: z.array(z.string()).optional(),
+    success: z.boolean().optional(),
+    details: z.array(AuditAggregationDetailFilterSchema).optional(),
+})
+    .meta({ id: 'AuditAggregationFilter' });
+export const AuditTrailResponseSchema = z
+    .strictObject({
+    events: z.array(AuditTrailEventSchema),
+    hasNext: z.boolean().meta({ description: 'Whether there are more events after this page' }),
+    limit: z.number(),
+    offset: z.number(),
+})
+    .meta({ id: 'AuditTrailResponse' });
+export const AuditAggregationQuerySchema = z
+    .strictObject({
+    projectId: z
+        .string()
+        .meta({ description: 'Optional account-admin project filter. Ignored for project-scoped principals.' })
+        .optional(),
+    from: z
+        .string()
+        .meta({ description: 'Start time; defaults to 30 days before to. The server caps the range at 366 days.' })
+        .optional(),
+    to: z.string().meta({ description: 'End time; defaults to the current time.' }).optional(),
+    filter: AuditAggregationFilterSchema.optional(),
+    groupBy: z.array(AuditAggregationGroupSchema).optional(),
+    metrics: z.array(AuditAggregationMetricSchema),
+    limit: z.number().meta({ description: 'Maximum groups returned (default 50, max 200).' }).optional(),
+})
+    .meta({
+    id: 'AuditAggregationQuery',
+    description: 'Safe audit aggregation query. The server always applies the authenticated account scope and, for project-scoped principals, replaces projectId with the authenticated project.',
+});
+// Query contracts are registry components even though the scanner expands them into parameters.
+export const AuditTrailQuerySchema = z
+    .strictObject({
+    actions: z.array(AuditActionSchema).meta({ description: 'Filter by action types' }).optional(),
+    resourceTypes: z.array(z.string()).meta({ description: 'Filter by resource types' }).optional(),
+    resourceId: z.string().meta({ description: 'Filter by resource ID' }).optional(),
+    principalId: z
+        .string()
+        .meta({ description: 'Filter by exact actor principal ref (matches principal_id column).' })
+        .optional(),
+    principalType: z
+        .string()
+        .meta({ description: 'Filter by top-level actor category (matches principal_type column).' })
+        .optional(),
+    effectivePrincipalId: z
+        .string()
+        .meta({
+        description: 'Filter by delegated/direct effective principal ref (matches effective_principal_id column).',
+    })
+        .optional(),
+    hasEffectivePrincipal: z
+        .boolean()
+        .meta({ description: 'Filter by whether an event has an effective principal ref.' })
+        .optional(),
+    projectId: z
+        .string()
+        .meta({
+        description: 'Filter by project ID. Honoured only for account-scoped principals; a project-scoped principal always reads its own project.',
+    })
+        .optional(),
+    from: z.string().meta({ description: 'Start time (ISO string)' }).optional(),
+    to: z.string().meta({ description: 'End time (ISO string)' }).optional(),
+    limit: z
+        .number()
+        .meta({ description: 'Pagination: number of items to return (default 50, max 200)' })
+        .optional(),
+    offset: z.number().meta({ description: 'Pagination: offset' }).optional(),
+})
+    .meta({ id: 'AuditTrailQuery' });
+//# sourceMappingURL=audit-trail.js.map

package/lib/api-schemas/audit-trail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-trail.js","sourceRoot":"","sources":["../../src/api-schemas/audit-trail.ts"],"names":[],"mappings":"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"}

package/lib/api-schemas/bulk-operation.d.ts

@@ -0,0 +1,104 @@
+import { z } from 'zod';
+export declare const BulkObjectDeleteResultSchema: z.ZodObject<{
+    operation: z.ZodLiteral<"delete">;
+    status: z.ZodEnum<{
+        failed: "failed";
+        completed: "completed";
+        in_progress: "in_progress";
+    }>;
+    deleted: z.ZodNumber;
+    failed: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const BulkObjectUpdateResultSchema: z.ZodObject<{
+    operation: z.ZodLiteral<"update">;
+    status: z.ZodEnum<{
+        failed: "failed";
+        completed: "completed";
+        in_progress: "in_progress";
+    }>;
+    updated: z.ZodNumber;
+    failed: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const BulkObjectCreateResultSchema: z.ZodObject<{
+    operation: z.ZodLiteral<"create">;
+    status: z.ZodEnum<{
+        failed: "failed";
+        completed: "completed";
+        in_progress: "in_progress";
+    }>;
+    created: z.ZodNumber;
+    objects: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        index: z.ZodOptional<z.ZodNumber>;
+        external_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    failed: z.ZodArray<z.ZodObject<{
+        external_id: z.ZodOptional<z.ZodString>;
+        index: z.ZodNumber;
+        error: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const BulkOperationResultSchema: z.ZodObject<{
+    operation: z.ZodLiteral<"generic">;
+    status: z.ZodEnum<{
+        failed: "failed";
+        completed: "completed";
+        in_progress: "in_progress";
+    }>;
+}, z.core.$strict>;
+export declare const BulkOperationPayloadSchema: z.ZodObject<{
+    name: z.ZodEnum<{
+        create: "create";
+        update: "update";
+        delete: "delete";
+        change_type: "change_type";
+        start_workflow: "start_workflow";
+    }>;
+    ids: z.ZodArray<z.ZodString>;
+    params: z.ZodObject<{}, z.core.$loose>;
+}, z.core.$strict>;
+export declare const BulkOperationResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    operation: z.ZodLiteral<"generic">;
+    status: z.ZodEnum<{
+        failed: "failed";
+        completed: "completed";
+        in_progress: "in_progress";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    operation: z.ZodLiteral<"create">;
+    status: z.ZodEnum<{
+        failed: "failed";
+        completed: "completed";
+        in_progress: "in_progress";
+    }>;
+    created: z.ZodNumber;
+    objects: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        index: z.ZodOptional<z.ZodNumber>;
+        external_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    failed: z.ZodArray<z.ZodObject<{
+        external_id: z.ZodOptional<z.ZodString>;
+        index: z.ZodNumber;
+        error: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    operation: z.ZodLiteral<"update">;
+    status: z.ZodEnum<{
+        failed: "failed";
+        completed: "completed";
+        in_progress: "in_progress";
+    }>;
+    updated: z.ZodNumber;
+    failed: z.ZodArray<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    operation: z.ZodLiteral<"delete">;
+    status: z.ZodEnum<{
+        failed: "failed";
+        completed: "completed";
+        in_progress: "in_progress";
+    }>;
+    deleted: z.ZodNumber;
+    failed: z.ZodArray<z.ZodString>;
+}, z.core.$strict>], "operation">;
+//# sourceMappingURL=bulk-operation.d.ts.map

package/lib/api-schemas/bulk-operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-operation.d.ts","sourceRoot":"","sources":["../../src/api-schemas/bulk-operation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,4BAA4B;;;;;;;;;kBASE,CAAC;AAE5C,eAAO,MAAM,4BAA4B;;;;;;;;;kBASE,CAAC;AAE5C,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;kBAwBE,CAAC;AAE5C,eAAO,MAAM,yBAAyB;;;;;;;kBAKE,CAAC;AAEzC,eAAO,MAAM,0BAA0B;;;;;;;;;;kBAQE,CAAC;AAE1C,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAOE,CAAC"}

package/lib/api-schemas/bulk-operation.js

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+export const BulkObjectDeleteResultSchema = z
+    .strictObject({
+    operation: z.literal('delete'),
+    status: z.enum(['in_progress', 'completed', 'failed']),
+    deleted: z.number().meta({ description: 'Number of documents deleted (including revisions)' }),
+    failed: z
+        .array(z.string())
+        .meta({ description: 'IDs that were not found or user had no permission to delete' }),
+})
+    .meta({ id: 'BulkObjectDeleteResult' });
+export const BulkObjectUpdateResultSchema = z
+    .strictObject({
+    operation: z.literal('update'),
+    status: z.enum(['in_progress', 'completed', 'failed']),
+    updated: z.number().meta({ description: 'Number of documents successfully updated' }),
+    failed: z
+        .array(z.string())
+        .meta({ description: 'IDs that were not found, not authorized, or failed to update' }),
+})
+    .meta({ id: 'BulkObjectUpdateResult' });
+export const BulkObjectCreateResultSchema = z
+    .strictObject({
+    operation: z.literal('create'),
+    status: z.enum(['in_progress', 'completed', 'failed']),
+    created: z.number().meta({ description: 'Number of documents successfully created' }),
+    objects: z
+        .array(z.strictObject({
+        id: z.string(),
+        index: z.number().optional(),
+        external_id: z.string().optional(),
+    }))
+        .meta({ description: 'Successfully created objects with their IDs' }),
+    failed: z
+        .array(z.strictObject({
+        external_id: z.string().optional(),
+        index: z.number(),
+        error: z.string(),
+    }))
+        .meta({ description: 'Objects that failed to create' }),
+})
+    .meta({ id: 'BulkObjectCreateResult' });
+export const BulkOperationResultSchema = z
+    .strictObject({
+    operation: z.literal('generic'),
+    status: z.enum(['in_progress', 'completed', 'failed']),
+})
+    .meta({ id: 'BulkOperationResult' });
+export const BulkOperationPayloadSchema = z
+    .strictObject({
+    name: z
+        .enum(['change_type', 'create', 'delete', 'start_workflow', 'update'])
+        .meta({ description: 'The operation name' }),
+    ids: z.array(z.string()).meta({ description: 'The IDs of the objects to operate on' }),
+    params: z.looseObject({}).meta({ description: 'The operation parameters.' }),
+})
+    .meta({ id: 'BulkOperationPayload' });
+export const BulkOperationResponseSchema = z
+    .discriminatedUnion('operation', [
+    BulkOperationResultSchema,
+    BulkObjectCreateResultSchema,
+    BulkObjectUpdateResultSchema,
+    BulkObjectDeleteResultSchema,
+])
+    .meta({ id: 'BulkOperationResponse' });
+//# sourceMappingURL=bulk-operation.js.map

package/lib/api-schemas/bulk-operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-operation.js","sourceRoot":"","sources":["../../src/api-schemas/bulk-operation.ts"],"names":[],"mappings":"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"}

package/lib/api-schemas/commands.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+export declare const GenericCommandResponseSchema: z.ZodObject<{
+    status: z.ZodString;
+    message: z.ZodString;
+    err: z.ZodOptional<z.ZodUnknown>;
+    details: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strict>;
+export declare const RunMigrationResponseSchema: z.ZodObject<{
+    status: z.ZodString;
+}, z.core.$strict>;
+/**
+ * The migration-command body, including the `params` the published component omitted.
+ *
+ * `force` was all the document ever declared, and while nothing enforced the closed component that
+ * was merely incomplete rather than wrong: `MigrationTool.migrate()` reads `payload.params` off the
+ * same body and hands it to `doMigrate()`, which is how `migrate-agent-runs` receives its `tenantId`
+ * and `since`. Publishing only `force` on a closed component and then enforcing it would have made
+ * the endpoint reject the invocation documented in the migration's own header comment.
+ *
+ * `params` is freeform because it genuinely is: `MigrationTool<P>` is generic and each migration
+ * names its own parameter type, so there is no single shape to publish. The alternative — one
+ * component per migration — would put the operator endpoint's registry entries in step with a list
+ * that changes every time someone adds a backfill.
+ */
+export declare const RunMigrationPayloadSchema: z.ZodObject<{
+    force: z.ZodOptional<z.ZodBoolean>;
+    params: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+}, z.core.$strict>;
+/**
+ * The migration listing, given the shape the handler has always returned.
+ *
+ * The converted component was `z.unknown()`, faithfully reproducing what the document published —
+ * the endpoint declared a response component and never described it, so the middleware validated
+ * every response against "anything". Nothing about that was a conversion artifact worth preserving:
+ * the handler returns `{ migrations: [{ name }] }` and has since it was written.
+ *
+ * Widening a published `{}` to a real object is a contract ADDITION rather than a restriction —
+ * every response that validated before still validates — but it is visible in the generated clients,
+ * which gain a model where they had a bare object. See operation 27 of the 1.5 runbook.
+ */
+export declare const MigrationListResponseSchema: z.ZodObject<{
+    migrations: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const DeleteCountResultSchema: z.ZodObject<{
+    id: z.ZodString;
+    count: z.ZodNumber;
+}, z.core.$strict>;
+//# sourceMappingURL=commands.d.ts.map

package/lib/api-schemas/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/api-schemas/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,4BAA4B;;;;;kBAOE,CAAC;AAE5C,eAAO,MAAM,0BAA0B;;kBAIE,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,yBAAyB;;;kBAKE,CAAC;AAEzC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,2BAA2B;;;;kBAIE,CAAC;AAE3C,eAAO,MAAM,uBAAuB;;;kBAKE,CAAC"}

package/lib/api-schemas/commands.js

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+export const GenericCommandResponseSchema = z
+    .strictObject({
+    status: z.string(),
+    message: z.string(),
+    err: z.unknown().optional(),
+    details: z.unknown().optional(),
+})
+    .meta({ id: 'GenericCommandResponse' });
+export const RunMigrationResponseSchema = z
+    .strictObject({
+    status: z.string(),
+})
+    .meta({ id: 'RunMigrationResponse' });
+/**
+ * The migration-command body, including the `params` the published component omitted.
+ *
+ * `force` was all the document ever declared, and while nothing enforced the closed component that
+ * was merely incomplete rather than wrong: `MigrationTool.migrate()` reads `payload.params` off the
+ * same body and hands it to `doMigrate()`, which is how `migrate-agent-runs` receives its `tenantId`
+ * and `since`. Publishing only `force` on a closed component and then enforcing it would have made
+ * the endpoint reject the invocation documented in the migration's own header comment.
+ *
+ * `params` is freeform because it genuinely is: `MigrationTool<P>` is generic and each migration
+ * names its own parameter type, so there is no single shape to publish. The alternative — one
+ * component per migration — would put the operator endpoint's registry entries in step with a list
+ * that changes every time someone adds a backfill.
+ */
+export const RunMigrationPayloadSchema = z
+    .strictObject({
+    force: z.boolean().optional(),
+    params: z.looseObject({}).optional(),
+})
+    .meta({ id: 'RunMigrationPayload' });
+/**
+ * The migration listing, given the shape the handler has always returned.
+ *
+ * The converted component was `z.unknown()`, faithfully reproducing what the document published —
+ * the endpoint declared a response component and never described it, so the middleware validated
+ * every response against "anything". Nothing about that was a conversion artifact worth preserving:
+ * the handler returns `{ migrations: [{ name }] }` and has since it was written.
+ *
+ * Widening a published `{}` to a real object is a contract ADDITION rather than a restriction —
+ * every response that validated before still validates — but it is visible in the generated clients,
+ * which gain a model where they had a bare object. See operation 27 of the 1.5 runbook.
+ */
+export const MigrationListResponseSchema = z
+    .strictObject({
+    migrations: z.array(z.strictObject({ name: z.string() })),
+})
+    .meta({ id: 'MigrationListResponse' });
+export const DeleteCountResultSchema = z
+    .strictObject({
+    id: z.string(),
+    count: z.number(),
+})
+    .meta({ id: 'DeleteCountResult' });
+//# sourceMappingURL=commands.js.map

package/lib/api-schemas/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/api-schemas/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC;KACxC,YAAY,CAAC;IACV,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC;KACD,IAAI,CAAC,EAAE,EAAE,EAAE,wBAAwB,EAAE,CAAC,CAAC;AAE5C,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC;KACtC,YAAY,CAAC;IACV,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC;KACD,IAAI,CAAC,EAAE,EAAE,EAAE,sBAAsB,EAAE,CAAC,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACrC,YAAY,CAAC;IACV,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7B,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CACvC,CAAC;KACD,IAAI,CAAC,EAAE,EAAE,EAAE,qBAAqB,EAAE,CAAC,CAAC;AAEzC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC;KACvC,YAAY,CAAC;IACV,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CAC5D,CAAC;KACD,IAAI,CAAC,EAAE,EAAE,EAAE,uBAAuB,EAAE,CAAC,CAAC;AAE3C,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACnC,YAAY,CAAC;IACV,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC;KACD,IAAI,CAAC,EAAE,EAAE,EAAE,mBAAmB,EAAE,CAAC,CAAC"}