@graphoria/server 0.4.0 → 0.5.0

package/dist/src/databases/engines/mysql/getStructure.d.ts

@@ -25,6 +25,11 @@ export declare const getDatabaseStructure: (db: Database) => Promise<{
                 target?: string | undefined;
                 operator: "eq" | "gt" | "gte" | "is_not_null" | "is_null" | "like" | "lt" | "lte" | "neq";
                 value?: string | number | boolean | undefined;
+                ancestor?: {
+                    schema: string;
+                    name: string;
+                    column: string;
+                } | undefined;
             }[] | undefined;
             dashedName: string;
         }[];

package/dist/src/databases/engines/mysql/getStructure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getStructure.d.ts","sourceRoot":"","sources":["../../../../../src/databases/engines/mysql/getStructure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAoB7D,eAAO,MAAM,oBAAoB,OAAc,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+HtD,CAAC"}
+{"version":3,"file":"getStructure.d.ts","sourceRoot":"","sources":["../../../../../src/databases/engines/mysql/getStructure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAoB7D,eAAO,MAAM,oBAAoB,OAAc,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+HtD,CAAC"}

package/dist/src/databases/engines/mysql/query/index.d.ts

@@ -1,8 +1,8 @@
 import type { OperationAnalysis, SelectionAnalysis, VariableDefinition } from "../../../../analyzeQuery/types";
 import type { MergedEntities } from "../../../../configuration/getSchemas/mergeEntities";
-import type { PageLimits } from "../../../common";
+import type { PageLimits, QueryPathFrame } from "../../../common";
 export declare const generateSQL: (entities: MergedEntities, operation: OperationAnalysis, variables?: Record<string, unknown>, forHashMethod?: boolean, pageLimits?: PageLimits | null, timeoutMs?: number) => string;
 export declare const buildSQLForField: (entities: MergedEntities, variablesDefinition: VariableDefinition[], variables: Record<string, unknown> | undefined, field: SelectionAnalysis, parentTableName: string | null, parentTableAlias: string | null, level: number, aliasMap: {
     [alias: string]: string;
-}, pageLimits: PageLimits | null) => string;
+}, pageLimits: PageLimits | null, ancestors?: readonly QueryPathFrame[]) => string;
 //# sourceMappingURL=index.d.ts.map

package/dist/src/databases/engines/mysql/query/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/databases/engines/mysql/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AACzF,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAqJ/D,eAAO,MAAM,WAAW,aACZ,cAAc,aACb,iBAAiB,cACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,kBACnB,OAAO,eACV,UAAU,GAAG,IAAI,cACjB,MAAM,KACjB,MAqFF,CAAC;AAEF,eAAO,MAAM,gBAAgB,aACjB,cAAc,uBACH,kBAAkB,EAAE,aAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,qBAC3B,iBAAiB,mBACP,MAAM,GAAG,IAAI,oBACZ,MAAM,GAAG,IAAI,SACxB,MAAM,YACH;IAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,cACzB,UAAU,GAAG,IAAI,KAC5B,MA+GF,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/databases/engines/mysql/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AACzF,OAAO,KAAK,EAAe,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAqJ/E,eAAO,MAAM,WAAW,aACZ,cAAc,aACb,iBAAiB,cACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,kBACnB,OAAO,eACV,UAAU,GAAG,IAAI,cACjB,MAAM,KACjB,MAqFF,CAAC;AAEF,eAAO,MAAM,gBAAgB,aACjB,cAAc,uBACH,kBAAkB,EAAE,aAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,qBAC3B,iBAAiB,mBACP,MAAM,GAAG,IAAI,oBACZ,MAAM,GAAG,IAAI,SACxB,MAAM,YACH;IAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,cACzB,UAAU,GAAG,IAAI,cAClB,SAAS,cAAc,EAAE,KACnC,MAiHF,CAAC"}

package/dist/src/databases/engines/postgresql/getStructure.d.ts

@@ -25,6 +25,11 @@ export declare const getDatabaseStructure: (db: Database) => Promise<{
                 target?: string | undefined;
                 operator: "eq" | "gt" | "gte" | "is_not_null" | "is_null" | "like" | "lt" | "lte" | "neq";
                 value?: string | number | boolean | undefined;
+                ancestor?: {
+                    schema: string;
+                    name: string;
+                    column: string;
+                } | undefined;
             }[] | undefined;
             dashedName: string;
         }[];

package/dist/src/databases/engines/postgresql/getStructure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getStructure.d.ts","sourceRoot":"","sources":["../../../../../src/databases/engines/postgresql/getStructure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAK7D,eAAO,MAAM,oBAAoB,OAAc,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgJtD,CAAC"}
+{"version":3,"file":"getStructure.d.ts","sourceRoot":"","sources":["../../../../../src/databases/engines/postgresql/getStructure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAK7D,eAAO,MAAM,oBAAoB,OAAc,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgJtD,CAAC"}

package/dist/src/databases/engines/postgresql/query/index.d.ts

@@ -1,8 +1,8 @@
 import type { OperationAnalysis, SelectionAnalysis, VariableDefinition } from "../../../../analyzeQuery/types";
 import type { MergedEntities } from "../../../../configuration/getSchemas/mergeEntities";
-import type { PageLimits } from "../../../common";
+import type { PageLimits, QueryPathFrame } from "../../../common";
 export declare const generateSQL: (entities: MergedEntities, operation: OperationAnalysis, variables?: Record<string, unknown>, forHashMethod?: boolean, pageLimits?: PageLimits | null) => string;
 export declare const buildSQLForField: (entities: MergedEntities, variablesDefinition: VariableDefinition[], variables: Record<string, unknown> | undefined, field: SelectionAnalysis, parentTableName: string | null, parentTableAlias: string | null, level: number, aliasMap: {
     [alias: string]: string;
-}, pageLimits: PageLimits | null) => string;
+}, pageLimits: PageLimits | null, ancestors?: readonly QueryPathFrame[]) => string;
 //# sourceMappingURL=index.d.ts.map

package/dist/src/databases/engines/postgresql/query/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/databases/engines/postgresql/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AACzF,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAiJ/D,eAAO,MAAM,WAAW,aACZ,cAAc,aACb,iBAAiB,cACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,kBACnB,OAAO,eACV,UAAU,GAAG,IAAI,KAC5B,MA2EF,CAAC;AAEF,eAAO,MAAM,gBAAgB,aACjB,cAAc,uBACH,kBAAkB,EAAE,aAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,qBAC3B,iBAAiB,mBACP,MAAM,GAAG,IAAI,oBACZ,MAAM,GAAG,IAAI,SACxB,MAAM,YACH;IAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,cACzB,UAAU,GAAG,IAAI,KAC5B,MAwGF,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/databases/engines/postgresql/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AACzF,OAAO,KAAK,EAAe,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAiJ/E,eAAO,MAAM,WAAW,aACZ,cAAc,aACb,iBAAiB,cACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,kBACnB,OAAO,eACV,UAAU,GAAG,IAAI,KAC5B,MA2EF,CAAC;AAEF,eAAO,MAAM,gBAAgB,aACjB,cAAc,uBACH,kBAAkB,EAAE,aAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,qBAC3B,iBAAiB,mBACP,MAAM,GAAG,IAAI,oBACZ,MAAM,GAAG,IAAI,SACxB,MAAM,YACH;IAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,cACzB,UAAU,GAAG,IAAI,cAClB,SAAS,cAAc,EAAE,KACnC,MA0GF,CAAC"}

package/dist/src/databases/high-level-operations.d.ts

@@ -47,6 +47,11 @@ export declare const getDatabasesStructure: (databases: Database[], auth?: Auth,
                             target?: string | undefined;
                             operator: "eq" | "gt" | "gte" | "is_not_null" | "is_null" | "like" | "lt" | "lte" | "neq";
                             value?: string | number | boolean | undefined;
+                            ancestor?: {
+                                schema: string;
+                                name: string;
+                                column: string;
+                            } | undefined;
                         }[] | undefined;
                     }[];
                     description?: string | undefined;

package/dist/src/databases/high-level-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"high-level-operations.d.ts","sourceRoot":"","sources":["../../../src/databases/high-level-operations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EACV,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,WAAW,EAGZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,iBAAiB,EAAe,aAAa,EAAU,MAAM,aAAa,CAAC;AAEzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAI5D;;GAEG;AAEH,eAAO,MAAM,qBAAqB,cACrB,QAAQ,EAAE,SACd,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2IZ,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,gBAAgB,EAAE,iBAAiB,EAAE,CAAC;IACtC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,EAAE,oBAAoB,EAAE,CAAC;IACtC,UAAU,EAAE,kBAAkB,EAAE,CAAC;CAClC,CAAC;AAmCF,eAAO,MAAM,kBAAkB,WACrB,aAAa,EAAE,oBACL,iBAAiB,EAAE,UAC7B,YAAY,EAAE,cACV,UAAU,uBACF,WAAW,kBAChB,oBAAoB,EAAE,eACzB,kBAAkB,EAAE,mCA4F/B,CAAC"}
+{"version":3,"file":"high-level-operations.d.ts","sourceRoot":"","sources":["../../../src/databases/high-level-operations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EACV,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,WAAW,EAGZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,iBAAiB,EAAe,aAAa,EAAU,MAAM,aAAa,CAAC;AAEzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAI5D;;GAEG;AAEH,eAAO,MAAM,qBAAqB,cACrB,QAAQ,EAAE,SACd,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqLZ,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,gBAAgB,EAAE,iBAAiB,EAAE,CAAC;IACtC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,EAAE,oBAAoB,EAAE,CAAC;IACtC,UAAU,EAAE,kBAAkB,EAAE,CAAC;CAClC,CAAC;AAmCF,eAAO,MAAM,kBAAkB,WACrB,aAAa,EAAE,oBACL,iBAAiB,EAAE,UAC7B,YAAY,EAAE,cACV,UAAU,uBACF,WAAW,kBAChB,oBAAoB,EAAE,eACzB,kBAAkB,EAAE,mCA4F/B,CAAC"}

package/dist/src/databases/metadata/structure.d.ts

@@ -28,6 +28,11 @@ export declare const getDatabaseStructure: (db: Database) => Promise<{
                 target?: string | undefined;
                 operator: "eq" | "gt" | "gte" | "is_not_null" | "is_null" | "like" | "lt" | "lte" | "neq";
                 value?: string | number | boolean | undefined;
+                ancestor?: {
+                    schema: string;
+                    name: string;
+                    column: string;
+                } | undefined;
             }[] | undefined;
             dashedName: string;
         }[];

package/dist/src/databases/metadata/structure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../../../src/databases/metadata/structure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAI1D;;GAEG;AAEH,eAAO,MAAM,oBAAoB,OAAc,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EACH,CAAC;AAErD,eAAO,MAAM,cAAc,OAAc,QAAQ;;;;IAA2C,CAAC"}
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../../../src/databases/metadata/structure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAI1D;;GAEG;AAEH,eAAO,MAAM,oBAAoB,OAAc,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EACH,CAAC;AAErD,eAAO,MAAM,cAAc,OAAc,QAAQ;;;;IAA2C,CAAC"}

package/dist/src/databases/transformers/data-transformers.d.ts

@@ -15,6 +15,11 @@ export declare const buildRelationshipResolver: (table: Table, foreignKey: Relat
         target?: string | undefined;
         operator: "eq" | "gt" | "gte" | "is_not_null" | "is_null" | "like" | "lt" | "lte" | "neq";
         value?: string | number | boolean | undefined;
+        ancestor?: {
+            schema: string;
+            name: string;
+            column: string;
+        } | undefined;
     }[] | undefined;
     internalName: string;
     fromInternalName: string;
@@ -61,6 +66,11 @@ export declare const buildTableResolver: (tables: Tables, table: Table, db: Data
                         target?: string | undefined;
                         operator: "eq" | "gt" | "gte" | "is_not_null" | "is_null" | "like" | "lt" | "lte" | "neq";
                         value?: string | number | boolean | undefined;
+                        ancestor?: {
+                            schema: string;
+                            name: string;
+                            column: string;
+                        } | undefined;
                     }[] | undefined;
                 }[];
                 description?: string | undefined;
@@ -107,6 +117,11 @@ export declare const buildTableResolver: (tables: Tables, table: Table, db: Data
             target?: string | undefined;
             operator: "eq" | "gt" | "gte" | "is_not_null" | "is_null" | "like" | "lt" | "lte" | "neq";
             value?: string | number | boolean | undefined;
+            ancestor?: {
+                schema: string;
+                name: string;
+                column: string;
+            } | undefined;
         }[] | undefined;
         internalName: string;
         fromInternalName: string;
@@ -126,6 +141,11 @@ export declare const buildTableResolver: (tables: Tables, table: Table, db: Data
             target?: string | undefined;
             operator: "eq" | "gt" | "gte" | "is_not_null" | "is_null" | "like" | "lt" | "lte" | "neq";
             value?: string | number | boolean | undefined;
+            ancestor?: {
+                schema: string;
+                name: string;
+                column: string;
+            } | undefined;
         }[] | undefined;
         internalName: string;
         fromInternalName: string;
@@ -157,6 +177,11 @@ export declare const buildTableResolver: (tables: Tables, table: Table, db: Data
             target?: string | undefined;
             operator: "eq" | "gt" | "gte" | "is_not_null" | "is_null" | "like" | "lt" | "lte" | "neq";
             value?: string | number | boolean | undefined;
+            ancestor?: {
+                schema: string;
+                name: string;
+                column: string;
+            } | undefined;
         }[] | undefined;
         dashedName: string;
     }[];
@@ -204,6 +229,11 @@ export declare const buildProcedureResolver: (sp: StoredProcedure, db: Database)
                         target?: string | undefined;
                         operator: "eq" | "gt" | "gte" | "is_not_null" | "is_null" | "like" | "lt" | "lte" | "neq";
                         value?: string | number | boolean | undefined;
+                        ancestor?: {
+                            schema: string;
+                            name: string;
+                            column: string;
+                        } | undefined;
                     }[] | undefined;
                 }[];
                 description?: string | undefined;

package/dist/src/databases/transformers/data-transformers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-transformers.d.ts","sourceRoot":"","sources":["../../../../src/databases/transformers/data-transformers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAwB,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAK3F;;GAEG;AAEH,eAAO,MAAM,yBAAyB,UAC7B,KAAK,cACA,aAAa,CAAC,MAAM,CAAC,MAC7B,QAAQ;;;;;;;;;;;;;;;;;;CAiEb,CAAC;AAEF,eAAO,MAAM,kBAAkB,WAAY,MAAM,SAAS,KAAK,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgC5E,CAAC;AAEF,eAAO,MAAM,sBAAsB,OAAQ,eAAe,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBvE,CAAC"}
+{"version":3,"file":"data-transformers.d.ts","sourceRoot":"","sources":["../../../../src/databases/transformers/data-transformers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAwB,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAK3F;;GAEG;AAEH,eAAO,MAAM,yBAAyB,UAC7B,KAAK,cACA,aAAa,CAAC,MAAM,CAAC,MAC7B,QAAQ;;;;;;;;;;;;;;;;;;;;;;;CAiEb,CAAC;AAEF,eAAO,MAAM,kBAAkB,WAAY,MAAM,SAAS,KAAK,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgC5E,CAAC;AAEF,eAAO,MAAM,sBAAsB,OAAQ,eAAe,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBvE,CAAC"}

package/dist/src/index.d.ts

@@ -85,6 +85,8 @@ export declare function createHandlers(options?: Partial<Env>): Promise<{
         rest: string;
         openapi: string;
         console: string;
+        health: string;
+        metrics: string;
     };
     logger: typeof logger;
     execute: (query: string, variables?: Record<string, unknown>, opts?: import("./configuration/gql/buildExecute").ExecuteOptions) => Promise<{
@@ -126,6 +128,8 @@ export declare function createBunServer(options?: Partial<Env>): Promise<{
         rest: string;
         openapi: string;
         console: string;
+        health: string;
+        metrics: string;
     };
     logger: typeof logger;
     execute: (query: string, variables?: Record<string, unknown>, opts?: import("./configuration/gql/buildExecute").ExecuteOptions) => Promise<{

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAGtC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAcvC,OAAO,EAAE,mBAAmB,EAAmC,MAAM,wBAAwB,CAAC;AAc9F,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAIrD,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAE5B,KAAK,YAAY,GACb,QAAQ,GACR,CAAC,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC;AAEjG,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;AAqF7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,mBAAmB,aAAoB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;EAc/D,CAAC;AA0TF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,cAAc,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;GAoB1D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,eAAe,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;GAW3D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAGtC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAcvC,OAAO,EAEL,mBAAmB,EAGpB,MAAM,wBAAwB,CAAC;AAehC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAUrD,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAE5B,KAAK,YAAY,GACb,QAAQ,GACR,CAAC,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC;AAEjG,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;AAqG7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,mBAAmB,aAAoB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;EAc/D,CAAC;AAmXF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,cAAc,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;GAoB1D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,eAAe,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;GAW3D"}

package/dist/src/logging/slowQuery.d.ts

@@ -0,0 +1,29 @@
+import type { Logger } from "pino";
+/** The GraphQL operation a statement was generated for. Names only, never values. */
+export type QuerySource = {
+    operation: {
+        type: "query" | "mutation" | "subscription";
+        name: string | null;
+        fields: string[];
+    };
+    role?: string | undefined;
+};
+export type SlowQueryRecord = {
+    durationMs: number;
+    dbType: string;
+    dbName: string;
+    sql?: string;
+    procedure?: string;
+    outcome: "success" | "error";
+} & Partial<QuerySource>;
+export type SlowQueryLog = {
+    emit(record: SlowQueryRecord & {
+        thresholdMs: number;
+    }): void;
+};
+export declare const setSlowQueryMs: (ms: number) => void;
+export declare const createSlowQueryLog: (base: Logger) => SlowQueryLog;
+/** Test seam: pass `null` to restore the default log. */
+export declare const setSlowQueryLog: (log: SlowQueryLog | null) => void;
+export declare const reportQueryDuration: (record: SlowQueryRecord) => void;
+//# sourceMappingURL=slowQuery.d.ts.map

package/dist/src/logging/slowQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slowQuery.d.ts","sourceRoot":"","sources":["../../../src/logging/slowQuery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAInC,qFAAqF;AACrF,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE;QACT,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;QAC5C,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC;CAC9B,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AAEzB,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC/D,CAAC;AAQF,eAAO,MAAM,cAAc,OAAQ,MAAM,KAAG,IAE3C,CAAC;AAEF,eAAO,MAAM,kBAAkB,SAAU,MAAM,KAAG,YAEhD,CAAC;AAKH,yDAAyD;AACzD,eAAO,MAAM,eAAe,QAAS,YAAY,GAAG,IAAI,KAAG,IAE1D,CAAC;AAQF,eAAO,MAAM,mBAAmB,WAAY,eAAe,KAAG,IAG7D,CAAC"}

package/dist/src/logging/slowQuery.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=slowQuery.test.d.ts.map

package/dist/src/logging/slowQuery.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slowQuery.test.d.ts","sourceRoot":"","sources":["../../../src/logging/slowQuery.test.ts"],"names":[],"mappings":""}

package/dist/src/observability/health.d.ts

@@ -0,0 +1,23 @@
+import { S200, S503 } from "../utils/responses";
+export type HealthCheck = {
+    kind: string;
+    name?: string;
+    probe: () => Promise<boolean> | boolean;
+};
+export type HealthRoutesOptions = {
+    basePath: string;
+    /** Read on every readiness request, so a check can follow state that changes after boot. */
+    checks: () => HealthCheck[];
+    timeoutMs: number;
+};
+/**
+ * Unauthenticated probes for an orchestrator. Liveness touches nothing, so a
+ * dependency outage never gets the process restarted; readiness pings every
+ * dependency and answers 503 while one is down. The body names each check and
+ * whether it passed — the reason stays in the log, because a driver error can
+ * carry a host and port.
+ */
+export declare const createHealthRoutes: ({ basePath, checks, timeoutMs }: HealthRoutesOptions) => {
+    [x: string]: (() => S200) | (() => Promise<S200 | S503>);
+};
+//# sourceMappingURL=health.d.ts.map

package/dist/src/observability/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/observability/health.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,4FAA4F;IAC5F,MAAM,EAAE,MAAM,WAAW,EAAE,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAgBF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,oCAAqC,mBAAmB;;CA6BtF,CAAC"}

package/dist/src/observability/health.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=health.test.d.ts.map

package/dist/src/observability/health.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.test.d.ts","sourceRoot":"","sources":["../../../src/observability/health.test.ts"],"names":[],"mappings":""}

package/dist/src/observability/httpMetrics.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Wraps a route handler so the request is counted and timed. The route label is
+ * the name of the mounted route, never the URL: a path carries identifiers, and
+ * one series per identifier is a cardinality leak.
+ */
+export declare const withHttpMetrics: <Req extends Request, Args extends unknown[]>(route: string, handler: (req: Req, ...args: Args) => Response | undefined | Promise<Response | undefined>) => (req: Req, ...args: Args) => Promise<Response | undefined>;
+//# sourceMappingURL=httpMetrics.d.ts.map

package/dist/src/observability/httpMetrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpMetrics.d.ts","sourceRoot":"","sources":["../../../src/observability/httpMetrics.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,eAAe,GACzB,GAAG,SAAS,OAAO,EAAE,IAAI,SAAS,OAAO,EAAE,SACnC,MAAM,WACJ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,WAEhF,GAAG,WAAW,IAAI,KAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAwB5D,CAAC"}

package/dist/src/observability/httpMetrics.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=httpMetrics.test.d.ts.map

package/dist/src/observability/httpMetrics.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpMetrics.test.d.ts","sourceRoot":"","sources":["../../../src/observability/httpMetrics.test.ts"],"names":[],"mappings":""}

package/dist/src/observability/httpTracing.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Wraps a route handler so the request roots a trace. The span is named for the
+ * mounted route, never the URL: a path carries identifiers and a query string
+ * carries caller data, and a span name is exported verbatim.
+ *
+ * An inbound `traceparent` is continued, so a gateway's span and this one join
+ * up. `parent: null` is deliberate — a request is a root, never a child of
+ * whatever context the server happened to be in.
+ */
+export declare const withHttpTracing: <Req extends Request, Args extends unknown[]>(route: string, handler: (req: Req, ...args: Args) => Response | undefined | Promise<Response | undefined>) => (req: Req, ...args: Args) => Promise<Response | undefined>;
+//# sourceMappingURL=httpTracing.d.ts.map

package/dist/src/observability/httpTracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpTracing.d.ts","sourceRoot":"","sources":["../../../src/observability/httpTracing.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GACzB,GAAG,SAAS,OAAO,EAAE,IAAI,SAAS,OAAO,EAAE,SACnC,MAAM,WACJ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,WAEhF,GAAG,WAAW,IAAI,KAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CA+B5D,CAAC"}

package/dist/src/observability/httpTracing.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=httpTracing.test.d.ts.map

package/dist/src/observability/httpTracing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpTracing.test.d.ts","sourceRoot":"","sources":["../../../src/observability/httpTracing.test.ts"],"names":[],"mappings":""}

package/dist/src/observability/metrics.d.ts

@@ -0,0 +1,81 @@
+declare const METRICS: {
+    readonly graphoria_graphql_operations_total: {
+        readonly type: "counter";
+        readonly help: "GraphQL operations executed, by outcome.";
+        readonly labelNames: readonly ["operation", "outcome", "role", "type"];
+    };
+    readonly graphoria_graphql_operation_duration_seconds: {
+        readonly type: "histogram";
+        readonly help: "Time spent handling a GraphQL operation, in seconds.";
+        readonly labelNames: readonly ["operation", "role", "type"];
+    };
+    readonly graphoria_http_requests_total: {
+        readonly type: "counter";
+        readonly help: "HTTP requests answered by the GraphQL and REST routes, by status.";
+        readonly labelNames: readonly ["method", "route", "status"];
+    };
+    readonly graphoria_http_request_duration_seconds: {
+        readonly type: "histogram";
+        readonly help: "Time spent answering an HTTP request, in seconds.";
+        readonly labelNames: readonly ["method", "route"];
+    };
+    readonly graphoria_cron_runs_total: {
+        readonly type: "counter";
+        readonly help: "Cron ticks that ran to completion or threw, by job.";
+        readonly labelNames: readonly ["job", "outcome"];
+    };
+    readonly graphoria_cron_run_duration_seconds: {
+        readonly type: "histogram";
+        readonly help: "Time spent in a cron tick, in seconds.";
+        readonly labelNames: readonly ["job"];
+    };
+    readonly graphoria_queue_messages_published_total: {
+        readonly type: "counter";
+        readonly help: "Messages handed to a broker, by publisher and outcome.";
+        readonly labelNames: readonly ["broker", "outcome", "publisher"];
+    };
+    readonly graphoria_queue_messages_consumed_total: {
+        readonly type: "counter";
+        readonly help: "Messages taken from a broker, by consumer and outcome.";
+        readonly labelNames: readonly ["broker", "consumer", "outcome", "queue"];
+    };
+    readonly graphoria_rate_limit_rejections_total: {
+        readonly type: "counter";
+        readonly help: "Requests refused by the rate limiter, by the role the ceiling was read from.";
+        readonly labelNames: readonly ["role"];
+    };
+    readonly graphoria_graphql_rejections_total: {
+        readonly type: "counter";
+        readonly help: "GraphQL operations rejected before execution.";
+        readonly labelNames: readonly ["reason"];
+    };
+};
+export type MetricName = keyof typeof METRICS;
+export type Labels = Record<string, string>;
+export type Registry = {
+    inc(metric: MetricName, labels: Labels, value?: number): void;
+    observe(metric: MetricName, labels: Labels, seconds: number): void;
+    render(): string;
+};
+export type RegistryOptions = {
+    /** Distinct values the caller-supplied `operation` label may take, per metric. */
+    maxOperationLabels?: number;
+};
+/**
+ * A metric store with no dependencies. The `operation` label is the only one a
+ * caller controls, so it is the only one capped: past the cap every new name
+ * collapses into `other` rather than minting a series the scrape has to carry
+ * forever.
+ */
+export declare const createRegistry: ({ maxOperationLabels, }?: RegistryOptions) => Registry;
+export declare const configureMetrics: (settings: {
+    enabled: boolean;
+} & RegistryOptions) => void;
+/** Test seam: pass `null` to drop the process registry and its recorded series. */
+export declare const setMetricsRegistry: (registry: Registry | null) => void;
+export declare const isMetricsEnabled: () => boolean;
+export declare const incMetric: (metric: MetricName, labels: Labels, value?: number) => void;
+export declare const observeMetric: (metric: MetricName, labels: Labels, seconds: number) => void;
+export declare const renderMetrics: () => string;
+export {};
+//# sourceMappingURL=metrics.d.ts.map

package/dist/src/observability/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/observability/metrics.ts"],"names":[],"mappings":"AAOA,QAAA,MAAM,OAAO;;iBAET,IAAI,EAAE,SAAS;iBACf,IAAI,EAAE,0CAA0C;iBAChD,UAAU;;;iBAGV,IAAI,EAAE,WAAW;iBACjB,IAAI,EAAE,sDAAsD;iBAC5D,UAAU;;;iBAGV,IAAI,EAAE,SAAS;iBACf,IAAI,EAAE,mEAAmE;iBACzE,UAAU;;;iBAGV,IAAI,EAAE,WAAW;iBACjB,IAAI,EAAE,mDAAmD;iBACzD,UAAU;;;iBAGV,IAAI,EAAE,SAAS;iBACf,IAAI,EAAE,qDAAqD;iBAC3D,UAAU;;;iBAGV,IAAI,EAAE,WAAW;iBACjB,IAAI,EAAE,wCAAwC;iBAC9C,UAAU;;;iBAGV,IAAI,EAAE,SAAS;iBACf,IAAI,EAAE,wDAAwD;iBAC9D,UAAU;;;iBAGV,IAAI,EAAE,SAAS;iBACf,IAAI,EAAE,wDAAwD;iBAC9D,UAAU;;;iBAGV,IAAI,EAAE,SAAS;iBACf,IAAI,EAAE,8EAA8E;iBACpF,UAAU;;;iBAGV,IAAI,EAAE,SAAS;iBACf,IAAI,EAAE,+CAA+C;iBACrD,UAAU;;CAEuC,CAAC;AAEtD,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,OAAO,CAAC;AAE9C,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5C,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9D,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACnE,MAAM,IAAI,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAeF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,6BAExB,eAAe,KAAQ,QAqGzB,CAAC;AAeF,eAAO,MAAM,gBAAgB,aAAc;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,eAAe,KAAG,IAInF,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,aAAc,QAAQ,GAAG,IAAI,KAAG,IAG9D,CAAC;AAQF,eAAO,MAAM,gBAAgB,QAAO,OAAkB,CAAC;AAEvD,eAAO,MAAM,SAAS,WAAY,UAAU,UAAU,MAAM,qBAAc,IAGzE,CAAC;AAEF,eAAO,MAAM,aAAa,WAAY,UAAU,UAAU,MAAM,WAAW,MAAM,KAAG,IAGnF,CAAC;AAEF,eAAO,MAAM,aAAa,QAAO,MAA6B,CAAC"}

package/dist/src/observability/metrics.perf.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=metrics.perf.test.d.ts.map

package/dist/src/observability/metrics.perf.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.perf.test.d.ts","sourceRoot":"","sources":["../../../src/observability/metrics.perf.test.ts"],"names":[],"mappings":""}

package/dist/src/observability/metrics.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=metrics.test.d.ts.map

package/dist/src/observability/metrics.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.test.d.ts","sourceRoot":"","sources":["../../../src/observability/metrics.test.ts"],"names":[],"mappings":""}

package/dist/src/observability/metricsRoute.d.ts

@@ -0,0 +1,19 @@
+import type { CapabilityGrant } from "../authentication/capabilities";
+export type MetricsRouteOptions = {
+    path: string;
+    /** The header a scoped credential rides in — the admin-secret header. */
+    secretHeader: string;
+    authorize: (candidate: string | null) => CapabilityGrant | null;
+    render: () => string;
+};
+/**
+ * A scrape is gated because the exposition names operations, roles and
+ * databases. It is deliberately not rate limited: a scrape interval is fixed
+ * and counting it against a caller ceiling would drop samples.
+ */
+export declare const createMetricsRoute: ({ path, secretHeader, authorize, render, }: MetricsRouteOptions) => {
+    [x: string]: {
+        GET: (req: Request) => Response;
+    };
+};
+//# sourceMappingURL=metricsRoute.d.ts.map

package/dist/src/observability/metricsRoute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricsRoute.d.ts","sourceRoot":"","sources":["../../../src/observability/metricsRoute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAItE,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,eAAe,GAAG,IAAI,CAAC;IAChE,MAAM,EAAE,MAAM,MAAM,CAAC;CACtB,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,+CAK5B,mBAAmB;;mBAEP,OAAO;;CAMpB,CAAC"}

package/dist/src/observability/metricsRoute.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=metricsRoute.test.d.ts.map

package/dist/src/observability/metricsRoute.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricsRoute.test.d.ts","sourceRoot":"","sources":["../../../src/observability/metricsRoute.test.ts"],"names":[],"mappings":""}

package/dist/src/observability/tracing.d.ts

@@ -0,0 +1,92 @@
+import type { Logger } from "pino";
+export type SpanKind = "internal" | "server" | "client" | "producer" | "consumer";
+export type SpanStatus = "unset" | "ok" | "error";
+export type AttributeValue = string | number | boolean;
+export type Attributes = Record<string, AttributeValue | undefined>;
+/** What rides in the async context: three scalars, never the span itself. */
+export type SpanContext = {
+    traceId: string;
+    spanId: string;
+    sampled: boolean;
+};
+export type SpanOptions = {
+    kind?: SpanKind;
+    attributes?: Attributes;
+    /** Overrides the active context — the inbound `traceparent`, or a deliberate root. */
+    parent?: SpanContext | null;
+};
+export type Span = {
+    readonly context: SpanContext;
+    setAttribute(key: string, value: AttributeValue | undefined): void;
+    setStatus(status: SpanStatus, message?: string): void;
+    recordError(error: unknown): void;
+    end(): void;
+};
+export type FinishedSpan = {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind: SpanKind;
+    startTimeUnixNano: string;
+    endTimeUnixNano: string;
+    attributes: Attributes;
+    status: SpanStatus;
+    statusMessage?: string;
+};
+export type Tracer = {
+    startSpan(name: string, options?: SpanOptions): Span;
+    /** Runs `fn` with `span` active, ends it, and marks it errored if `fn` throws. */
+    withSpan<T>(name: string, options: SpanOptions, fn: (span: Span) => T | Promise<T>): Promise<T>;
+    active(): SpanContext | undefined;
+    flush(): Promise<void>;
+};
+export type TracerOptions = {
+    endpoint: string;
+    /** `k=v,k2=v2`, sent on every export — an API key for a hosted collector. */
+    headers?: string;
+    serviceName: string;
+    serviceVersion: string;
+    sampleRatio?: number;
+    maxBatch?: number;
+    maxQueue?: number;
+    /** `0` starts no timer, which is how a test drives the exporter by hand. */
+    exportIntervalMs?: number;
+    /** Test seam: where an export failure and a queue overflow are reported. */
+    log?: Pick<Logger, "warn">;
+    /** Test seam: the transport. Production POSTs with `fetch`. */
+    send?: (url: string, init: {
+        method: string;
+        headers: Record<string, string>;
+        body: string;
+    }) => Promise<void>;
+};
+export declare const parseTraceparent: (header: string | null | undefined) => SpanContext | undefined;
+export declare const formatTraceparent: (context: SpanContext) => string;
+/**
+ * A tracer with no dependencies: W3C ids, OTLP/HTTP JSON, and a bounded export
+ * queue. Nothing here reads process state — everything it needs is closed over,
+ * so it is unit-testable without booting a server.
+ */
+export declare const createTracer: ({ endpoint, headers, serviceName, serviceVersion, sampleRatio, maxBatch, maxQueue, exportIntervalMs, send, log, }: TracerOptions) => Tracer;
+export declare const configureTracing: (next: {
+    enabled: boolean;
+    endpoint: string;
+    headers: string;
+    serviceName: string;
+    sampleRatio: number;
+}) => void;
+/** Test seam: pass `null` to drop the process tracer and its queued spans. */
+export declare const setTracer: (tracer: Tracer | null) => void;
+export declare const isTracingEnabled: () => boolean;
+export declare const startSpan: (name: string, options?: SpanOptions) => Span | undefined;
+export declare const withSpan: <T>(name: string, options: SpanOptions, fn: (span: Span | undefined) => T | Promise<T>) => Promise<T>;
+/**
+ * Runs `fn` with `span` active, leaving its lifetime to the caller. A span that
+ * is never ended is never exported, which is how a websocket upgrade — a
+ * request that is never answered — produces no span at all.
+ */
+export declare const withActiveSpan: <T>(span: Span | undefined, fn: () => T) => T;
+export declare const activeSpanContext: () => SpanContext | undefined;
+export declare const flushSpans: () => Promise<void>;
+//# sourceMappingURL=tracing.d.ts.map

package/dist/src/observability/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../src/observability/tracing.ts"],"names":[],"mappings":"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"}

package/dist/src/observability/tracing.perf.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tracing.perf.test.d.ts.map

package/dist/src/observability/tracing.perf.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.perf.test.d.ts","sourceRoot":"","sources":["../../../src/observability/tracing.perf.test.ts"],"names":[],"mappings":""}

package/dist/src/observability/tracing.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tracing.test.d.ts.map

package/dist/src/observability/tracing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.test.d.ts","sourceRoot":"","sources":["../../../src/observability/tracing.test.ts"],"names":[],"mappings":""}

package/dist/src/queues/kafka.d.ts

@@ -1,3 +1,4 @@
+import { Kafka } from "kafkajs";
 import type { Consumer } from "kafkajs";
 import type { KafkaConfig } from "../types/zod/queue";
 export declare const startConsumer: (connectionName: string, name: string, topic: string, consumer: Consumer, _consumerGroup: string) => Promise<void>;
@@ -13,6 +14,11 @@ export type KafkaConnectionManager = {
     cleanup: () => Promise<void>;
     onPublishersChanged: (callback: () => void) => void;
 };
+export type KafkaDependencies = {
+    /** Test seam: the manager builds its client through this. */
+    createKafka?: (config: ConstructorParameters<typeof Kafka>[0]) => Kafka;
+};
+export declare const createKafkaConnectionManager: (queueConfig: KafkaConfig, { createKafka }?: KafkaDependencies) => KafkaConnectionManager;
 export declare const startKafkaConnections: (queues: KafkaConfig[]) => Promise<{
     managers: KafkaConnectionManager[];
     publisherMap: () => Record<string, KafkaPublisher>;