@constructive-io/sdk 0.20.9 → 0.21.0

package/admin/orm/index.d.ts

@@ -35,6 +35,7 @@ import { AppLimitEventModel } from './models/appLimitEvent';
 import { OrgLimitEventModel } from './models/orgLimitEvent';
 import { OrgGrantModel } from './models/orgGrant';
 import { OrgChartEdgeModel } from './models/orgChartEdge';
+import { UsageSnapshotModel } from './models/usageSnapshot';
 import { OrgMemberProfileModel } from './models/orgMemberProfile';
 import { AppLevelModel } from './models/appLevel';
 import { AppLimitModel } from './models/appLimit';
@@ -112,6 +113,7 @@ export declare function createClient(config: OrmClientConfig): {
     orgLimitEvent: OrgLimitEventModel;
     orgGrant: OrgGrantModel;
     orgChartEdge: OrgChartEdgeModel;
+    usageSnapshot: UsageSnapshotModel;
     orgMemberProfile: OrgMemberProfileModel;
     appLevel: AppLevelModel;
     appLimit: AppLimitModel;

package/admin/orm/index.js

@@ -58,6 +58,7 @@ const appLimitEvent_1 = require("./models/appLimitEvent");
 const orgLimitEvent_1 = require("./models/orgLimitEvent");
 const orgGrant_1 = require("./models/orgGrant");
 const orgChartEdge_1 = require("./models/orgChartEdge");
+const usageSnapshot_1 = require("./models/usageSnapshot");
 const orgMemberProfile_1 = require("./models/orgMemberProfile");
 const appLevel_1 = require("./models/appLevel");
 const appLimit_1 = require("./models/appLimit");
@@ -142,6 +143,7 @@ function createClient(config) {
         orgLimitEvent: new orgLimitEvent_1.OrgLimitEventModel(client),
         orgGrant: new orgGrant_1.OrgGrantModel(client),
         orgChartEdge: new orgChartEdge_1.OrgChartEdgeModel(client),
+        usageSnapshot: new usageSnapshot_1.UsageSnapshotModel(client),
         orgMemberProfile: new orgMemberProfile_1.OrgMemberProfileModel(client),
         appLevel: new appLevel_1.AppLevelModel(client),
         appLimit: new appLimit_1.AppLimitModel(client),

package/admin/orm/input-types.d.ts

@@ -661,6 +661,20 @@ export interface OrgChartEdge {
     /** Numeric seniority level for this position (higher = more senior) */
     positionLevel?: number | null;
 }
+/** Periodic snapshot of a single metric for a database. Collected by the snapshot_usage() cron job in constructive-limits. Each row records one metric measurement (e.g. reads, writes, storage_bytes) at a point in time, with optional dimensions for sub-metric breakdowns. */
+export interface UsageSnapshot {
+    /** The database this snapshot belongs to. References metaschema_public.database.id but declared without an FK constraint — the snapshot collector runs in a platform context where the FK would add overhead without value. */
+    databaseId?: string | null;
+    /** Identifier for the metric being measured (e.g. 'reads', 'writes', 'storage_bytes', 'compute_time_ms'). */
+    metricName?: string | null;
+    /** The measured value at the time of capture. Interpretation depends on metric_name (count, bytes, milliseconds, etc.). */
+    metricValue?: string | null;
+    /** Optional sub-metric breakdowns as key-value pairs (e.g. {"query_type": "select"} for reads). Empty object when no breakdown is needed. */
+    dimensions?: Record<string, unknown> | null;
+    /** When this snapshot was taken. Defaults to the current timestamp; the snapshot collector may override this for backdated imports. */
+    capturedAt?: string | null;
+    id: string;
+}
 /** Per-membership profile information visible to other entity members (display name, email, title, bio, avatar) */
 export interface OrgMemberProfile {
     id: string;
@@ -1008,6 +1022,8 @@ export interface OrgGrantRelations {
 }
 export interface OrgChartEdgeRelations {
 }
+export interface UsageSnapshotRelations {
+}
 export interface OrgMemberProfileRelations {
     membership?: OrgMembership | null;
 }
@@ -1066,6 +1082,7 @@ export type AppLimitEventWithRelations = AppLimitEvent & AppLimitEventRelations;
 export type OrgLimitEventWithRelations = OrgLimitEvent & OrgLimitEventRelations;
 export type OrgGrantWithRelations = OrgGrant & OrgGrantRelations;
 export type OrgChartEdgeWithRelations = OrgChartEdge & OrgChartEdgeRelations;
+export type UsageSnapshotWithRelations = UsageSnapshot & UsageSnapshotRelations;
 export type OrgMemberProfileWithRelations = OrgMemberProfile & OrgMemberProfileRelations;
 export type AppLevelWithRelations = AppLevel & AppLevelRelations;
 export type AppLimitWithRelations = AppLimit & AppLimitRelations;
@@ -1393,6 +1410,14 @@ export type OrgChartEdgeSelect = {
     positionTitle?: boolean;
     positionLevel?: boolean;
 };
+export type UsageSnapshotSelect = {
+    databaseId?: boolean;
+    metricName?: boolean;
+    metricValue?: boolean;
+    dimensions?: boolean;
+    capturedAt?: boolean;
+    id?: boolean;
+};
 export type OrgMemberProfileSelect = {
     id?: boolean;
     createdAt?: boolean;
@@ -2252,6 +2277,26 @@ export interface OrgChartEdgeFilter {
     /** Negates the expression. */
     not?: OrgChartEdgeFilter;
 }
+export interface UsageSnapshotFilter {
+    /** Filter by the object’s `databaseId` field. */
+    databaseId?: UUIDFilter;
+    /** Filter by the object’s `metricName` field. */
+    metricName?: StringFilter;
+    /** Filter by the object’s `metricValue` field. */
+    metricValue?: BigIntFilter;
+    /** Filter by the object’s `dimensions` field. */
+    dimensions?: JSONFilter;
+    /** Filter by the object’s `capturedAt` field. */
+    capturedAt?: DatetimeFilter;
+    /** Filter by the object’s `id` field. */
+    id?: UUIDFilter;
+    /** Checks for all expressions in this list. */
+    and?: UsageSnapshotFilter[];
+    /** Checks for any expressions in this list. */
+    or?: UsageSnapshotFilter[];
+    /** Negates the expression. */
+    not?: UsageSnapshotFilter;
+}
 export interface OrgMemberProfileFilter {
     /** Filter by the object’s `id` field. */
     id?: UUIDFilter;
@@ -2628,6 +2673,7 @@ export type AppLimitEventOrderBy = 'NATURAL' | 'NAME_ASC' | 'NAME_DESC' | 'ACTOR
 export type OrgLimitEventOrderBy = 'NATURAL' | 'NAME_ASC' | 'NAME_DESC' | 'ACTOR_ID_ASC' | 'ACTOR_ID_DESC' | 'ENTITY_ID_ASC' | 'ENTITY_ID_DESC' | 'EVENT_TYPE_ASC' | 'EVENT_TYPE_DESC' | 'DELTA_ASC' | 'DELTA_DESC' | 'NUM_BEFORE_ASC' | 'NUM_BEFORE_DESC' | 'NUM_AFTER_ASC' | 'NUM_AFTER_DESC' | 'MAX_AT_EVENT_ASC' | 'MAX_AT_EVENT_DESC' | 'REASON_ASC' | 'REASON_DESC';
 export type OrgGrantOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'ID_ASC' | 'ID_DESC' | 'PERMISSIONS_ASC' | 'PERMISSIONS_DESC' | 'IS_GRANT_ASC' | 'IS_GRANT_DESC' | 'ACTOR_ID_ASC' | 'ACTOR_ID_DESC' | 'ENTITY_ID_ASC' | 'ENTITY_ID_DESC' | 'GRANTOR_ID_ASC' | 'GRANTOR_ID_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'UPDATED_AT_ASC' | 'UPDATED_AT_DESC';
 export type OrgChartEdgeOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'ID_ASC' | 'ID_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'UPDATED_AT_ASC' | 'UPDATED_AT_DESC' | 'ENTITY_ID_ASC' | 'ENTITY_ID_DESC' | 'CHILD_ID_ASC' | 'CHILD_ID_DESC' | 'PARENT_ID_ASC' | 'PARENT_ID_DESC' | 'POSITION_TITLE_ASC' | 'POSITION_TITLE_DESC' | 'POSITION_LEVEL_ASC' | 'POSITION_LEVEL_DESC';
+export type UsageSnapshotOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'DATABASE_ID_ASC' | 'DATABASE_ID_DESC' | 'METRIC_NAME_ASC' | 'METRIC_NAME_DESC' | 'METRIC_VALUE_ASC' | 'METRIC_VALUE_DESC' | 'DIMENSIONS_ASC' | 'DIMENSIONS_DESC' | 'CAPTURED_AT_ASC' | 'CAPTURED_AT_DESC' | 'ID_ASC' | 'ID_DESC';
 export type OrgMemberProfileOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'ID_ASC' | 'ID_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'UPDATED_AT_ASC' | 'UPDATED_AT_DESC' | 'MEMBERSHIP_ID_ASC' | 'MEMBERSHIP_ID_DESC' | 'ENTITY_ID_ASC' | 'ENTITY_ID_DESC' | 'ACTOR_ID_ASC' | 'ACTOR_ID_DESC' | 'DISPLAY_NAME_ASC' | 'DISPLAY_NAME_DESC' | 'EMAIL_ASC' | 'EMAIL_DESC' | 'TITLE_ASC' | 'TITLE_DESC' | 'BIO_ASC' | 'BIO_DESC' | 'PROFILE_PICTURE_ASC' | 'PROFILE_PICTURE_DESC';
 export type AppLevelOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'ID_ASC' | 'ID_DESC' | 'NAME_ASC' | 'NAME_DESC' | 'DESCRIPTION_ASC' | 'DESCRIPTION_DESC' | 'IMAGE_ASC' | 'IMAGE_DESC' | 'OWNER_ID_ASC' | 'OWNER_ID_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'UPDATED_AT_ASC' | 'UPDATED_AT_DESC';
 export type AppLimitOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'ID_ASC' | 'ID_DESC' | 'NAME_ASC' | 'NAME_DESC' | 'ACTOR_ID_ASC' | 'ACTOR_ID_DESC' | 'NUM_ASC' | 'NUM_DESC' | 'MAX_ASC' | 'MAX_DESC' | 'SOFT_MAX_ASC' | 'SOFT_MAX_DESC' | 'WINDOW_START_ASC' | 'WINDOW_START_DESC' | 'WINDOW_DURATION_ASC' | 'WINDOW_DURATION_DESC' | 'PLAN_MAX_ASC' | 'PLAN_MAX_DESC' | 'PURCHASED_CREDITS_ASC' | 'PURCHASED_CREDITS_DESC' | 'PERIOD_CREDITS_ASC' | 'PERIOD_CREDITS_DESC';
@@ -3492,6 +3538,32 @@ export interface DeleteOrgChartEdgeInput {
     clientMutationId?: string;
     id: string;
 }
+export interface CreateUsageSnapshotInput {
+    clientMutationId?: string;
+    usageSnapshot: {
+        databaseId: string;
+        metricName: string;
+        metricValue?: string;
+        dimensions?: Record<string, unknown>;
+        capturedAt?: string;
+    };
+}
+export interface UsageSnapshotPatch {
+    databaseId?: string | null;
+    metricName?: string | null;
+    metricValue?: string | null;
+    dimensions?: Record<string, unknown> | null;
+    capturedAt?: string | null;
+}
+export interface UpdateUsageSnapshotInput {
+    clientMutationId?: string;
+    id: string;
+    usageSnapshotPatch: UsageSnapshotPatch;
+}
+export interface DeleteUsageSnapshotInput {
+    clientMutationId?: string;
+    id: string;
+}
 export interface CreateOrgMemberProfileInput {
     clientMutationId?: string;
     orgMemberProfile: {
@@ -5978,6 +6050,51 @@ export type DeleteOrgChartEdgePayloadSelect = {
         select: OrgChartEdgeEdgeSelect;
     };
 };
+export interface CreateUsageSnapshotPayload {
+    clientMutationId?: string | null;
+    /** The `UsageSnapshot` that was created by this mutation. */
+    usageSnapshot?: UsageSnapshot | null;
+    usageSnapshotEdge?: UsageSnapshotEdge | null;
+}
+export type CreateUsageSnapshotPayloadSelect = {
+    clientMutationId?: boolean;
+    usageSnapshot?: {
+        select: UsageSnapshotSelect;
+    };
+    usageSnapshotEdge?: {
+        select: UsageSnapshotEdgeSelect;
+    };
+};
+export interface UpdateUsageSnapshotPayload {
+    clientMutationId?: string | null;
+    /** The `UsageSnapshot` that was updated by this mutation. */
+    usageSnapshot?: UsageSnapshot | null;
+    usageSnapshotEdge?: UsageSnapshotEdge | null;
+}
+export type UpdateUsageSnapshotPayloadSelect = {
+    clientMutationId?: boolean;
+    usageSnapshot?: {
+        select: UsageSnapshotSelect;
+    };
+    usageSnapshotEdge?: {
+        select: UsageSnapshotEdgeSelect;
+    };
+};
+export interface DeleteUsageSnapshotPayload {
+    clientMutationId?: string | null;
+    /** The `UsageSnapshot` that was deleted by this mutation. */
+    usageSnapshot?: UsageSnapshot | null;
+    usageSnapshotEdge?: UsageSnapshotEdge | null;
+}
+export type DeleteUsageSnapshotPayloadSelect = {
+    clientMutationId?: boolean;
+    usageSnapshot?: {
+        select: UsageSnapshotSelect;
+    };
+    usageSnapshotEdge?: {
+        select: UsageSnapshotEdgeSelect;
+    };
+};
 export interface CreateOrgMemberProfilePayload {
     clientMutationId?: string | null;
     /** The `OrgMemberProfile` that was created by this mutation. */
@@ -6829,6 +6946,18 @@ export type OrgChartEdgeEdgeSelect = {
         select: OrgChartEdgeSelect;
     };
 };
+/** A `UsageSnapshot` edge in the connection. */
+export interface UsageSnapshotEdge {
+    cursor?: string | null;
+    /** The `UsageSnapshot` at the end of the edge. */
+    node?: UsageSnapshot | null;
+}
+export type UsageSnapshotEdgeSelect = {
+    cursor?: boolean;
+    node?: {
+        select: UsageSnapshotSelect;
+    };
+};
 /** A `OrgMemberProfile` edge in the connection. */
 export interface OrgMemberProfileEdge {
     cursor?: string | null;

package/admin/orm/models/index.d.ts

@@ -39,6 +39,7 @@ export { AppLimitEventModel } from './appLimitEvent';
 export { OrgLimitEventModel } from './orgLimitEvent';
 export { OrgGrantModel } from './orgGrant';
 export { OrgChartEdgeModel } from './orgChartEdge';
+export { UsageSnapshotModel } from './usageSnapshot';
 export { OrgMemberProfileModel } from './orgMemberProfile';
 export { AppLevelModel } from './appLevel';
 export { AppLimitModel } from './appLimit';

package/admin/orm/models/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OrgMembershipModel = exports.AppMembershipModel = exports.OrgInviteModel = exports.OrgLimitModel = exports.OrgLimitAggregateModel = exports.OrgMembershipSettingModel = exports.AppInviteModel = exports.AppLimitModel = exports.AppLevelModel = exports.OrgMemberProfileModel = exports.OrgChartEdgeModel = exports.OrgGrantModel = exports.OrgLimitEventModel = exports.AppLimitEventModel = exports.OrgClaimedInviteModel = exports.OrgMembershipDefaultModel = exports.AppMembershipDefaultModel = exports.AppGrantModel = exports.AppClaimedInviteModel = exports.OrgChartEdgeGrantModel = exports.OrgLimitCreditModel = exports.OrgLimitDefaultModel = exports.AppLimitDefaultModel = exports.MembershipTypeModel = exports.OrgOwnerGrantModel = exports.OrgAdminGrantModel = exports.OrgLimitCapModel = exports.AppLimitCapModel = exports.OrgLimitCapsDefaultModel = exports.AppLimitCapsDefaultModel = exports.AppStepModel = exports.AppAchievementModel = exports.AppOwnerGrantModel = exports.AppAdminGrantModel = exports.OrgPermissionDefaultModel = exports.AppLimitCreditCodeModel = exports.AppPermissionDefaultModel = exports.OrgMemberModel = exports.AppLimitCreditModel = exports.AppLimitCreditCodeItemModel = exports.AppLimitCreditRedemptionModel = exports.AppLevelRequirementModel = exports.OrgPermissionModel = exports.AppPermissionModel = exports.OrgGetSubordinatesRecordModel = exports.OrgGetManagersRecordModel = void 0;
+exports.OrgMembershipModel = exports.AppMembershipModel = exports.OrgInviteModel = exports.OrgLimitModel = exports.OrgLimitAggregateModel = exports.OrgMembershipSettingModel = exports.AppInviteModel = exports.AppLimitModel = exports.AppLevelModel = exports.OrgMemberProfileModel = exports.UsageSnapshotModel = exports.OrgChartEdgeModel = exports.OrgGrantModel = exports.OrgLimitEventModel = exports.AppLimitEventModel = exports.OrgClaimedInviteModel = exports.OrgMembershipDefaultModel = exports.AppMembershipDefaultModel = exports.AppGrantModel = exports.AppClaimedInviteModel = exports.OrgChartEdgeGrantModel = exports.OrgLimitCreditModel = exports.OrgLimitDefaultModel = exports.AppLimitDefaultModel = exports.MembershipTypeModel = exports.OrgOwnerGrantModel = exports.OrgAdminGrantModel = exports.OrgLimitCapModel = exports.AppLimitCapModel = exports.OrgLimitCapsDefaultModel = exports.AppLimitCapsDefaultModel = exports.AppStepModel = exports.AppAchievementModel = exports.AppOwnerGrantModel = exports.AppAdminGrantModel = exports.OrgPermissionDefaultModel = exports.AppLimitCreditCodeModel = exports.AppPermissionDefaultModel = exports.OrgMemberModel = exports.AppLimitCreditModel = exports.AppLimitCreditCodeItemModel = exports.AppLimitCreditRedemptionModel = exports.AppLevelRequirementModel = exports.OrgPermissionModel = exports.AppPermissionModel = exports.OrgGetSubordinatesRecordModel = exports.OrgGetManagersRecordModel = void 0;
 /**
  * Models barrel export
  * @generated by @constructive-io/graphql-codegen
@@ -78,6 +78,8 @@ var orgGrant_1 = require("./orgGrant");
 Object.defineProperty(exports, "OrgGrantModel", { enumerable: true, get: function () { return orgGrant_1.OrgGrantModel; } });
 var orgChartEdge_1 = require("./orgChartEdge");
 Object.defineProperty(exports, "OrgChartEdgeModel", { enumerable: true, get: function () { return orgChartEdge_1.OrgChartEdgeModel; } });
+var usageSnapshot_1 = require("./usageSnapshot");
+Object.defineProperty(exports, "UsageSnapshotModel", { enumerable: true, get: function () { return usageSnapshot_1.UsageSnapshotModel; } });
 var orgMemberProfile_1 = require("./orgMemberProfile");
 Object.defineProperty(exports, "OrgMemberProfileModel", { enumerable: true, get: function () { return orgMemberProfile_1.OrgMemberProfileModel; } });
 var appLevel_1 = require("./appLevel");

package/admin/orm/models/usageSnapshot.d.ts

@@ -0,0 +1,56 @@
+/**
+ * UsageSnapshot model for ORM client
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { OrmClient } from '../client';
+import { QueryBuilder } from '../query-builder';
+import type { ConnectionResult, FindManyArgs, FindFirstArgs, CreateArgs, UpdateArgs, DeleteArgs, InferSelectResult, StrictSelect } from '../select-types';
+import type { UsageSnapshotWithRelations, UsageSnapshotSelect, UsageSnapshotFilter, UsageSnapshotOrderBy, CreateUsageSnapshotInput, UsageSnapshotPatch } from '../input-types';
+export declare class UsageSnapshotModel {
+    private client;
+    constructor(client: OrmClient);
+    findMany<S extends UsageSnapshotSelect>(args: FindManyArgs<S, UsageSnapshotFilter, UsageSnapshotOrderBy> & {
+        select: S;
+    } & StrictSelect<S, UsageSnapshotSelect>): QueryBuilder<{
+        usageSnapshots: ConnectionResult<InferSelectResult<UsageSnapshotWithRelations, S>>;
+    }>;
+    findFirst<S extends UsageSnapshotSelect>(args: FindFirstArgs<S, UsageSnapshotFilter> & {
+        select: S;
+    } & StrictSelect<S, UsageSnapshotSelect>): QueryBuilder<{
+        usageSnapshots: {
+            nodes: InferSelectResult<UsageSnapshotWithRelations, S>[];
+        };
+    }>;
+    findOne<S extends UsageSnapshotSelect>(args: {
+        id: string;
+        select: S;
+    } & StrictSelect<S, UsageSnapshotSelect>): QueryBuilder<{
+        usageSnapshot: InferSelectResult<UsageSnapshotWithRelations, S> | null;
+    }>;
+    create<S extends UsageSnapshotSelect>(args: CreateArgs<S, CreateUsageSnapshotInput['usageSnapshot']> & {
+        select: S;
+    } & StrictSelect<S, UsageSnapshotSelect>): QueryBuilder<{
+        createUsageSnapshot: {
+            usageSnapshot: InferSelectResult<UsageSnapshotWithRelations, S>;
+        };
+    }>;
+    update<S extends UsageSnapshotSelect>(args: UpdateArgs<S, {
+        id: string;
+    }, UsageSnapshotPatch> & {
+        select: S;
+    } & StrictSelect<S, UsageSnapshotSelect>): QueryBuilder<{
+        updateUsageSnapshot: {
+            usageSnapshot: InferSelectResult<UsageSnapshotWithRelations, S>;
+        };
+    }>;
+    delete<S extends UsageSnapshotSelect>(args: DeleteArgs<{
+        id: string;
+    }, S> & {
+        select: S;
+    } & StrictSelect<S, UsageSnapshotSelect>): QueryBuilder<{
+        deleteUsageSnapshot: {
+            usageSnapshot: InferSelectResult<UsageSnapshotWithRelations, S>;
+        };
+    }>;
+}

package/admin/orm/models/usageSnapshot.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsageSnapshotModel = void 0;
+const query_builder_1 = require("../query-builder");
+const input_types_1 = require("../input-types");
+class UsageSnapshotModel {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    findMany(args) {
+        const { document, variables } = (0, query_builder_1.buildFindManyDocument)('UsageSnapshot', 'usageSnapshots', args.select, {
+            where: args?.where,
+            orderBy: args?.orderBy,
+            first: args?.first,
+            last: args?.last,
+            after: args?.after,
+            before: args?.before,
+            offset: args?.offset,
+        }, 'UsageSnapshotFilter', 'UsageSnapshotOrderBy', input_types_1.connectionFieldsMap);
+        return new query_builder_1.QueryBuilder({
+            client: this.client,
+            operation: 'query',
+            operationName: 'UsageSnapshot',
+            fieldName: 'usageSnapshots',
+            document,
+            variables,
+        });
+    }
+    findFirst(args) {
+        const { document, variables } = (0, query_builder_1.buildFindFirstDocument)('UsageSnapshot', 'usageSnapshots', args.select, {
+            where: args?.where,
+        }, 'UsageSnapshotFilter', input_types_1.connectionFieldsMap);
+        return new query_builder_1.QueryBuilder({
+            client: this.client,
+            operation: 'query',
+            operationName: 'UsageSnapshot',
+            fieldName: 'usageSnapshots',
+            document,
+            variables,
+        });
+    }
+    findOne(args) {
+        const { document, variables } = (0, query_builder_1.buildFindManyDocument)('UsageSnapshot', 'usageSnapshots', args.select, {
+            where: {
+                id: {
+                    equalTo: args.id,
+                },
+            },
+            first: 1,
+        }, 'UsageSnapshotFilter', 'UsageSnapshotOrderBy', input_types_1.connectionFieldsMap);
+        return new query_builder_1.QueryBuilder({
+            client: this.client,
+            operation: 'query',
+            operationName: 'UsageSnapshot',
+            fieldName: 'usageSnapshot',
+            document,
+            variables,
+            transform: (data) => ({
+                usageSnapshot: data.usageSnapshots?.nodes?.[0] ?? null,
+            }),
+        });
+    }
+    create(args) {
+        const { document, variables } = (0, query_builder_1.buildCreateDocument)('UsageSnapshot', 'createUsageSnapshot', 'usageSnapshot', args.select, args.data, 'CreateUsageSnapshotInput', input_types_1.connectionFieldsMap);
+        return new query_builder_1.QueryBuilder({
+            client: this.client,
+            operation: 'mutation',
+            operationName: 'UsageSnapshot',
+            fieldName: 'createUsageSnapshot',
+            document,
+            variables,
+        });
+    }
+    update(args) {
+        const { document, variables } = (0, query_builder_1.buildUpdateByPkDocument)('UsageSnapshot', 'updateUsageSnapshot', 'usageSnapshot', args.select, args.where.id, args.data, 'UpdateUsageSnapshotInput', 'id', 'usageSnapshotPatch', input_types_1.connectionFieldsMap);
+        return new query_builder_1.QueryBuilder({
+            client: this.client,
+            operation: 'mutation',
+            operationName: 'UsageSnapshot',
+            fieldName: 'updateUsageSnapshot',
+            document,
+            variables,
+        });
+    }
+    delete(args) {
+        const { document, variables } = (0, query_builder_1.buildDeleteByPkDocument)('UsageSnapshot', 'deleteUsageSnapshot', 'usageSnapshot', {
+            id: args.where.id,
+        }, 'DeleteUsageSnapshotInput', args.select, input_types_1.connectionFieldsMap);
+        return new query_builder_1.QueryBuilder({
+            client: this.client,
+            operation: 'mutation',
+            operationName: 'UsageSnapshot',
+            fieldName: 'deleteUsageSnapshot',
+            document,
+            variables,
+        });
+    }
+}
+exports.UsageSnapshotModel = UsageSnapshotModel;

package/esm/admin/orm/index.d.ts

@@ -35,6 +35,7 @@ import { AppLimitEventModel } from './models/appLimitEvent';
 import { OrgLimitEventModel } from './models/orgLimitEvent';
 import { OrgGrantModel } from './models/orgGrant';
 import { OrgChartEdgeModel } from './models/orgChartEdge';
+import { UsageSnapshotModel } from './models/usageSnapshot';
 import { OrgMemberProfileModel } from './models/orgMemberProfile';
 import { AppLevelModel } from './models/appLevel';
 import { AppLimitModel } from './models/appLimit';
@@ -112,6 +113,7 @@ export declare function createClient(config: OrmClientConfig): {
     orgLimitEvent: OrgLimitEventModel;
     orgGrant: OrgGrantModel;
     orgChartEdge: OrgChartEdgeModel;
+    usageSnapshot: UsageSnapshotModel;
     orgMemberProfile: OrgMemberProfileModel;
     appLevel: AppLevelModel;
     appLimit: AppLimitModel;

package/esm/admin/orm/index.js

@@ -40,6 +40,7 @@ import { AppLimitEventModel } from './models/appLimitEvent';
 import { OrgLimitEventModel } from './models/orgLimitEvent';
 import { OrgGrantModel } from './models/orgGrant';
 import { OrgChartEdgeModel } from './models/orgChartEdge';
+import { UsageSnapshotModel } from './models/usageSnapshot';
 import { OrgMemberProfileModel } from './models/orgMemberProfile';
 import { AppLevelModel } from './models/appLevel';
 import { AppLimitModel } from './models/appLimit';
@@ -120,6 +121,7 @@ export function createClient(config) {
         orgLimitEvent: new OrgLimitEventModel(client),
         orgGrant: new OrgGrantModel(client),
         orgChartEdge: new OrgChartEdgeModel(client),
+        usageSnapshot: new UsageSnapshotModel(client),
         orgMemberProfile: new OrgMemberProfileModel(client),
         appLevel: new AppLevelModel(client),
         appLimit: new AppLimitModel(client),

package/esm/admin/orm/input-types.d.ts

@@ -661,6 +661,20 @@ export interface OrgChartEdge {
     /** Numeric seniority level for this position (higher = more senior) */
     positionLevel?: number | null;
 }
+/** Periodic snapshot of a single metric for a database. Collected by the snapshot_usage() cron job in constructive-limits. Each row records one metric measurement (e.g. reads, writes, storage_bytes) at a point in time, with optional dimensions for sub-metric breakdowns. */
+export interface UsageSnapshot {
+    /** The database this snapshot belongs to. References metaschema_public.database.id but declared without an FK constraint — the snapshot collector runs in a platform context where the FK would add overhead without value. */
+    databaseId?: string | null;
+    /** Identifier for the metric being measured (e.g. 'reads', 'writes', 'storage_bytes', 'compute_time_ms'). */
+    metricName?: string | null;
+    /** The measured value at the time of capture. Interpretation depends on metric_name (count, bytes, milliseconds, etc.). */
+    metricValue?: string | null;
+    /** Optional sub-metric breakdowns as key-value pairs (e.g. {"query_type": "select"} for reads). Empty object when no breakdown is needed. */
+    dimensions?: Record<string, unknown> | null;
+    /** When this snapshot was taken. Defaults to the current timestamp; the snapshot collector may override this for backdated imports. */
+    capturedAt?: string | null;
+    id: string;
+}
 /** Per-membership profile information visible to other entity members (display name, email, title, bio, avatar) */
 export interface OrgMemberProfile {
     id: string;
@@ -1008,6 +1022,8 @@ export interface OrgGrantRelations {
 }
 export interface OrgChartEdgeRelations {
 }
+export interface UsageSnapshotRelations {
+}
 export interface OrgMemberProfileRelations {
     membership?: OrgMembership | null;
 }
@@ -1066,6 +1082,7 @@ export type AppLimitEventWithRelations = AppLimitEvent & AppLimitEventRelations;
 export type OrgLimitEventWithRelations = OrgLimitEvent & OrgLimitEventRelations;
 export type OrgGrantWithRelations = OrgGrant & OrgGrantRelations;
 export type OrgChartEdgeWithRelations = OrgChartEdge & OrgChartEdgeRelations;
+export type UsageSnapshotWithRelations = UsageSnapshot & UsageSnapshotRelations;
 export type OrgMemberProfileWithRelations = OrgMemberProfile & OrgMemberProfileRelations;
 export type AppLevelWithRelations = AppLevel & AppLevelRelations;
 export type AppLimitWithRelations = AppLimit & AppLimitRelations;
@@ -1393,6 +1410,14 @@ export type OrgChartEdgeSelect = {
     positionTitle?: boolean;
     positionLevel?: boolean;
 };
+export type UsageSnapshotSelect = {
+    databaseId?: boolean;
+    metricName?: boolean;
+    metricValue?: boolean;
+    dimensions?: boolean;
+    capturedAt?: boolean;
+    id?: boolean;
+};
 export type OrgMemberProfileSelect = {
     id?: boolean;
     createdAt?: boolean;
@@ -2252,6 +2277,26 @@ export interface OrgChartEdgeFilter {
     /** Negates the expression. */
     not?: OrgChartEdgeFilter;
 }
+export interface UsageSnapshotFilter {
+    /** Filter by the object’s `databaseId` field. */
+    databaseId?: UUIDFilter;
+    /** Filter by the object’s `metricName` field. */
+    metricName?: StringFilter;
+    /** Filter by the object’s `metricValue` field. */
+    metricValue?: BigIntFilter;
+    /** Filter by the object’s `dimensions` field. */
+    dimensions?: JSONFilter;
+    /** Filter by the object’s `capturedAt` field. */
+    capturedAt?: DatetimeFilter;
+    /** Filter by the object’s `id` field. */
+    id?: UUIDFilter;
+    /** Checks for all expressions in this list. */
+    and?: UsageSnapshotFilter[];
+    /** Checks for any expressions in this list. */
+    or?: UsageSnapshotFilter[];
+    /** Negates the expression. */
+    not?: UsageSnapshotFilter;
+}
 export interface OrgMemberProfileFilter {
     /** Filter by the object’s `id` field. */
     id?: UUIDFilter;
@@ -2628,6 +2673,7 @@ export type AppLimitEventOrderBy = 'NATURAL' | 'NAME_ASC' | 'NAME_DESC' | 'ACTOR
 export type OrgLimitEventOrderBy = 'NATURAL' | 'NAME_ASC' | 'NAME_DESC' | 'ACTOR_ID_ASC' | 'ACTOR_ID_DESC' | 'ENTITY_ID_ASC' | 'ENTITY_ID_DESC' | 'EVENT_TYPE_ASC' | 'EVENT_TYPE_DESC' | 'DELTA_ASC' | 'DELTA_DESC' | 'NUM_BEFORE_ASC' | 'NUM_BEFORE_DESC' | 'NUM_AFTER_ASC' | 'NUM_AFTER_DESC' | 'MAX_AT_EVENT_ASC' | 'MAX_AT_EVENT_DESC' | 'REASON_ASC' | 'REASON_DESC';
 export type OrgGrantOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'ID_ASC' | 'ID_DESC' | 'PERMISSIONS_ASC' | 'PERMISSIONS_DESC' | 'IS_GRANT_ASC' | 'IS_GRANT_DESC' | 'ACTOR_ID_ASC' | 'ACTOR_ID_DESC' | 'ENTITY_ID_ASC' | 'ENTITY_ID_DESC' | 'GRANTOR_ID_ASC' | 'GRANTOR_ID_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'UPDATED_AT_ASC' | 'UPDATED_AT_DESC';
 export type OrgChartEdgeOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'ID_ASC' | 'ID_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'UPDATED_AT_ASC' | 'UPDATED_AT_DESC' | 'ENTITY_ID_ASC' | 'ENTITY_ID_DESC' | 'CHILD_ID_ASC' | 'CHILD_ID_DESC' | 'PARENT_ID_ASC' | 'PARENT_ID_DESC' | 'POSITION_TITLE_ASC' | 'POSITION_TITLE_DESC' | 'POSITION_LEVEL_ASC' | 'POSITION_LEVEL_DESC';
+export type UsageSnapshotOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'DATABASE_ID_ASC' | 'DATABASE_ID_DESC' | 'METRIC_NAME_ASC' | 'METRIC_NAME_DESC' | 'METRIC_VALUE_ASC' | 'METRIC_VALUE_DESC' | 'DIMENSIONS_ASC' | 'DIMENSIONS_DESC' | 'CAPTURED_AT_ASC' | 'CAPTURED_AT_DESC' | 'ID_ASC' | 'ID_DESC';
 export type OrgMemberProfileOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'ID_ASC' | 'ID_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'UPDATED_AT_ASC' | 'UPDATED_AT_DESC' | 'MEMBERSHIP_ID_ASC' | 'MEMBERSHIP_ID_DESC' | 'ENTITY_ID_ASC' | 'ENTITY_ID_DESC' | 'ACTOR_ID_ASC' | 'ACTOR_ID_DESC' | 'DISPLAY_NAME_ASC' | 'DISPLAY_NAME_DESC' | 'EMAIL_ASC' | 'EMAIL_DESC' | 'TITLE_ASC' | 'TITLE_DESC' | 'BIO_ASC' | 'BIO_DESC' | 'PROFILE_PICTURE_ASC' | 'PROFILE_PICTURE_DESC';
 export type AppLevelOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'ID_ASC' | 'ID_DESC' | 'NAME_ASC' | 'NAME_DESC' | 'DESCRIPTION_ASC' | 'DESCRIPTION_DESC' | 'IMAGE_ASC' | 'IMAGE_DESC' | 'OWNER_ID_ASC' | 'OWNER_ID_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'UPDATED_AT_ASC' | 'UPDATED_AT_DESC';
 export type AppLimitOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'ID_ASC' | 'ID_DESC' | 'NAME_ASC' | 'NAME_DESC' | 'ACTOR_ID_ASC' | 'ACTOR_ID_DESC' | 'NUM_ASC' | 'NUM_DESC' | 'MAX_ASC' | 'MAX_DESC' | 'SOFT_MAX_ASC' | 'SOFT_MAX_DESC' | 'WINDOW_START_ASC' | 'WINDOW_START_DESC' | 'WINDOW_DURATION_ASC' | 'WINDOW_DURATION_DESC' | 'PLAN_MAX_ASC' | 'PLAN_MAX_DESC' | 'PURCHASED_CREDITS_ASC' | 'PURCHASED_CREDITS_DESC' | 'PERIOD_CREDITS_ASC' | 'PERIOD_CREDITS_DESC';
@@ -3492,6 +3538,32 @@ export interface DeleteOrgChartEdgeInput {
     clientMutationId?: string;
     id: string;
 }
+export interface CreateUsageSnapshotInput {
+    clientMutationId?: string;
+    usageSnapshot: {
+        databaseId: string;
+        metricName: string;
+        metricValue?: string;
+        dimensions?: Record<string, unknown>;
+        capturedAt?: string;
+    };
+}
+export interface UsageSnapshotPatch {
+    databaseId?: string | null;
+    metricName?: string | null;
+    metricValue?: string | null;
+    dimensions?: Record<string, unknown> | null;
+    capturedAt?: string | null;
+}
+export interface UpdateUsageSnapshotInput {
+    clientMutationId?: string;
+    id: string;
+    usageSnapshotPatch: UsageSnapshotPatch;
+}
+export interface DeleteUsageSnapshotInput {
+    clientMutationId?: string;
+    id: string;
+}
 export interface CreateOrgMemberProfileInput {
     clientMutationId?: string;
     orgMemberProfile: {
@@ -5978,6 +6050,51 @@ export type DeleteOrgChartEdgePayloadSelect = {
         select: OrgChartEdgeEdgeSelect;
     };
 };
+export interface CreateUsageSnapshotPayload {
+    clientMutationId?: string | null;
+    /** The `UsageSnapshot` that was created by this mutation. */
+    usageSnapshot?: UsageSnapshot | null;
+    usageSnapshotEdge?: UsageSnapshotEdge | null;
+}
+export type CreateUsageSnapshotPayloadSelect = {
+    clientMutationId?: boolean;
+    usageSnapshot?: {
+        select: UsageSnapshotSelect;
+    };
+    usageSnapshotEdge?: {
+        select: UsageSnapshotEdgeSelect;
+    };
+};
+export interface UpdateUsageSnapshotPayload {
+    clientMutationId?: string | null;
+    /** The `UsageSnapshot` that was updated by this mutation. */
+    usageSnapshot?: UsageSnapshot | null;
+    usageSnapshotEdge?: UsageSnapshotEdge | null;
+}
+export type UpdateUsageSnapshotPayloadSelect = {
+    clientMutationId?: boolean;
+    usageSnapshot?: {
+        select: UsageSnapshotSelect;
+    };
+    usageSnapshotEdge?: {
+        select: UsageSnapshotEdgeSelect;
+    };
+};
+export interface DeleteUsageSnapshotPayload {
+    clientMutationId?: string | null;
+    /** The `UsageSnapshot` that was deleted by this mutation. */
+    usageSnapshot?: UsageSnapshot | null;
+    usageSnapshotEdge?: UsageSnapshotEdge | null;
+}
+export type DeleteUsageSnapshotPayloadSelect = {
+    clientMutationId?: boolean;
+    usageSnapshot?: {
+        select: UsageSnapshotSelect;
+    };
+    usageSnapshotEdge?: {
+        select: UsageSnapshotEdgeSelect;
+    };
+};
 export interface CreateOrgMemberProfilePayload {
     clientMutationId?: string | null;
     /** The `OrgMemberProfile` that was created by this mutation. */
@@ -6829,6 +6946,18 @@ export type OrgChartEdgeEdgeSelect = {
         select: OrgChartEdgeSelect;
     };
 };
+/** A `UsageSnapshot` edge in the connection. */
+export interface UsageSnapshotEdge {
+    cursor?: string | null;
+    /** The `UsageSnapshot` at the end of the edge. */
+    node?: UsageSnapshot | null;
+}
+export type UsageSnapshotEdgeSelect = {
+    cursor?: boolean;
+    node?: {
+        select: UsageSnapshotSelect;
+    };
+};
 /** A `OrgMemberProfile` edge in the connection. */
 export interface OrgMemberProfileEdge {
     cursor?: string | null;

package/esm/admin/orm/models/index.d.ts

@@ -39,6 +39,7 @@ export { AppLimitEventModel } from './appLimitEvent';
 export { OrgLimitEventModel } from './orgLimitEvent';
 export { OrgGrantModel } from './orgGrant';
 export { OrgChartEdgeModel } from './orgChartEdge';
+export { UsageSnapshotModel } from './usageSnapshot';
 export { OrgMemberProfileModel } from './orgMemberProfile';
 export { AppLevelModel } from './appLevel';
 export { AppLimitModel } from './appLimit';

package/esm/admin/orm/models/index.js

@@ -39,6 +39,7 @@ export { AppLimitEventModel } from './appLimitEvent';
 export { OrgLimitEventModel } from './orgLimitEvent';
 export { OrgGrantModel } from './orgGrant';
 export { OrgChartEdgeModel } from './orgChartEdge';
+export { UsageSnapshotModel } from './usageSnapshot';
 export { OrgMemberProfileModel } from './orgMemberProfile';
 export { AppLevelModel } from './appLevel';
 export { AppLimitModel } from './appLimit';