@happyvertical/smrt-core 0.30.0

package/dist/generators/swagger.d.ts

@@ -0,0 +1,21 @@
+/**
+ * OpenAPI documentation generation for smrt APIs
+ *
+ * Lightweight implementation with optional Swagger UI
+ */
+export interface OpenAPIConfig {
+    title?: string;
+    version?: string;
+    description?: string;
+    basePath?: string;
+    serverUrl?: string;
+}
+/**
+ * Generate OpenAPI specification (tree-shakeable)
+ */
+export declare function generateOpenAPISpec(config?: OpenAPIConfig): any;
+/**
+ * Setup Swagger UI (optional peer dependency)
+ */
+export declare function setupSwaggerUI(app: any, spec: any, path?: string): void;
+//# sourceMappingURL=swagger.d.ts.map

package/dist/generators/swagger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swagger.d.ts","sourceRoot":"","sources":["../../src/generators/swagger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,aAAkB,GAAG,GAAG,CAuDnE;AAsRD;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,SAAU,QAoBjE"}

package/dist/generators/swagger.js

@@ -0,0 +1,307 @@
+import { ObjectRegistry } from "../registry.js";
+function generateOpenAPISpec(config = {}) {
+  const {
+    title = "smrt API",
+    version = "1.0.0",
+    description = "Auto-generated API from smrt objects",
+    basePath = "/api/v1",
+    serverUrl = "http://localhost:3000"
+  } = config;
+  const spec = {
+    openapi: "3.0.3",
+    info: { title, version, description },
+    servers: [{ url: serverUrl }],
+    security: [{ bearerAuth: [] }],
+    components: {
+      securitySchemes: {
+        bearerAuth: {
+          type: "http",
+          scheme: "bearer",
+          bearerFormat: "JWT"
+        }
+      },
+      schemas: generateSchemas(),
+      responses: {
+        ValidationError: {
+          description: "Validation error",
+          content: {
+            "application/json": {
+              schema: {
+                type: "object",
+                properties: {
+                  error: { type: "string" },
+                  details: { type: "string" }
+                }
+              }
+            }
+          }
+        },
+        NotFound: {
+          description: "Resource not found",
+          content: {
+            "application/json": {
+              schema: {
+                type: "object",
+                properties: { error: { type: "string" } }
+              }
+            }
+          }
+        }
+      }
+    },
+    paths: generatePaths(basePath)
+  };
+  return spec;
+}
+function generateSchemas() {
+  const schemas = {};
+  const registeredClasses = ObjectRegistry.getAllClasses();
+  for (const [key, classInfo] of registeredClasses) {
+    const name = classInfo.name || key;
+    if (ObjectRegistry.getConfig(name).api === false) {
+      continue;
+    }
+    schemas[name] = generateObjectSchema(name);
+    schemas[`${name}List`] = {
+      type: "object",
+      properties: {
+        data: {
+          type: "array",
+          items: { $ref: `#/components/schemas/${name}` }
+        },
+        meta: {
+          type: "object",
+          properties: {
+            total: { type: "integer" },
+            limit: { type: "integer" },
+            offset: { type: "integer" },
+            count: { type: "integer" }
+          }
+        }
+      }
+    };
+  }
+  return schemas;
+}
+function generateObjectSchema(objectName) {
+  const fields = ObjectRegistry.getFields(objectName);
+  const properties = {
+    id: { type: "string", format: "uuid" },
+    slug: { type: "string" },
+    created_at: { type: "string", format: "date-time" },
+    updated_at: { type: "string", format: "date-time" }
+  };
+  const required = ["id"];
+  for (const [fieldName, field] of fields) {
+    properties[fieldName] = fieldToOpenAPISchema(field);
+    if (field._meta?.required) {
+      required.push(fieldName);
+    }
+  }
+  return { type: "object", properties, required };
+}
+function fieldToOpenAPISchema(field) {
+  const schema = {
+    description: field._meta?.description || ""
+  };
+  switch (field.type) {
+    case "text":
+      schema.type = "string";
+      if (field._meta?.maxLength) schema.maxLength = field._meta.maxLength;
+      if (field._meta?.minLength) schema.minLength = field._meta.minLength;
+      break;
+    case "integer":
+      schema.type = "integer";
+      if (field._meta?.min !== void 0) schema.minimum = field._meta.min;
+      if (field._meta?.max !== void 0) schema.maximum = field._meta.max;
+      break;
+    case "decimal":
+      schema.type = "number";
+      schema.format = "float";
+      if (field._meta?.min !== void 0) schema.minimum = field._meta.min;
+      if (field._meta?.max !== void 0) schema.maximum = field._meta.max;
+      break;
+    case "boolean":
+      schema.type = "boolean";
+      break;
+    case "datetime":
+      schema.type = "string";
+      schema.format = "date-time";
+      break;
+    case "json":
+      schema.type = "object";
+      schema.additionalProperties = true;
+      break;
+    case "foreignKey":
+      schema.type = "string";
+      schema.format = "uuid";
+      break;
+    default:
+      schema.type = "string";
+  }
+  if (field._meta?.default !== void 0) {
+    schema.default = field._meta.default;
+  }
+  return schema;
+}
+function generatePaths(basePath) {
+  const paths = {};
+  const registeredClasses = ObjectRegistry.getAllClasses();
+  for (const [key, classInfo] of registeredClasses) {
+    const name = classInfo.name || key;
+    const pluralName = pluralize(name.toLowerCase());
+    const objectPath = `${basePath}/${pluralName}`;
+    const config = ObjectRegistry.getConfig(name);
+    const apiConfig = config.api;
+    if (apiConfig === false) {
+      continue;
+    }
+    const excluded = typeof apiConfig === "object" && apiConfig?.exclude ? apiConfig.exclude : [];
+    const included = typeof apiConfig === "object" ? apiConfig?.include : void 0;
+    const shouldInclude = (endpoint) => {
+      if (included && !included.includes(endpoint)) return false;
+      if (excluded.includes(endpoint)) return false;
+      return true;
+    };
+    paths[objectPath] = {};
+    if (shouldInclude("list")) {
+      paths[objectPath].get = {
+        summary: `List ${name} objects`,
+        tags: [name],
+        parameters: [
+          {
+            name: "limit",
+            in: "query",
+            schema: { type: "integer", default: 50 }
+          },
+          {
+            name: "offset",
+            in: "query",
+            schema: { type: "integer", default: 0 }
+          }
+        ],
+        responses: {
+          "200": {
+            description: "Success",
+            content: {
+              "application/json": {
+                schema: { $ref: `#/components/schemas/${name}List` }
+              }
+            }
+          }
+        }
+      };
+    }
+    if (shouldInclude("create")) {
+      paths[objectPath].post = {
+        summary: `Create ${name}`,
+        tags: [name],
+        requestBody: {
+          required: true,
+          content: {
+            "application/json": {
+              schema: { $ref: `#/components/schemas/${name}` }
+            }
+          }
+        },
+        responses: {
+          "201": { description: "Created" },
+          "400": { $ref: "#/components/responses/ValidationError" }
+        }
+      };
+    }
+    paths[`${objectPath}/{id}`] = {};
+    if (shouldInclude("get")) {
+      paths[`${objectPath}/{id}`].get = {
+        summary: `Get ${name} by ID`,
+        tags: [name],
+        parameters: [
+          {
+            name: "id",
+            in: "path",
+            required: true,
+            schema: { type: "string" }
+          }
+        ],
+        responses: {
+          "200": { description: "Success" },
+          "404": { $ref: "#/components/responses/NotFound" }
+        }
+      };
+    }
+    if (shouldInclude("update")) {
+      paths[`${objectPath}/{id}`].put = {
+        summary: `Update ${name}`,
+        tags: [name],
+        parameters: [
+          {
+            name: "id",
+            in: "path",
+            required: true,
+            schema: { type: "string" }
+          }
+        ],
+        requestBody: {
+          required: true,
+          content: {
+            "application/json": {
+              schema: { $ref: `#/components/schemas/${name}` }
+            }
+          }
+        },
+        responses: {
+          "200": { description: "Updated" },
+          "404": { $ref: "#/components/responses/NotFound" }
+        }
+      };
+    }
+    if (shouldInclude("delete")) {
+      paths[`${objectPath}/{id}`].delete = {
+        summary: `Delete ${name}`,
+        tags: [name],
+        parameters: [
+          {
+            name: "id",
+            in: "path",
+            required: true,
+            schema: { type: "string" }
+          }
+        ],
+        responses: {
+          "204": { description: "Deleted" },
+          "404": { $ref: "#/components/responses/NotFound" }
+        }
+      };
+    }
+  }
+  return paths;
+}
+function setupSwaggerUI(app, spec, path = "/docs") {
+  try {
+    const swaggerUi = require("swagger-ui-express");
+    app.use(path, swaggerUi.serve);
+    app.get(
+      path,
+      swaggerUi.setup(spec, {
+        customCss: ".swagger-ui .topbar { display: none }"
+      })
+    );
+    app.get(`${path}/openapi.json`, (_req, res) => {
+      res.json(spec);
+    });
+    console.log(`📚 Swagger UI available at ${path}`);
+  } catch (_error) {
+    console.warn("Swagger UI not available (install swagger-ui-express)");
+  }
+}
+function pluralize(word) {
+  if (word.endsWith("y")) return `${word.slice(0, -1)}ies`;
+  if (word.endsWith("s") || word.endsWith("x") || word.endsWith("z") || word.endsWith("ch") || word.endsWith("sh"))
+    return `${word}es`;
+  return `${word}s`;
+}
+export {
+  generateOpenAPISpec,
+  setupSwaggerUI
+};
+//# sourceMappingURL=swagger.js.map

package/dist/generators/swagger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swagger.js","sources":["../../src/generators/swagger.ts"],"sourcesContent":["/**\n * OpenAPI documentation generation for smrt APIs\n *\n * Lightweight implementation with optional Swagger UI\n */\n\nimport { ObjectRegistry } from '../registry';\n\nexport interface OpenAPIConfig {\n  title?: string;\n  version?: string;\n  description?: string;\n  basePath?: string;\n  serverUrl?: string;\n}\n\n/**\n * Generate OpenAPI specification (tree-shakeable)\n */\nexport function generateOpenAPISpec(config: OpenAPIConfig = {}): any {\n  const {\n    title = 'smrt API',\n    version = '1.0.0',\n    description = 'Auto-generated API from smrt objects',\n    basePath = '/api/v1',\n    serverUrl = 'http://localhost:3000',\n  } = config;\n\n  const spec = {\n    openapi: '3.0.3',\n    info: { title, version, description },\n    servers: [{ url: serverUrl }],\n    security: [{ bearerAuth: [] }],\n    components: {\n      securitySchemes: {\n        bearerAuth: {\n          type: 'http',\n          scheme: 'bearer',\n          bearerFormat: 'JWT',\n        },\n      },\n      schemas: generateSchemas(),\n      responses: {\n        ValidationError: {\n          description: 'Validation error',\n          content: {\n            'application/json': {\n              schema: {\n                type: 'object',\n                properties: {\n                  error: { type: 'string' },\n                  details: { type: 'string' },\n                },\n              },\n            },\n          },\n        },\n        NotFound: {\n          description: 'Resource not found',\n          content: {\n            'application/json': {\n              schema: {\n                type: 'object',\n                properties: { error: { type: 'string' } },\n              },\n            },\n          },\n        },\n      },\n    },\n    paths: generatePaths(basePath),\n  };\n\n  return spec;\n}\n\n/**\n * Generate schemas for all registered objects\n */\nfunction generateSchemas(): Record<string, any> {\n  const schemas: Record<string, any> = {};\n  const registeredClasses = ObjectRegistry.getAllClasses();\n\n  for (const [key, classInfo] of registeredClasses) {\n    // Issue #951: Use simple name for schema keys, not the qualified map key\n    const name = classInfo.name || key;\n    // `api: false` disables REST generation (see rest.ts) and is already\n    // skipped in generatePaths(); mirror that here so component schemas don't\n    // leak the field shape of a surface with no working handlers. Skip ONLY\n    // when api is explicitly false — default (undefined) and\n    // `{ include: [...] }` configs still publish their schema (#1540).\n    if (ObjectRegistry.getConfig(name).api === false) {\n      continue;\n    }\n    schemas[name] = generateObjectSchema(name);\n    schemas[`${name}List`] = {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'array',\n          items: { $ref: `#/components/schemas/${name}` },\n        },\n        meta: {\n          type: 'object',\n          properties: {\n            total: { type: 'integer' },\n            limit: { type: 'integer' },\n            offset: { type: 'integer' },\n            count: { type: 'integer' },\n          },\n        },\n      },\n    };\n  }\n\n  return schemas;\n}\n\n/**\n * Generate schema for a specific object\n */\nfunction generateObjectSchema(objectName: string): any {\n  const fields = ObjectRegistry.getFields(objectName);\n  const properties: Record<string, any> = {\n    id: { type: 'string', format: 'uuid' },\n    slug: { type: 'string' },\n    created_at: { type: 'string', format: 'date-time' },\n    updated_at: { type: 'string', format: 'date-time' },\n  };\n\n  const required = ['id'];\n\n  for (const [fieldName, field] of fields) {\n    properties[fieldName] = fieldToOpenAPISchema(field);\n    if (field._meta?.required) {\n      required.push(fieldName);\n    }\n  }\n\n  return { type: 'object', properties, required };\n}\n\n/**\n * Convert field to OpenAPI schema\n */\nfunction fieldToOpenAPISchema(field: any): any {\n  const schema: any = {\n    description: field._meta?.description || '',\n  };\n\n  switch (field.type) {\n    case 'text':\n      schema.type = 'string';\n      if (field._meta?.maxLength) schema.maxLength = field._meta.maxLength;\n      if (field._meta?.minLength) schema.minLength = field._meta.minLength;\n      break;\n    case 'integer':\n      schema.type = 'integer';\n      if (field._meta?.min !== undefined) schema.minimum = field._meta.min;\n      if (field._meta?.max !== undefined) schema.maximum = field._meta.max;\n      break;\n    case 'decimal':\n      schema.type = 'number';\n      schema.format = 'float';\n      if (field._meta?.min !== undefined) schema.minimum = field._meta.min;\n      if (field._meta?.max !== undefined) schema.maximum = field._meta.max;\n      break;\n    case 'boolean':\n      schema.type = 'boolean';\n      break;\n    case 'datetime':\n      schema.type = 'string';\n      schema.format = 'date-time';\n      break;\n    case 'json':\n      schema.type = 'object';\n      schema.additionalProperties = true;\n      break;\n    case 'foreignKey':\n      schema.type = 'string';\n      schema.format = 'uuid';\n      break;\n    default:\n      schema.type = 'string';\n  }\n\n  if (field._meta?.default !== undefined) {\n    schema.default = field._meta.default;\n  }\n\n  return schema;\n}\n\n/**\n * Generate API paths\n */\nfunction generatePaths(basePath: string): Record<string, any> {\n  const paths: Record<string, any> = {};\n  const registeredClasses = ObjectRegistry.getAllClasses();\n\n  for (const [key, classInfo] of registeredClasses) {\n    // Issue #951: Use simple name, not the qualified map key\n    const name = classInfo.name || key;\n    const pluralName = pluralize(name.toLowerCase());\n    const objectPath = `${basePath}/${pluralName}`;\n\n    const config = ObjectRegistry.getConfig(name);\n    const apiConfig = config.api;\n    // `api: false` disables REST generation (see rest.ts); don't advertise its\n    // paths in the OpenAPI spec either, or the spec leaks the shape of a\n    // surface that has no working handlers (#1540).\n    if (apiConfig === false) {\n      continue;\n    }\n    const excluded: string[] =\n      typeof apiConfig === 'object' && apiConfig?.exclude\n        ? apiConfig.exclude\n        : [];\n    const included: string[] | undefined =\n      typeof apiConfig === 'object' ? apiConfig?.include : undefined;\n\n    const shouldInclude = (\n      endpoint: 'list' | 'get' | 'create' | 'update' | 'delete',\n    ) => {\n      if (included && !included.includes(endpoint)) return false;\n      if (excluded.includes(endpoint)) return false;\n      return true;\n    };\n\n    // Collection endpoints\n    paths[objectPath] = {};\n\n    if (shouldInclude('list')) {\n      paths[objectPath].get = {\n        summary: `List ${name} objects`,\n        tags: [name],\n        parameters: [\n          {\n            name: 'limit',\n            in: 'query',\n            schema: { type: 'integer', default: 50 },\n          },\n          {\n            name: 'offset',\n            in: 'query',\n            schema: { type: 'integer', default: 0 },\n          },\n        ],\n        responses: {\n          '200': {\n            description: 'Success',\n            content: {\n              'application/json': {\n                schema: { $ref: `#/components/schemas/${name}List` },\n              },\n            },\n          },\n        },\n      };\n    }\n\n    if (shouldInclude('create')) {\n      paths[objectPath].post = {\n        summary: `Create ${name}`,\n        tags: [name],\n        requestBody: {\n          required: true,\n          content: {\n            'application/json': {\n              schema: { $ref: `#/components/schemas/${name}` },\n            },\n          },\n        },\n        responses: {\n          '201': { description: 'Created' },\n          '400': { $ref: '#/components/responses/ValidationError' },\n        },\n      };\n    }\n\n    // Item endpoints\n    paths[`${objectPath}/{id}`] = {};\n\n    if (shouldInclude('get')) {\n      paths[`${objectPath}/{id}`].get = {\n        summary: `Get ${name} by ID`,\n        tags: [name],\n        parameters: [\n          {\n            name: 'id',\n            in: 'path',\n            required: true,\n            schema: { type: 'string' },\n          },\n        ],\n        responses: {\n          '200': { description: 'Success' },\n          '404': { $ref: '#/components/responses/NotFound' },\n        },\n      };\n    }\n\n    if (shouldInclude('update')) {\n      paths[`${objectPath}/{id}`].put = {\n        summary: `Update ${name}`,\n        tags: [name],\n        parameters: [\n          {\n            name: 'id',\n            in: 'path',\n            required: true,\n            schema: { type: 'string' },\n          },\n        ],\n        requestBody: {\n          required: true,\n          content: {\n            'application/json': {\n              schema: { $ref: `#/components/schemas/${name}` },\n            },\n          },\n        },\n        responses: {\n          '200': { description: 'Updated' },\n          '404': { $ref: '#/components/responses/NotFound' },\n        },\n      };\n    }\n\n    if (shouldInclude('delete')) {\n      paths[`${objectPath}/{id}`].delete = {\n        summary: `Delete ${name}`,\n        tags: [name],\n        parameters: [\n          {\n            name: 'id',\n            in: 'path',\n            required: true,\n            schema: { type: 'string' },\n          },\n        ],\n        responses: {\n          '204': { description: 'Deleted' },\n          '404': { $ref: '#/components/responses/NotFound' },\n        },\n      };\n    }\n  }\n\n  return paths;\n}\n\n/**\n * Setup Swagger UI (optional peer dependency)\n */\nexport function setupSwaggerUI(app: any, spec: any, path = '/docs') {\n  try {\n    const swaggerUi = require('swagger-ui-express');\n\n    app.use(path, swaggerUi.serve);\n    app.get(\n      path,\n      swaggerUi.setup(spec, {\n        customCss: '.swagger-ui .topbar { display: none }',\n      }),\n    );\n\n    app.get(`${path}/openapi.json`, (_req: any, res: any) => {\n      res.json(spec);\n    });\n\n    console.log(`📚 Swagger UI available at ${path}`);\n  } catch (_error) {\n    console.warn('Swagger UI not available (install swagger-ui-express)');\n  }\n}\n\nfunction pluralize(word: string): string {\n  if (word.endsWith('y')) return `${word.slice(0, -1)}ies`;\n  if (\n    word.endsWith('s') ||\n    word.endsWith('x') ||\n    word.endsWith('z') ||\n    word.endsWith('ch') ||\n    word.endsWith('sh')\n  )\n    return `${word}es`;\n  return `${word}s`;\n}\n"],"names":[],"mappings":";AAmBO,SAAS,oBAAoB,SAAwB,IAAS;AACnE,QAAM;AAAA,IACJ,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,cAAc;AAAA,IACd,WAAW;AAAA,IACX,YAAY;AAAA,EAAA,IACV;AAEJ,QAAM,OAAO;AAAA,IACX,SAAS;AAAA,IACT,MAAM,EAAE,OAAO,SAAS,YAAA;AAAA,IACxB,SAAS,CAAC,EAAE,KAAK,WAAW;AAAA,IAC5B,UAAU,CAAC,EAAE,YAAY,CAAA,GAAI;AAAA,IAC7B,YAAY;AAAA,MACV,iBAAiB;AAAA,QACf,YAAY;AAAA,UACV,MAAM;AAAA,UACN,QAAQ;AAAA,UACR,cAAc;AAAA,QAAA;AAAA,MAChB;AAAA,MAEF,SAAS,gBAAA;AAAA,MACT,WAAW;AAAA,QACT,iBAAiB;AAAA,UACf,aAAa;AAAA,UACb,SAAS;AAAA,YACP,oBAAoB;AAAA,cAClB,QAAQ;AAAA,gBACN,MAAM;AAAA,gBACN,YAAY;AAAA,kBACV,OAAO,EAAE,MAAM,SAAA;AAAA,kBACf,SAAS,EAAE,MAAM,SAAA;AAAA,gBAAS;AAAA,cAC5B;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,QAEF,UAAU;AAAA,UACR,aAAa;AAAA,UACb,SAAS;AAAA,YACP,oBAAoB;AAAA,cAClB,QAAQ;AAAA,gBACN,MAAM;AAAA,gBACN,YAAY,EAAE,OAAO,EAAE,MAAM,WAAS;AAAA,cAAE;AAAA,YAC1C;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,IAEF,OAAO,cAAc,QAAQ;AAAA,EAAA;AAG/B,SAAO;AACT;AAKA,SAAS,kBAAuC;AAC9C,QAAM,UAA+B,CAAA;AACrC,QAAM,oBAAoB,eAAe,cAAA;AAEzC,aAAW,CAAC,KAAK,SAAS,KAAK,mBAAmB;AAEhD,UAAM,OAAO,UAAU,QAAQ;AAM/B,QAAI,eAAe,UAAU,IAAI,EAAE,QAAQ,OAAO;AAChD;AAAA,IACF;AACA,YAAQ,IAAI,IAAI,qBAAqB,IAAI;AACzC,YAAQ,GAAG,IAAI,MAAM,IAAI;AAAA,MACvB,MAAM;AAAA,MACN,YAAY;AAAA,QACV,MAAM;AAAA,UACJ,MAAM;AAAA,UACN,OAAO,EAAE,MAAM,wBAAwB,IAAI,GAAA;AAAA,QAAG;AAAA,QAEhD,MAAM;AAAA,UACJ,MAAM;AAAA,UACN,YAAY;AAAA,YACV,OAAO,EAAE,MAAM,UAAA;AAAA,YACf,OAAO,EAAE,MAAM,UAAA;AAAA,YACf,QAAQ,EAAE,MAAM,UAAA;AAAA,YAChB,OAAO,EAAE,MAAM,UAAA;AAAA,UAAU;AAAA,QAC3B;AAAA,MACF;AAAA,IACF;AAAA,EAEJ;AAEA,SAAO;AACT;AAKA,SAAS,qBAAqB,YAAyB;AACrD,QAAM,SAAS,eAAe,UAAU,UAAU;AAClD,QAAM,aAAkC;AAAA,IACtC,IAAI,EAAE,MAAM,UAAU,QAAQ,OAAA;AAAA,IAC9B,MAAM,EAAE,MAAM,SAAA;AAAA,IACd,YAAY,EAAE,MAAM,UAAU,QAAQ,YAAA;AAAA,IACtC,YAAY,EAAE,MAAM,UAAU,QAAQ,YAAA;AAAA,EAAY;AAGpD,QAAM,WAAW,CAAC,IAAI;AAEtB,aAAW,CAAC,WAAW,KAAK,KAAK,QAAQ;AACvC,eAAW,SAAS,IAAI,qBAAqB,KAAK;AAClD,QAAI,MAAM,OAAO,UAAU;AACzB,eAAS,KAAK,SAAS;AAAA,IACzB;AAAA,EACF;AAEA,SAAO,EAAE,MAAM,UAAU,YAAY,SAAA;AACvC;AAKA,SAAS,qBAAqB,OAAiB;AAC7C,QAAM,SAAc;AAAA,IAClB,aAAa,MAAM,OAAO,eAAe;AAAA,EAAA;AAG3C,UAAQ,MAAM,MAAA;AAAA,IACZ,KAAK;AACH,aAAO,OAAO;AACd,UAAI,MAAM,OAAO,UAAW,QAAO,YAAY,MAAM,MAAM;AAC3D,UAAI,MAAM,OAAO,UAAW,QAAO,YAAY,MAAM,MAAM;AAC3D;AAAA,IACF,KAAK;AACH,aAAO,OAAO;AACd,UAAI,MAAM,OAAO,QAAQ,OAAW,QAAO,UAAU,MAAM,MAAM;AACjE,UAAI,MAAM,OAAO,QAAQ,OAAW,QAAO,UAAU,MAAM,MAAM;AACjE;AAAA,IACF,KAAK;AACH,aAAO,OAAO;AACd,aAAO,SAAS;AAChB,UAAI,MAAM,OAAO,QAAQ,OAAW,QAAO,UAAU,MAAM,MAAM;AACjE,UAAI,MAAM,OAAO,QAAQ,OAAW,QAAO,UAAU,MAAM,MAAM;AACjE;AAAA,IACF,KAAK;AACH,aAAO,OAAO;AACd;AAAA,IACF,KAAK;AACH,aAAO,OAAO;AACd,aAAO,SAAS;AAChB;AAAA,IACF,KAAK;AACH,aAAO,OAAO;AACd,aAAO,uBAAuB;AAC9B;AAAA,IACF,KAAK;AACH,aAAO,OAAO;AACd,aAAO,SAAS;AAChB;AAAA,IACF;AACE,aAAO,OAAO;AAAA,EAAA;AAGlB,MAAI,MAAM,OAAO,YAAY,QAAW;AACtC,WAAO,UAAU,MAAM,MAAM;AAAA,EAC/B;AAEA,SAAO;AACT;AAKA,SAAS,cAAc,UAAuC;AAC5D,QAAM,QAA6B,CAAA;AACnC,QAAM,oBAAoB,eAAe,cAAA;AAEzC,aAAW,CAAC,KAAK,SAAS,KAAK,mBAAmB;AAEhD,UAAM,OAAO,UAAU,QAAQ;AAC/B,UAAM,aAAa,UAAU,KAAK,YAAA,CAAa;AAC/C,UAAM,aAAa,GAAG,QAAQ,IAAI,UAAU;AAE5C,UAAM,SAAS,eAAe,UAAU,IAAI;AAC5C,UAAM,YAAY,OAAO;AAIzB,QAAI,cAAc,OAAO;AACvB;AAAA,IACF;AACA,UAAM,WACJ,OAAO,cAAc,YAAY,WAAW,UACxC,UAAU,UACV,CAAA;AACN,UAAM,WACJ,OAAO,cAAc,WAAW,WAAW,UAAU;AAEvD,UAAM,gBAAgB,CACpB,aACG;AACH,UAAI,YAAY,CAAC,SAAS,SAAS,QAAQ,EAAG,QAAO;AACrD,UAAI,SAAS,SAAS,QAAQ,EAAG,QAAO;AACxC,aAAO;AAAA,IACT;AAGA,UAAM,UAAU,IAAI,CAAA;AAEpB,QAAI,cAAc,MAAM,GAAG;AACzB,YAAM,UAAU,EAAE,MAAM;AAAA,QACtB,SAAS,QAAQ,IAAI;AAAA,QACrB,MAAM,CAAC,IAAI;AAAA,QACX,YAAY;AAAA,UACV;AAAA,YACE,MAAM;AAAA,YACN,IAAI;AAAA,YACJ,QAAQ,EAAE,MAAM,WAAW,SAAS,GAAA;AAAA,UAAG;AAAA,UAEzC;AAAA,YACE,MAAM;AAAA,YACN,IAAI;AAAA,YACJ,QAAQ,EAAE,MAAM,WAAW,SAAS,EAAA;AAAA,UAAE;AAAA,QACxC;AAAA,QAEF,WAAW;AAAA,UACT,OAAO;AAAA,YACL,aAAa;AAAA,YACb,SAAS;AAAA,cACP,oBAAoB;AAAA,gBAClB,QAAQ,EAAE,MAAM,wBAAwB,IAAI,OAAA;AAAA,cAAO;AAAA,YACrD;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IAEJ;AAEA,QAAI,cAAc,QAAQ,GAAG;AAC3B,YAAM,UAAU,EAAE,OAAO;AAAA,QACvB,SAAS,UAAU,IAAI;AAAA,QACvB,MAAM,CAAC,IAAI;AAAA,QACX,aAAa;AAAA,UACX,UAAU;AAAA,UACV,SAAS;AAAA,YACP,oBAAoB;AAAA,cAClB,QAAQ,EAAE,MAAM,wBAAwB,IAAI,GAAA;AAAA,YAAG;AAAA,UACjD;AAAA,QACF;AAAA,QAEF,WAAW;AAAA,UACT,OAAO,EAAE,aAAa,UAAA;AAAA,UACtB,OAAO,EAAE,MAAM,yCAAA;AAAA,QAAyC;AAAA,MAC1D;AAAA,IAEJ;AAGA,UAAM,GAAG,UAAU,OAAO,IAAI,CAAA;AAE9B,QAAI,cAAc,KAAK,GAAG;AACxB,YAAM,GAAG,UAAU,OAAO,EAAE,MAAM;AAAA,QAChC,SAAS,OAAO,IAAI;AAAA,QACpB,MAAM,CAAC,IAAI;AAAA,QACX,YAAY;AAAA,UACV;AAAA,YACE,MAAM;AAAA,YACN,IAAI;AAAA,YACJ,UAAU;AAAA,YACV,QAAQ,EAAE,MAAM,SAAA;AAAA,UAAS;AAAA,QAC3B;AAAA,QAEF,WAAW;AAAA,UACT,OAAO,EAAE,aAAa,UAAA;AAAA,UACtB,OAAO,EAAE,MAAM,kCAAA;AAAA,QAAkC;AAAA,MACnD;AAAA,IAEJ;AAEA,QAAI,cAAc,QAAQ,GAAG;AAC3B,YAAM,GAAG,UAAU,OAAO,EAAE,MAAM;AAAA,QAChC,SAAS,UAAU,IAAI;AAAA,QACvB,MAAM,CAAC,IAAI;AAAA,QACX,YAAY;AAAA,UACV;AAAA,YACE,MAAM;AAAA,YACN,IAAI;AAAA,YACJ,UAAU;AAAA,YACV,QAAQ,EAAE,MAAM,SAAA;AAAA,UAAS;AAAA,QAC3B;AAAA,QAEF,aAAa;AAAA,UACX,UAAU;AAAA,UACV,SAAS;AAAA,YACP,oBAAoB;AAAA,cAClB,QAAQ,EAAE,MAAM,wBAAwB,IAAI,GAAA;AAAA,YAAG;AAAA,UACjD;AAAA,QACF;AAAA,QAEF,WAAW;AAAA,UACT,OAAO,EAAE,aAAa,UAAA;AAAA,UACtB,OAAO,EAAE,MAAM,kCAAA;AAAA,QAAkC;AAAA,MACnD;AAAA,IAEJ;AAEA,QAAI,cAAc,QAAQ,GAAG;AAC3B,YAAM,GAAG,UAAU,OAAO,EAAE,SAAS;AAAA,QACnC,SAAS,UAAU,IAAI;AAAA,QACvB,MAAM,CAAC,IAAI;AAAA,QACX,YAAY;AAAA,UACV;AAAA,YACE,MAAM;AAAA,YACN,IAAI;AAAA,YACJ,UAAU;AAAA,YACV,QAAQ,EAAE,MAAM,SAAA;AAAA,UAAS;AAAA,QAC3B;AAAA,QAEF,WAAW;AAAA,UACT,OAAO,EAAE,aAAa,UAAA;AAAA,UACtB,OAAO,EAAE,MAAM,kCAAA;AAAA,QAAkC;AAAA,MACnD;AAAA,IAEJ;AAAA,EACF;AAEA,SAAO;AACT;AAKO,SAAS,eAAe,KAAU,MAAW,OAAO,SAAS;AAClE,MAAI;AACF,UAAM,YAAY,QAAQ,oBAAoB;AAE9C,QAAI,IAAI,MAAM,UAAU,KAAK;AAC7B,QAAI;AAAA,MACF;AAAA,MACA,UAAU,MAAM,MAAM;AAAA,QACpB,WAAW;AAAA,MAAA,CACZ;AAAA,IAAA;AAGH,QAAI,IAAI,GAAG,IAAI,iBAAiB,CAAC,MAAW,QAAa;AACvD,UAAI,KAAK,IAAI;AAAA,IACf,CAAC;AAED,YAAQ,IAAI,8BAA8B,IAAI,EAAE;AAAA,EAClD,SAAS,QAAQ;AACf,YAAQ,KAAK,uDAAuD;AAAA,EACtE;AACF;AAEA,SAAS,UAAU,MAAsB;AACvC,MAAI,KAAK,SAAS,GAAG,EAAG,QAAO,GAAG,KAAK,MAAM,GAAG,EAAE,CAAC;AACnD,MACE,KAAK,SAAS,GAAG,KACjB,KAAK,SAAS,GAAG,KACjB,KAAK,SAAS,GAAG,KACjB,KAAK,SAAS,IAAI,KAClB,KAAK,SAAS,IAAI;AAElB,WAAO,GAAG,IAAI;AAChB,SAAO,GAAG,IAAI;AAChB;"}

package/dist/generators/tenant-gate.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Tenant entry-point gate — dependency-inversion hook for generated CLI/MCP
+ * execution (#1554).
+ *
+ * `@happyvertical/smrt-core` cannot depend on `@happyvertical/smrt-tenancy`
+ * (tenancy depends on core, not the other way around). The generated SvelteKit
+ * routes establish tenant context from the request principal, but the in-process
+ * CLI/MCP generators have no principal — without a gate a tenant-scoped read
+ * with no active context would fall through the interceptor's optional-mode
+ * pass-through and return rows across **all** tenants.
+ *
+ * Core exposes an injectable runner slot that tenancy fills at `enableTenancy()`
+ * time (the same inversion pattern as the DispatchBus tenant resolver and
+ * `GlobalInterceptors`). When tenancy is not enabled (non-tenant deployments,
+ * existing tests), the slot is empty and {@link runWithTenantGate} simply runs
+ * the body — identical to pre-#1554 behavior.
+ *
+ * Stored on `globalThis` so all module instances share one runner, which
+ * matters in the monorepo where the same package can be loaded from multiple
+ * paths.
+ */
+/** Options forwarded to the registered tenancy runner. */
+export interface TenantGateOptions {
+    /**
+     * Class name of the target model. Tenant-scoping is resolved authoritatively
+     * inside tenancy (`isTenantScopedClass`) — the same source the interceptor
+     * uses, so it covers both `@TenantScoped` and `@smrt({ tenantScoped })`.
+     */
+    className?: string;
+    /** Explicit tenant-scoping decision; overrides `className` resolution. */
+    tenantScoped?: boolean;
+    /** Explicit operator-provided tenant selector (`--tenant` / `context.tenantId`). */
+    tenantId?: string | null;
+    /** Explicit operator opt-in to cross-tenant/system access (`--all-tenants`). */
+    allowCrossTenant?: boolean;
+    /** Surface name for the fail-closed error message, e.g. `'CLI'` / `'MCP'`. */
+    surface?: string;
+}
+/**
+ * Runner that establishes (or fail-closes) tenant context around `fn` for a
+ * tenant-scoped model. Registered by tenancy; see
+ * `runTenantScopedEntryPoint` in `@happyvertical/smrt-tenancy`.
+ */
+export type TenantEntryPointRunner = <T>(options: TenantGateOptions, fn: () => Promise<T>) => Promise<T>;
+declare global {
+    var __smrtTenantEntryPointRunner: TenantEntryPointRunner | undefined;
+}
+/**
+ * Register the tenant entry-point runner used by generated CLI/MCP execution.
+ *
+ * Called by `@happyvertical/smrt-tenancy`'s `enableTenancy()`; application code
+ * never calls this directly. Passing `undefined` clears the runner (restoring
+ * the no-op default), which `disableTenancy()` does.
+ *
+ * @param runner - The tenancy runner, or `undefined` to clear it.
+ */
+export declare function setTenantEntryPointRunner(runner: TenantEntryPointRunner | undefined): void;
+/**
+ * Run `fn` through the registered tenant entry-point runner (when tenancy is
+ * enabled), or directly when no runner is registered.
+ *
+ * For tenant-scoped models the runner establishes tenant context from
+ * `options.tenantId` / `options.allowCrossTenant`, or fails closed (throws) when
+ * neither is available — never silently reading across tenants. Non-scoped
+ * models and tenancy-off deployments pass straight through.
+ *
+ * @param options - {@link TenantGateOptions}.
+ * @param fn - The command/tool body to execute.
+ * @returns The resolved value of `fn`.
+ * @throws Propagates the tenancy runner's `TenantContextError` on the
+ *   fail-closed branch.
+ */
+export declare function runWithTenantGate<T>(options: TenantGateOptions, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=tenant-gate.d.ts.map

package/dist/generators/tenant-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-gate.d.ts","sourceRoot":"","sources":["../../src/generators/tenant-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,EACrC,OAAO,EAAE,iBAAiB,EAC1B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KACjB,OAAO,CAAC,CAAC,CAAC,CAAC;AAEhB,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,4BAA4B,EAAE,sBAAsB,GAAG,SAAS,CAAC;CACtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,sBAAsB,GAAG,SAAS,GACzC,IAAI,CAEN;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,OAAO,EAAE,iBAAiB,EAC1B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAOZ"}

package/dist/generators/tenant-gate.js

@@ -0,0 +1,15 @@
+function setTenantEntryPointRunner(runner) {
+  globalThis.__smrtTenantEntryPointRunner = runner;
+}
+async function runWithTenantGate(options, fn) {
+  const runner = globalThis.__smrtTenantEntryPointRunner;
+  if (!runner) {
+    return fn();
+  }
+  return runner(options, fn);
+}
+export {
+  runWithTenantGate,
+  setTenantEntryPointRunner
+};
+//# sourceMappingURL=tenant-gate.js.map

package/dist/generators/tenant-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-gate.js","sources":["../../src/generators/tenant-gate.ts"],"sourcesContent":["/**\n * Tenant entry-point gate — dependency-inversion hook for generated CLI/MCP\n * execution (#1554).\n *\n * `@happyvertical/smrt-core` cannot depend on `@happyvertical/smrt-tenancy`\n * (tenancy depends on core, not the other way around). The generated SvelteKit\n * routes establish tenant context from the request principal, but the in-process\n * CLI/MCP generators have no principal — without a gate a tenant-scoped read\n * with no active context would fall through the interceptor's optional-mode\n * pass-through and return rows across **all** tenants.\n *\n * Core exposes an injectable runner slot that tenancy fills at `enableTenancy()`\n * time (the same inversion pattern as the DispatchBus tenant resolver and\n * `GlobalInterceptors`). When tenancy is not enabled (non-tenant deployments,\n * existing tests), the slot is empty and {@link runWithTenantGate} simply runs\n * the body — identical to pre-#1554 behavior.\n *\n * Stored on `globalThis` so all module instances share one runner, which\n * matters in the monorepo where the same package can be loaded from multiple\n * paths.\n */\n\n/** Options forwarded to the registered tenancy runner. */\nexport interface TenantGateOptions {\n  /**\n   * Class name of the target model. Tenant-scoping is resolved authoritatively\n   * inside tenancy (`isTenantScopedClass`) — the same source the interceptor\n   * uses, so it covers both `@TenantScoped` and `@smrt({ tenantScoped })`.\n   */\n  className?: string;\n  /** Explicit tenant-scoping decision; overrides `className` resolution. */\n  tenantScoped?: boolean;\n  /** Explicit operator-provided tenant selector (`--tenant` / `context.tenantId`). */\n  tenantId?: string | null;\n  /** Explicit operator opt-in to cross-tenant/system access (`--all-tenants`). */\n  allowCrossTenant?: boolean;\n  /** Surface name for the fail-closed error message, e.g. `'CLI'` / `'MCP'`. */\n  surface?: string;\n}\n\n/**\n * Runner that establishes (or fail-closes) tenant context around `fn` for a\n * tenant-scoped model. Registered by tenancy; see\n * `runTenantScopedEntryPoint` in `@happyvertical/smrt-tenancy`.\n */\nexport type TenantEntryPointRunner = <T>(\n  options: TenantGateOptions,\n  fn: () => Promise<T>,\n) => Promise<T>;\n\ndeclare global {\n  // eslint-disable-next-line no-var\n  var __smrtTenantEntryPointRunner: TenantEntryPointRunner | undefined;\n}\n\n/**\n * Register the tenant entry-point runner used by generated CLI/MCP execution.\n *\n * Called by `@happyvertical/smrt-tenancy`'s `enableTenancy()`; application code\n * never calls this directly. Passing `undefined` clears the runner (restoring\n * the no-op default), which `disableTenancy()` does.\n *\n * @param runner - The tenancy runner, or `undefined` to clear it.\n */\nexport function setTenantEntryPointRunner(\n  runner: TenantEntryPointRunner | undefined,\n): void {\n  globalThis.__smrtTenantEntryPointRunner = runner;\n}\n\n/**\n * Run `fn` through the registered tenant entry-point runner (when tenancy is\n * enabled), or directly when no runner is registered.\n *\n * For tenant-scoped models the runner establishes tenant context from\n * `options.tenantId` / `options.allowCrossTenant`, or fails closed (throws) when\n * neither is available — never silently reading across tenants. Non-scoped\n * models and tenancy-off deployments pass straight through.\n *\n * @param options - {@link TenantGateOptions}.\n * @param fn - The command/tool body to execute.\n * @returns The resolved value of `fn`.\n * @throws Propagates the tenancy runner's `TenantContextError` on the\n *   fail-closed branch.\n */\nexport async function runWithTenantGate<T>(\n  options: TenantGateOptions,\n  fn: () => Promise<T>,\n): Promise<T> {\n  const runner = globalThis.__smrtTenantEntryPointRunner;\n  if (!runner) {\n    // Tenancy not enabled → single-/no-tenant deployment, pass through.\n    return fn();\n  }\n  return runner(options, fn);\n}\n"],"names":[],"mappings":"AAgEO,SAAS,0BACd,QACM;AACN,aAAW,+BAA+B;AAC5C;AAiBA,eAAsB,kBACpB,SACA,IACY;AACZ,QAAM,SAAS,WAAW;AAC1B,MAAI,CAAC,QAAQ;AAEX,WAAO,GAAA;AAAA,EACT;AACA,SAAO,OAAO,SAAS,EAAE;AAC3B;"}

package/dist/generators.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Code generators for SMRT objects
+ *
+ * Re-exports all generators from the generators/ directory.
+ * This file serves as the entry point for @smrt/core/generators exports.
+ */
+export * from './generators/index.js';
+//# sourceMappingURL=generators.d.ts.map

package/dist/generators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generators.d.ts","sourceRoot":"","sources":["../src/generators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,uBAAuB,CAAC"}

package/dist/generators.js

@@ -0,0 +1,19 @@
+import { CLIGenerator, getCLIHandler, setupCLI } from "./generators/cli.js";
+import { MCPGenerator } from "./generators/mcp.js";
+import { APIGenerator, createRestServer, startRestServer } from "./generators/rest.js";
+import { generateOpenAPISpec, setupSwaggerUI } from "./generators/swagger.js";
+import { runWithTenantGate, setTenantEntryPointRunner } from "./generators/tenant-gate.js";
+export {
+  APIGenerator,
+  CLIGenerator,
+  MCPGenerator,
+  createRestServer,
+  generateOpenAPISpec,
+  getCLIHandler,
+  runWithTenantGate,
+  setTenantEntryPointRunner,
+  setupCLI,
+  setupSwaggerUI,
+  startRestServer
+};
+//# sourceMappingURL=generators.js.map

package/dist/generators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generators.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}

package/dist/hierarchical.d.ts

@@ -0,0 +1,103 @@
+import { SmrtCollection } from './collection';
+import { SmrtObject } from './object';
+/**
+ * Aggregate hierarchy view: ancestors (root-first), self, and all descendants
+ * (BFS order). Generic on the concrete subclass so `getHierarchy()` preserves
+ * the caller's type — `place.getHierarchy()` yields `HierarchyView<Place>`.
+ */
+export interface HierarchyView<T extends SmrtHierarchical> {
+    ancestors: T[];
+    current: T;
+    descendants: T[];
+}
+export declare class SmrtHierarchical extends SmrtObject {
+    /**
+     * Internal marker so the scanner can recognize this framework abstract base
+     * even when consumers haven't built its package. Mirrors
+     * `SmrtJunction._isJunctionBase`. Don't rename without also updating the
+     * scanner's `FRAMEWORK_BASE_CLASSES` set in
+     * `packages/scanner/src/inheritance-resolver.ts`.
+     */
+    static readonly _isHierarchicalBase: true;
+    /** Self-referencing parent. `null` means top-level (no parent). */
+    parentId: string | null;
+    /**
+     * Resolve the collection used to load siblings/ancestors/descendants.
+     *
+     * Goes through `ObjectRegistry.getCollection` so subclasses don't have to
+     * hard-code a dynamic import of their own collection module. Also acts as
+     * the abstract-base guard — `new SmrtHierarchical()` followed by any
+     * traversal method throws a clear error rather than producing garbage.
+     *
+     * For STI subclasses, queries are issued against the STI base collection
+     * so the table/discriminator are correct.
+     *
+     * Lookup uses the constructor's qualified name when available — set by
+     * the registry on every registered class as `_smrtQualifiedName` (R5-
+     * canon prep). Then `ObjectRegistry.getSTIBase(...)` returns the
+     * qualified name of the STI base directly (R5-canon main), so the
+     * `getCollection` lookup never collapses to a simple-name ambiguity
+     * even when two packages ship a hierarchical class with the same
+     * simple name. Falls back through `getClassByConstructor` → simple
+     * `this.constructor.name` when the static / WeakMap aren't populated
+     * (rare; `getCollection` then surfaces the existing "not found in
+     * ObjectRegistry" error).
+     *
+     * The constructor prototype-chain walk that lived here from PR #1269
+     * is gone — the registry now returns qualified names directly so the
+     * walk became dead code.
+     */
+    protected _hierarchyCollection(): Promise<SmrtCollection<this>>;
+    /**
+     * The parent row, or `null` when this row is top-level.
+     *
+     * Single query. Returns the hydrated row (STI dispatch applies, so an
+     * Article-extends-Document subclass comes back as `Article`).
+     */
+    getParent(): Promise<this | null>;
+    /**
+     * Immediate children. Single query: `WHERE parent_id = this.id`.
+     */
+    getChildren(): Promise<this[]>;
+    /**
+     * All ancestors, root-first (immediate parent last). Does not include self.
+     *
+     * Intrinsically O(depth) queries — each step needs the previous level's
+     * `parentId` before it can fetch the next. Includes cycle protection: if
+     * a row's ancestor chain loops back on itself (data corruption), the walk
+     * stops cleanly instead of looping forever.
+     */
+    getAncestors(): Promise<this[]>;
+    /**
+     * All descendants in BFS order. One query per level of depth using `IN`
+     * on the previous level's IDs — eliminates the recursive-per-child N+1
+     * pattern the duplicated implementations used.
+     *
+     * Each level's frontier is chunked at `IN_LIST_CHUNK_SIZE` before being
+     * expanded into a `parent_id IN (?, ?, …)` clause: the generic
+     * `collection.list()` does NOT chunk array-valued WHERE clauses, so a level
+     * wider than the backend's `SQLITE_MAX_VARIABLE_NUMBER` (999 on legacy
+     * SQLite, 32766 on modern builds) would otherwise throw before traversal
+     * completes. Mirrors the chunking the relationship/junction loaders in
+     * `collection.ts` already do.
+     *
+     * Cycle-safe via a visited Set keyed on row id.
+     */
+    getDescendants(): Promise<this[]>;
+    /**
+     * Full hierarchy view: ancestors, self, descendants. Issued concurrently.
+     */
+    getHierarchy(): Promise<HierarchyView<this>>;
+    /**
+     * Reparent this row. Pass `null` to make it a root, an id string, or the
+     * target row itself. Refuses to:
+     *
+     * - move a row to itself (self-loop)
+     * - move a row under one of its own descendants (would create a cycle)
+     *
+     * Persists via `save()`. Caller is responsible for any out-of-band
+     * denormalization (e.g. depth caches on subclasses like Tag.level).
+     */
+    moveTo(newParent: this | string | null): Promise<void>;
+}
+//# sourceMappingURL=hierarchical.d.ts.map

package/dist/hierarchical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchical.d.ts","sourceRoot":"","sources":["../src/hierarchical.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAItC;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,gBAAgB;IACvD,SAAS,EAAE,CAAC,EAAE,CAAC;IACf,OAAO,EAAE,CAAC,CAAC;IACX,WAAW,EAAE,CAAC,EAAE,CAAC;CAClB;AAED,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,mBAAmB,EAAG,IAAI,CAAU;IAEpD,mEAAmE;IACnE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;cACa,oBAAoB,IAAI,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAgCrE;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAOvC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IASpC;;;;;;;OAOG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAmBrC;;;;;;;;;;;;;;OAcG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAgCvC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAQlD;;;;;;;;;OASG;IACG,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CA0B7D"}