@happyvertical/smrt-human-resources 0.0.0-stage → 0.53.6

package/dist/index.js

@@ -0,0 +1,2068 @@
+import { EMPLOYMENT_STATUS_TRANSITIONS, HrError, SUGGESTED_WORKER_TYPES } from "./types.js";
+import { HUMAN_RESOURCES_MODULE_META, HUMAN_RESOURCES_UI_SLOTS } from "./ui.js";
+import { ObjectRegistry, SmrtCollection, SmrtObject, crossPackageRef, field, foreignKey, isEmbeddedDatabase, isPostgresDatabase, smrt, withEmbeddedWriteQueue } from "@happyvertical/smrt-core";
+import { TenantScoped, getTenantId, tenantId, withTenant } from "@happyvertical/smrt-tenancy";
+import { createLogger } from "@happyvertical/logger";
+import { NestedTransactionError } from "@happyvertical/sql";
+//#region src/__smrt-register__.ts
+ObjectRegistry.registerPackageManifest(JSON.parse("{\"version\":\"1.0.0\",\"timestamp\":0,\"packageName\":\"@happyvertical/smrt-human-resources\",\"packageVersion\":\"0.53.6\",\"objects\":{\"@happyvertical/smrt-human-resources:Employment\":{\"name\":\"employment\",\"className\":\"Employment\",\"qualifiedName\":\"@happyvertical/smrt-human-resources:Employment\",\"collection\":\"employments\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/human-resources/src/employment/models.ts\",\"packageName\":\"@happyvertical/smrt-human-resources\",\"fields\":{\"tenantId\":{\"type\":\"text\",\"required\":true,\"_meta\":{\"sqlType\":\"UUID\",\"__tenancy\":{\"isTenantIdField\":true,\"autoFilter\":true,\"required\":true,\"autoPopulate\":true,\"nullable\":false,\"mode\":\"required\",\"field\":\"tenantId\",\"allowSuperAdminBypass\":false}}},\"profileId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"@happyvertical/smrt-profiles:Profile\",\"_meta\":{\"onDelete\":\"RESTRICT\"}},\"userId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"@happyvertical/smrt-users:User\",\"_meta\":{\"nullable\":true}},\"employerProfileId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"@happyvertical/smrt-profiles:Profile\",\"_meta\":{\"nullable\":true,\"onDelete\":\"RESTRICT\"}},\"employeeNumber\":{\"type\":\"text\",\"required\":false},\"workerType\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"position\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"status\":{\"type\":\"text\",\"required\":false,\"_meta\":{}}},\"methods\":{\"save\":{\"name\":\"save\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<this>\",\"isStatic\":false,\"isPublic\":true},\"delete\":{\"name\":\"delete\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<void>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"employments\",\"sensitive\":true,\"conflictColumns\":[\"tenant_id\",\"employee_number\"],\"indexes\":[{\"name\":\"employments_tenant_profile_uq\",\"columns\":[\"tenantId\",\"profileId\"],\"unique\":true},{\"name\":\"employments_tenant_user_idx\",\"columns\":[\"tenantId\",\"userId\"]}],\"api\":{\"include\":[]},\"cli\":{\"include\":[]},\"mcp\":{\"include\":[]},\"tenantScoped\":{\"mode\":\"required\"}},\"extends\":\"SmrtObject\",\"exportName\":\"Employment\",\"collectionExportName\":\"EmploymentCollection\",\"validationRules\":[],\"schema\":{\"tableName\":\"employments\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"employments\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID NOT NULL,\\n  \\\"profile_id\\\" UUID,\\n  \\\"user_id\\\" UUID,\\n  \\\"employer_profile_id\\\" UUID,\\n  \\\"employee_number\\\" TEXT,\\n  \\\"worker_type\\\" TEXT,\\n  \\\"position\\\" TEXT,\\n  \\\"status\\\" TEXT\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":true,\"unique\":false},\"profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"user_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"employer_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"employee_number\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"worker_type\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"position\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"status\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false}},\"indexes\":[{\"name\":\"employments_tenant_id_employee_number_idx\",\"columns\":[\"tenant_id\",\"employee_number\"],\"unique\":true,\"nullsNotDistinct\":true},{\"name\":\"employments_slug_context_idx\",\"columns\":[\"slug\",\"context\"]},{\"name\":\"employments_tenant_profile_uq\",\"columns\":[\"tenant_id\",\"profile_id\"],\"unique\":true},{\"name\":\"employments_tenant_user_idx\",\"columns\":[\"tenant_id\",\"user_id\"]},{\"name\":\"employments_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"employments_profile_id_idx\",\"columns\":[\"profile_id\"]},{\"name\":\"employments_user_id_idx\",\"columns\":[\"user_id\"]},{\"name\":\"employments_employer_profile_id_idx\",\"columns\":[\"employer_profile_id\"]}],\"version\":\"ff7ef7a8\"},\"importPath\":\"@happyvertical/smrt-human-resources\"},\"@happyvertical/smrt-human-resources:EmploymentTerm\":{\"name\":\"employmentterm\",\"className\":\"EmploymentTerm\",\"qualifiedName\":\"@happyvertical/smrt-human-resources:EmploymentTerm\",\"collection\":\"employmentterms\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/human-resources/src/employment/models.ts\",\"packageName\":\"@happyvertical/smrt-human-resources\",\"fields\":{\"tenantId\":{\"type\":\"text\",\"required\":true,\"_meta\":{\"sqlType\":\"UUID\",\"__tenancy\":{\"isTenantIdField\":true,\"autoFilter\":true,\"required\":true,\"autoPopulate\":true,\"nullable\":false,\"mode\":\"required\",\"field\":\"tenantId\",\"allowSuperAdminBypass\":false}}},\"employmentId\":{\"type\":\"foreignKey\",\"required\":false,\"related\":\"Employment\",\"_meta\":{\"onDelete\":\"RESTRICT\"}},\"startedOn\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"endedOn\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"endReason\":{\"type\":\"text\",\"required\":false}},\"methods\":{\"save\":{\"name\":\"save\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<this>\",\"isStatic\":false,\"isPublic\":true},\"delete\":{\"name\":\"delete\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<void>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"employment_terms\",\"sensitive\":true,\"indexes\":[{\"name\":\"employment_terms_employment_idx\",\"columns\":[\"tenantId\",\"employmentId\",\"startedOn\"]}],\"api\":{\"include\":[]},\"cli\":{\"include\":[]},\"mcp\":{\"include\":[]},\"tenantScoped\":{\"mode\":\"required\"},\"conflictColumns\":[\"tenant_id\",\"slug\",\"context\"]},\"extends\":\"SmrtObject\",\"exportName\":\"EmploymentTerm\",\"collectionExportName\":\"EmploymentTermCollection\",\"validationRules\":[],\"schema\":{\"tableName\":\"employment_terms\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"employment_terms\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID NOT NULL,\\n  \\\"employment_id\\\" UUID,\\n  \\\"started_on\\\" TEXT,\\n  \\\"ended_on\\\" TEXT,\\n  \\\"end_reason\\\" TEXT\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":true,\"unique\":false},\"employment_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"unique\":false,\"foreignKey\":{\"table\":\"employments\",\"column\":\"id\",\"onDelete\":\"RESTRICT\",\"onUpdate\":\"CASCADE\"}},\"started_on\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"ended_on\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"end_reason\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false}},\"indexes\":[{\"name\":\"employment_terms_slug_context_idx\",\"columns\":[\"tenant_id\",\"slug\",\"context\"],\"unique\":true},{\"name\":\"employment_terms_employment_idx\",\"columns\":[\"tenant_id\",\"employment_id\",\"started_on\"]},{\"name\":\"employment_terms_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"employment_terms_employment_id_idx\",\"columns\":[\"employment_id\"]}],\"version\":\"165d209b\"},\"importPath\":\"@happyvertical/smrt-human-resources\"},\"@happyvertical/smrt-human-resources:EmploymentChange\":{\"name\":\"employmentchange\",\"className\":\"EmploymentChange\",\"qualifiedName\":\"@happyvertical/smrt-human-resources:EmploymentChange\",\"collection\":\"employmentchanges\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/human-resources/src/employment/models.ts\",\"packageName\":\"@happyvertical/smrt-human-resources\",\"fields\":{\"tenantId\":{\"type\":\"text\",\"required\":true,\"_meta\":{\"sqlType\":\"UUID\",\"__tenancy\":{\"isTenantIdField\":true,\"autoFilter\":true,\"required\":true,\"autoPopulate\":true,\"nullable\":false,\"mode\":\"required\",\"field\":\"tenantId\",\"allowSuperAdminBypass\":false}}},\"employmentId\":{\"type\":\"foreignKey\",\"required\":false,\"related\":\"Employment\",\"_meta\":{\"onDelete\":\"RESTRICT\"}},\"kind\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"effectiveOn\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"fromValue\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"toValue\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"note\":{\"type\":\"text\",\"required\":false},\"actorProfileId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"@happyvertical/smrt-profiles:Profile\",\"_meta\":{\"onDelete\":\"RESTRICT\"}}},\"methods\":{\"save\":{\"name\":\"save\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<this>\",\"isStatic\":false,\"isPublic\":true},\"delete\":{\"name\":\"delete\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<void>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"employment_changes\",\"sensitive\":true,\"indexes\":[{\"name\":\"employment_changes_employment_idx\",\"columns\":[\"tenantId\",\"employmentId\",\"effectiveOn\"]}],\"api\":{\"include\":[]},\"cli\":{\"include\":[]},\"mcp\":{\"include\":[]},\"tenantScoped\":{\"mode\":\"required\"},\"conflictColumns\":[\"tenant_id\",\"slug\",\"context\"]},\"extends\":\"SmrtObject\",\"exportName\":\"EmploymentChange\",\"collectionExportName\":\"EmploymentChangeCollection\",\"validationRules\":[],\"schema\":{\"tableName\":\"employment_changes\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"employment_changes\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID NOT NULL,\\n  \\\"employment_id\\\" UUID,\\n  \\\"kind\\\" TEXT,\\n  \\\"effective_on\\\" TEXT,\\n  \\\"from_value\\\" TEXT,\\n  \\\"to_value\\\" TEXT,\\n  \\\"note\\\" TEXT,\\n  \\\"actor_profile_id\\\" UUID\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":true,\"unique\":false},\"employment_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"unique\":false,\"foreignKey\":{\"table\":\"employments\",\"column\":\"id\",\"onDelete\":\"RESTRICT\",\"onUpdate\":\"CASCADE\"}},\"kind\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"effective_on\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"from_value\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"to_value\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"note\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"actor_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false}},\"indexes\":[{\"name\":\"employment_changes_slug_context_idx\",\"columns\":[\"tenant_id\",\"slug\",\"context\"],\"unique\":true},{\"name\":\"employment_changes_employment_idx\",\"columns\":[\"tenant_id\",\"employment_id\",\"effective_on\"]},{\"name\":\"employment_changes_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"employment_changes_employment_id_idx\",\"columns\":[\"employment_id\"]},{\"name\":\"employment_changes_actor_profile_id_idx\",\"columns\":[\"actor_profile_id\"]}],\"version\":\"5d93422f\"},\"importPath\":\"@happyvertical/smrt-human-resources\"},\"@happyvertical/smrt-human-resources:EmploymentCollection\":{\"name\":\"employmentcollection\",\"className\":\"EmploymentCollection\",\"qualifiedName\":\"@happyvertical/smrt-human-resources:EmploymentCollection\",\"collection\":\"employments\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/human-resources/src/employment/models.ts\",\"packageName\":\"@happyvertical/smrt-human-resources\",\"fields\":{},\"methods\":{},\"decoratorConfig\":{\"api\":{\"include\":[]},\"mcp\":{\"include\":[]},\"cli\":false,\"tableName\":\"employments\"},\"extends\":\"SmrtCollection\",\"extendsTypeArg\":\"Employment\",\"exportName\":\"EmploymentCollection\",\"collectionExportName\":\"EmploymentCollectionCollection\",\"schema\":{\"tableName\":\"employments\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"employments\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID NOT NULL,\\n  \\\"profile_id\\\" UUID,\\n  \\\"user_id\\\" UUID,\\n  \\\"employer_profile_id\\\" UUID,\\n  \\\"employee_number\\\" TEXT,\\n  \\\"worker_type\\\" TEXT,\\n  \\\"position\\\" TEXT,\\n  \\\"status\\\" TEXT\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":true,\"unique\":false},\"profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"user_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"employer_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"employee_number\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"worker_type\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"position\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"status\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false}},\"indexes\":[{\"name\":\"employments_tenant_id_employee_number_idx\",\"columns\":[\"tenant_id\",\"employee_number\"],\"unique\":true,\"nullsNotDistinct\":true},{\"name\":\"employments_slug_context_idx\",\"columns\":[\"slug\",\"context\"]},{\"name\":\"employments_tenant_profile_uq\",\"columns\":[\"tenant_id\",\"profile_id\"],\"unique\":true},{\"name\":\"employments_tenant_user_idx\",\"columns\":[\"tenant_id\",\"user_id\"]},{\"name\":\"employments_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"employments_profile_id_idx\",\"columns\":[\"profile_id\"]},{\"name\":\"employments_user_id_idx\",\"columns\":[\"user_id\"]},{\"name\":\"employments_employer_profile_id_idx\",\"columns\":[\"employer_profile_id\"]}],\"version\":\"ff7ef7a8\"},\"importPath\":\"@happyvertical/smrt-human-resources\"},\"@happyvertical/smrt-human-resources:EmploymentTermCollection\":{\"name\":\"employmenttermcollection\",\"className\":\"EmploymentTermCollection\",\"qualifiedName\":\"@happyvertical/smrt-human-resources:EmploymentTermCollection\",\"collection\":\"employmentterms\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/human-resources/src/employment/models.ts\",\"packageName\":\"@happyvertical/smrt-human-resources\",\"fields\":{},\"methods\":{},\"decoratorConfig\":{\"api\":{\"include\":[]},\"mcp\":{\"include\":[]},\"cli\":false,\"tableName\":\"employment_terms\"},\"extends\":\"SmrtCollection\",\"extendsTypeArg\":\"EmploymentTerm\",\"exportName\":\"EmploymentTermCollection\",\"collectionExportName\":\"EmploymentTermCollectionCollection\",\"schema\":{\"tableName\":\"employment_terms\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"employment_terms\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID NOT NULL,\\n  \\\"employment_id\\\" UUID,\\n  \\\"started_on\\\" TEXT,\\n  \\\"ended_on\\\" TEXT,\\n  \\\"end_reason\\\" TEXT\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":true,\"unique\":false},\"employment_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"unique\":false,\"foreignKey\":{\"table\":\"employments\",\"column\":\"id\",\"onDelete\":\"RESTRICT\",\"onUpdate\":\"CASCADE\"}},\"started_on\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"ended_on\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"end_reason\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false}},\"indexes\":[{\"name\":\"employment_terms_slug_context_idx\",\"columns\":[\"tenant_id\",\"slug\",\"context\"],\"unique\":true},{\"name\":\"employment_terms_employment_idx\",\"columns\":[\"tenant_id\",\"employment_id\",\"started_on\"]},{\"name\":\"employment_terms_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"employment_terms_employment_id_idx\",\"columns\":[\"employment_id\"]}],\"version\":\"165d209b\"},\"importPath\":\"@happyvertical/smrt-human-resources\"},\"@happyvertical/smrt-human-resources:EmploymentChangeCollection\":{\"name\":\"employmentchangecollection\",\"className\":\"EmploymentChangeCollection\",\"qualifiedName\":\"@happyvertical/smrt-human-resources:EmploymentChangeCollection\",\"collection\":\"employmentchanges\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/human-resources/src/employment/models.ts\",\"packageName\":\"@happyvertical/smrt-human-resources\",\"fields\":{},\"methods\":{},\"decoratorConfig\":{\"api\":{\"include\":[]},\"mcp\":{\"include\":[]},\"cli\":false,\"tableName\":\"employment_changes\"},\"extends\":\"SmrtCollection\",\"extendsTypeArg\":\"EmploymentChange\",\"exportName\":\"EmploymentChangeCollection\",\"collectionExportName\":\"EmploymentChangeCollectionCollection\",\"schema\":{\"tableName\":\"employment_changes\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"employment_changes\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID NOT NULL,\\n  \\\"employment_id\\\" UUID,\\n  \\\"kind\\\" TEXT,\\n  \\\"effective_on\\\" TEXT,\\n  \\\"from_value\\\" TEXT,\\n  \\\"to_value\\\" TEXT,\\n  \\\"note\\\" TEXT,\\n  \\\"actor_profile_id\\\" UUID\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":true,\"unique\":false},\"employment_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"unique\":false,\"foreignKey\":{\"table\":\"employments\",\"column\":\"id\",\"onDelete\":\"RESTRICT\",\"onUpdate\":\"CASCADE\"}},\"kind\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"effective_on\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"from_value\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"to_value\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"note\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"actor_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false}},\"indexes\":[{\"name\":\"employment_changes_slug_context_idx\",\"columns\":[\"tenant_id\",\"slug\",\"context\"],\"unique\":true},{\"name\":\"employment_changes_employment_idx\",\"columns\":[\"tenant_id\",\"employment_id\",\"effective_on\"]},{\"name\":\"employment_changes_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"employment_changes_employment_id_idx\",\"columns\":[\"employment_id\"]},{\"name\":\"employment_changes_actor_profile_id_idx\",\"columns\":[\"actor_profile_id\"]}],\"version\":\"5d93422f\"},\"importPath\":\"@happyvertical/smrt-human-resources\"},\"@happyvertical/smrt-human-resources:Qualification\":{\"name\":\"qualification\",\"className\":\"Qualification\",\"qualifiedName\":\"@happyvertical/smrt-human-resources:Qualification\",\"collection\":\"qualifications\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/human-resources/src/qualifications/models.ts\",\"packageName\":\"@happyvertical/smrt-human-resources\",\"fields\":{\"tenantId\":{\"type\":\"text\",\"required\":true,\"_meta\":{\"sqlType\":\"UUID\",\"__tenancy\":{\"isTenantIdField\":true,\"autoFilter\":true,\"required\":true,\"autoPopulate\":true,\"nullable\":false,\"mode\":\"required\",\"field\":\"tenantId\",\"allowSuperAdminBypass\":false}}},\"key\":{\"type\":\"text\",\"required\":false},\"name\":{\"type\":\"text\",\"required\":false},\"kind\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"issuingBody\":{\"type\":\"text\",\"required\":false},\"expires\":{\"type\":\"boolean\",\"required\":true,\"default\":false},\"validityMonths\":{\"type\":\"integer\",\"required\":false,\"_meta\":{\"nullable\":true}},\"scope\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"isActive\":{\"type\":\"boolean\",\"required\":true,\"default\":true}},\"methods\":{\"save\":{\"name\":\"save\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<this>\",\"isStatic\":false,\"isPublic\":true},\"delete\":{\"name\":\"delete\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<void>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"qualifications\",\"sensitive\":true,\"conflictColumns\":[\"tenant_id\",\"key\"],\"api\":{\"include\":[]},\"cli\":{\"include\":[]},\"mcp\":{\"include\":[]},\"tenantScoped\":{\"mode\":\"required\"}},\"extends\":\"SmrtObject\",\"exportName\":\"Qualification\",\"collectionExportName\":\"QualificationCollection\",\"validationRules\":[{\"field\":\"expires\",\"rule\":\"required\",\"fieldType\":\"boolean\"},{\"field\":\"isActive\",\"rule\":\"required\",\"fieldType\":\"boolean\"}],\"schema\":{\"tableName\":\"qualifications\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"qualifications\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID NOT NULL,\\n  \\\"key\\\" TEXT,\\n  \\\"name\\\" TEXT,\\n  \\\"kind\\\" TEXT,\\n  \\\"issuing_body\\\" TEXT,\\n  \\\"expires\\\" BOOLEAN NOT NULL DEFAULT FALSE,\\n  \\\"validity_months\\\" INTEGER,\\n  \\\"scope\\\" TEXT,\\n  \\\"is_active\\\" BOOLEAN NOT NULL DEFAULT TRUE\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":true,\"unique\":false},\"key\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"name\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"kind\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"issuing_body\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"expires\":{\"type\":\"BOOLEAN\",\"notNull\":true,\"unique\":false,\"default\":false},\"validity_months\":{\"type\":\"INTEGER\",\"notNull\":false,\"unique\":false},\"scope\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"is_active\":{\"type\":\"BOOLEAN\",\"notNull\":true,\"unique\":false,\"default\":true}},\"indexes\":[{\"name\":\"qualifications_tenant_id_key_idx\",\"columns\":[\"tenant_id\",\"key\"],\"unique\":true,\"nullsNotDistinct\":true},{\"name\":\"qualifications_slug_context_idx\",\"columns\":[\"slug\",\"context\"]},{\"name\":\"qualifications_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]}],\"version\":\"c9fa3721\"},\"importPath\":\"@happyvertical/smrt-human-resources\"},\"@happyvertical/smrt-human-resources:HeldQualification\":{\"name\":\"heldqualification\",\"className\":\"HeldQualification\",\"qualifiedName\":\"@happyvertical/smrt-human-resources:HeldQualification\",\"collection\":\"heldqualifications\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/human-resources/src/qualifications/models.ts\",\"packageName\":\"@happyvertical/smrt-human-resources\",\"fields\":{\"tenantId\":{\"type\":\"text\",\"required\":true,\"_meta\":{\"sqlType\":\"UUID\",\"__tenancy\":{\"isTenantIdField\":true,\"autoFilter\":true,\"required\":true,\"autoPopulate\":true,\"nullable\":false,\"mode\":\"required\",\"field\":\"tenantId\",\"allowSuperAdminBypass\":false}}},\"qualificationId\":{\"type\":\"foreignKey\",\"required\":false,\"related\":\"Qualification\",\"_meta\":{\"onDelete\":\"RESTRICT\"}},\"profileId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"@happyvertical/smrt-profiles:Profile\",\"_meta\":{\"onDelete\":\"RESTRICT\"}},\"employmentId\":{\"type\":\"foreignKey\",\"required\":false,\"related\":\"Employment\",\"_meta\":{\"nullable\":true,\"onDelete\":\"RESTRICT\"}},\"issuedOn\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"expiresOn\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"certificateNumber\":{\"type\":\"text\",\"required\":false},\"status\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"verifiedByProfileId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"@happyvertical/smrt-profiles:Profile\",\"_meta\":{\"nullable\":true,\"onDelete\":\"RESTRICT\"}},\"verifiedAt\":{\"type\":\"datetime\",\"required\":false},\"documentAssetId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"@happyvertical/smrt-assets:Asset\",\"_meta\":{\"nullable\":true}},\"renewalOfId\":{\"type\":\"foreignKey\",\"required\":false,\"related\":\"HeldQualification\",\"_meta\":{\"nullable\":true,\"onDelete\":\"RESTRICT\"}}},\"methods\":{\"save\":{\"name\":\"save\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<this>\",\"isStatic\":false,\"isPublic\":true},\"delete\":{\"name\":\"delete\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<void>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"held_qualifications\",\"sensitive\":true,\"indexes\":[{\"name\":\"held_qualifications_profile_idx\",\"columns\":[\"tenantId\",\"profileId\",\"qualificationId\"]},{\"name\":\"held_qualifications_expiry_idx\",\"columns\":[\"tenantId\",\"status\",\"expiresOn\"]}],\"api\":{\"include\":[]},\"cli\":{\"include\":[]},\"mcp\":{\"include\":[]},\"tenantScoped\":{\"mode\":\"required\"},\"conflictColumns\":[\"tenant_id\",\"slug\",\"context\"]},\"extends\":\"SmrtObject\",\"exportName\":\"HeldQualification\",\"collectionExportName\":\"HeldQualificationCollection\",\"validationRules\":[],\"schema\":{\"tableName\":\"held_qualifications\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"held_qualifications\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID NOT NULL,\\n  \\\"qualification_id\\\" UUID,\\n  \\\"profile_id\\\" UUID,\\n  \\\"employment_id\\\" UUID,\\n  \\\"issued_on\\\" TEXT,\\n  \\\"expires_on\\\" TEXT,\\n  \\\"certificate_number\\\" TEXT,\\n  \\\"status\\\" TEXT,\\n  \\\"verified_by_profile_id\\\" UUID,\\n  \\\"verified_at\\\" TIMESTAMP,\\n  \\\"document_asset_id\\\" UUID,\\n  \\\"renewal_of_id\\\" UUID\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":true,\"unique\":false},\"qualification_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"unique\":false,\"foreignKey\":{\"table\":\"qualifications\",\"column\":\"id\",\"onDelete\":\"RESTRICT\",\"onUpdate\":\"CASCADE\"}},\"profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"employment_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"unique\":false,\"foreignKey\":{\"table\":\"employments\",\"column\":\"id\",\"onDelete\":\"RESTRICT\",\"onUpdate\":\"CASCADE\"}},\"issued_on\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"expires_on\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"certificate_number\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"status\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"verified_by_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"verified_at\":{\"type\":\"TIMESTAMP\",\"notNull\":false,\"unique\":false},\"document_asset_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"renewal_of_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"unique\":false,\"foreignKey\":{\"table\":\"held_qualifications\",\"column\":\"id\",\"onDelete\":\"RESTRICT\",\"onUpdate\":\"CASCADE\"}}},\"indexes\":[{\"name\":\"held_qualifications_slug_context_idx\",\"columns\":[\"tenant_id\",\"slug\",\"context\"],\"unique\":true},{\"name\":\"held_qualifications_profile_idx\",\"columns\":[\"tenant_id\",\"profile_id\",\"qualification_id\"]},{\"name\":\"held_qualifications_expiry_idx\",\"columns\":[\"tenant_id\",\"status\",\"expires_on\"]},{\"name\":\"held_qualifications_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"held_qualifications_qualification_id_idx\",\"columns\":[\"qualification_id\"]},{\"name\":\"held_qualifications_profile_id_idx\",\"columns\":[\"profile_id\"]},{\"name\":\"held_qualifications_employment_id_idx\",\"columns\":[\"employment_id\"]},{\"name\":\"held_qualifications_verified_by_profile_id_idx\",\"columns\":[\"verified_by_profile_id\"]},{\"name\":\"held_qualifications_document_asset_id_idx\",\"columns\":[\"document_asset_id\"]},{\"name\":\"held_qualifications_renewal_of_id_idx\",\"columns\":[\"renewal_of_id\"]}],\"version\":\"fafbe37f\"},\"importPath\":\"@happyvertical/smrt-human-resources\"},\"@happyvertical/smrt-human-resources:HeldQualificationChange\":{\"name\":\"heldqualificationchange\",\"className\":\"HeldQualificationChange\",\"qualifiedName\":\"@happyvertical/smrt-human-resources:HeldQualificationChange\",\"collection\":\"heldqualificationchanges\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/human-resources/src/qualifications/models.ts\",\"packageName\":\"@happyvertical/smrt-human-resources\",\"fields\":{\"tenantId\":{\"type\":\"text\",\"required\":true,\"_meta\":{\"sqlType\":\"UUID\",\"__tenancy\":{\"isTenantIdField\":true,\"autoFilter\":true,\"required\":true,\"autoPopulate\":true,\"nullable\":false,\"mode\":\"required\",\"field\":\"tenantId\",\"allowSuperAdminBypass\":false}}},\"heldQualificationId\":{\"type\":\"foreignKey\",\"required\":false,\"related\":\"HeldQualification\",\"_meta\":{\"onDelete\":\"RESTRICT\"}},\"kind\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"effectiveOn\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"reason\":{\"type\":\"text\",\"required\":false},\"actorProfileId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"@happyvertical/smrt-profiles:Profile\",\"_meta\":{\"onDelete\":\"RESTRICT\"}}},\"methods\":{\"save\":{\"name\":\"save\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<this>\",\"isStatic\":false,\"isPublic\":true},\"delete\":{\"name\":\"delete\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<void>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"held_qualification_changes\",\"sensitive\":true,\"indexes\":[{\"name\":\"held_qualification_changes_held_idx\",\"columns\":[\"tenantId\",\"heldQualificationId\",\"effectiveOn\"]}],\"api\":{\"include\":[]},\"cli\":{\"include\":[]},\"mcp\":{\"include\":[]},\"tenantScoped\":{\"mode\":\"required\"},\"conflictColumns\":[\"tenant_id\",\"slug\",\"context\"]},\"extends\":\"SmrtObject\",\"exportName\":\"HeldQualificationChange\",\"collectionExportName\":\"HeldQualificationChangeCollection\",\"validationRules\":[],\"schema\":{\"tableName\":\"held_qualification_changes\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"held_qualification_changes\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID NOT NULL,\\n  \\\"held_qualification_id\\\" UUID,\\n  \\\"kind\\\" TEXT,\\n  \\\"effective_on\\\" TEXT,\\n  \\\"reason\\\" TEXT,\\n  \\\"actor_profile_id\\\" UUID\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":true,\"unique\":false},\"held_qualification_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"unique\":false,\"foreignKey\":{\"table\":\"held_qualifications\",\"column\":\"id\",\"onDelete\":\"RESTRICT\",\"onUpdate\":\"CASCADE\"}},\"kind\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"effective_on\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"reason\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"actor_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false}},\"indexes\":[{\"name\":\"held_qualification_changes_slug_context_idx\",\"columns\":[\"tenant_id\",\"slug\",\"context\"],\"unique\":true},{\"name\":\"held_qualification_changes_held_idx\",\"columns\":[\"tenant_id\",\"held_qualification_id\",\"effective_on\"]},{\"name\":\"held_qualification_changes_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"held_qualification_changes_held_qualification_id_idx\",\"columns\":[\"held_qualification_id\"]},{\"name\":\"held_qualification_changes_actor_profile_id_idx\",\"columns\":[\"actor_profile_id\"]}],\"version\":\"ed9ed5e1\"},\"importPath\":\"@happyvertical/smrt-human-resources\"},\"@happyvertical/smrt-human-resources:QualificationCollection\":{\"name\":\"qualificationcollection\",\"className\":\"QualificationCollection\",\"qualifiedName\":\"@happyvertical/smrt-human-resources:QualificationCollection\",\"collection\":\"qualifications\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/human-resources/src/qualifications/models.ts\",\"packageName\":\"@happyvertical/smrt-human-resources\",\"fields\":{},\"methods\":{},\"decoratorConfig\":{\"api\":{\"include\":[]},\"mcp\":{\"include\":[]},\"cli\":false,\"tableName\":\"qualifications\"},\"extends\":\"SmrtCollection\",\"extendsTypeArg\":\"Qualification\",\"exportName\":\"QualificationCollection\",\"collectionExportName\":\"QualificationCollectionCollection\",\"schema\":{\"tableName\":\"qualifications\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"qualifications\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID NOT NULL,\\n  \\\"key\\\" TEXT,\\n  \\\"name\\\" TEXT,\\n  \\\"kind\\\" TEXT,\\n  \\\"issuing_body\\\" TEXT,\\n  \\\"expires\\\" BOOLEAN NOT NULL DEFAULT FALSE,\\n  \\\"validity_months\\\" INTEGER,\\n  \\\"scope\\\" TEXT,\\n  \\\"is_active\\\" BOOLEAN NOT NULL DEFAULT TRUE\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":true,\"unique\":false},\"key\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"name\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"kind\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"issuing_body\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"expires\":{\"type\":\"BOOLEAN\",\"notNull\":true,\"unique\":false,\"default\":false},\"validity_months\":{\"type\":\"INTEGER\",\"notNull\":false,\"unique\":false},\"scope\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"is_active\":{\"type\":\"BOOLEAN\",\"notNull\":true,\"unique\":false,\"default\":true}},\"indexes\":[{\"name\":\"qualifications_tenant_id_key_idx\",\"columns\":[\"tenant_id\",\"key\"],\"unique\":true,\"nullsNotDistinct\":true},{\"name\":\"qualifications_slug_context_idx\",\"columns\":[\"slug\",\"context\"]},{\"name\":\"qualifications_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]}],\"version\":\"c9fa3721\"},\"importPath\":\"@happyvertical/smrt-human-resources\"},\"@happyvertical/smrt-human-resources:HeldQualificationCollection\":{\"name\":\"heldqualificationcollection\",\"className\":\"HeldQualificationCollection\",\"qualifiedName\":\"@happyvertical/smrt-human-resources:HeldQualificationCollection\",\"collection\":\"heldqualifications\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/human-resources/src/qualifications/models.ts\",\"packageName\":\"@happyvertical/smrt-human-resources\",\"fields\":{},\"methods\":{},\"decoratorConfig\":{\"api\":{\"include\":[]},\"mcp\":{\"include\":[]},\"cli\":false,\"tableName\":\"held_qualifications\"},\"extends\":\"SmrtCollection\",\"extendsTypeArg\":\"HeldQualification\",\"exportName\":\"HeldQualificationCollection\",\"collectionExportName\":\"HeldQualificationCollectionCollection\",\"schema\":{\"tableName\":\"held_qualifications\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"held_qualifications\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID NOT NULL,\\n  \\\"qualification_id\\\" UUID,\\n  \\\"profile_id\\\" UUID,\\n  \\\"employment_id\\\" UUID,\\n  \\\"issued_on\\\" TEXT,\\n  \\\"expires_on\\\" TEXT,\\n  \\\"certificate_number\\\" TEXT,\\n  \\\"status\\\" TEXT,\\n  \\\"verified_by_profile_id\\\" UUID,\\n  \\\"verified_at\\\" TIMESTAMP,\\n  \\\"document_asset_id\\\" UUID,\\n  \\\"renewal_of_id\\\" UUID\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":true,\"unique\":false},\"qualification_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"unique\":false,\"foreignKey\":{\"table\":\"qualifications\",\"column\":\"id\",\"onDelete\":\"RESTRICT\",\"onUpdate\":\"CASCADE\"}},\"profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"employment_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"unique\":false,\"foreignKey\":{\"table\":\"employments\",\"column\":\"id\",\"onDelete\":\"RESTRICT\",\"onUpdate\":\"CASCADE\"}},\"issued_on\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"expires_on\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"certificate_number\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"status\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"verified_by_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"verified_at\":{\"type\":\"TIMESTAMP\",\"notNull\":false,\"unique\":false},\"document_asset_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"renewal_of_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"unique\":false,\"foreignKey\":{\"table\":\"held_qualifications\",\"column\":\"id\",\"onDelete\":\"RESTRICT\",\"onUpdate\":\"CASCADE\"}}},\"indexes\":[{\"name\":\"held_qualifications_slug_context_idx\",\"columns\":[\"tenant_id\",\"slug\",\"context\"],\"unique\":true},{\"name\":\"held_qualifications_profile_idx\",\"columns\":[\"tenant_id\",\"profile_id\",\"qualification_id\"]},{\"name\":\"held_qualifications_expiry_idx\",\"columns\":[\"tenant_id\",\"status\",\"expires_on\"]},{\"name\":\"held_qualifications_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"held_qualifications_qualification_id_idx\",\"columns\":[\"qualification_id\"]},{\"name\":\"held_qualifications_profile_id_idx\",\"columns\":[\"profile_id\"]},{\"name\":\"held_qualifications_employment_id_idx\",\"columns\":[\"employment_id\"]},{\"name\":\"held_qualifications_verified_by_profile_id_idx\",\"columns\":[\"verified_by_profile_id\"]},{\"name\":\"held_qualifications_document_asset_id_idx\",\"columns\":[\"document_asset_id\"]},{\"name\":\"held_qualifications_renewal_of_id_idx\",\"columns\":[\"renewal_of_id\"]}],\"version\":\"fafbe37f\"},\"importPath\":\"@happyvertical/smrt-human-resources\"},\"@happyvertical/smrt-human-resources:HeldQualificationChangeCollection\":{\"name\":\"heldqualificationchangecollection\",\"className\":\"HeldQualificationChangeCollection\",\"qualifiedName\":\"@happyvertical/smrt-human-resources:HeldQualificationChangeCollection\",\"collection\":\"heldqualificationchanges\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/human-resources/src/qualifications/models.ts\",\"packageName\":\"@happyvertical/smrt-human-resources\",\"fields\":{},\"methods\":{},\"decoratorConfig\":{\"api\":{\"include\":[]},\"mcp\":{\"include\":[]},\"cli\":false,\"tableName\":\"held_qualification_changes\"},\"extends\":\"SmrtCollection\",\"extendsTypeArg\":\"HeldQualificationChange\",\"exportName\":\"HeldQualificationChangeCollection\",\"collectionExportName\":\"HeldQualificationChangeCollectionCollection\",\"schema\":{\"tableName\":\"held_qualification_changes\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"held_qualification_changes\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID NOT NULL,\\n  \\\"held_qualification_id\\\" UUID,\\n  \\\"kind\\\" TEXT,\\n  \\\"effective_on\\\" TEXT,\\n  \\\"reason\\\" TEXT,\\n  \\\"actor_profile_id\\\" UUID\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":true,\"unique\":false},\"held_qualification_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"unique\":false,\"foreignKey\":{\"table\":\"held_qualifications\",\"column\":\"id\",\"onDelete\":\"RESTRICT\",\"onUpdate\":\"CASCADE\"}},\"kind\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"effective_on\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"reason\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"actor_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false}},\"indexes\":[{\"name\":\"held_qualification_changes_slug_context_idx\",\"columns\":[\"tenant_id\",\"slug\",\"context\"],\"unique\":true},{\"name\":\"held_qualification_changes_held_idx\",\"columns\":[\"tenant_id\",\"held_qualification_id\",\"effective_on\"]},{\"name\":\"held_qualification_changes_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"held_qualification_changes_held_qualification_id_idx\",\"columns\":[\"held_qualification_id\"]},{\"name\":\"held_qualification_changes_actor_profile_id_idx\",\"columns\":[\"actor_profile_id\"]}],\"version\":\"ed9ed5e1\"},\"importPath\":\"@happyvertical/smrt-human-resources\"}},\"moduleType\":\"smrt\",\"smrtDependencies\":[\"@happyvertical/smrt-core\",\"@happyvertical/smrt-tenancy\"]}"));
+//#endregion
+//#region src/dates.ts
+var ISO_DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
+function isIsoDate(value) {
+	if (typeof value !== "string") return false;
+	const match = ISO_DATE.exec(value);
+	if (!match) return false;
+	const [year, month, day] = match.slice(1).map(Number);
+	const date = new Date(Date.UTC(year, month - 1, day));
+	return date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day;
+}
+function assertIsoDate(fieldName, value) {
+	if (!isIsoDate(value)) throw new HrError("HR_INVALID", `${fieldName} must be a calendar date written YYYY-MM-DD, got '${String(value)}'.`);
+	return value;
+}
+function addDays(date, days) {
+	const [year, month, day] = assertIsoDate("date", date).split("-").map(Number);
+	return new Date(Date.UTC(year, month - 1, day + days)).toISOString().slice(0, 10);
+}
+function addMonths(date, months) {
+	const [year, month, day] = assertIsoDate("date", date).split("-").map(Number);
+	const first = new Date(Date.UTC(year, month - 1 + months, 1));
+	const lastDay = new Date(Date.UTC(first.getUTCFullYear(), first.getUTCMonth() + 1, 0)).getUTCDate();
+	first.setUTCDate(Math.min(day, lastDay));
+	return first.toISOString().slice(0, 10);
+}
+function dateWithin(on, start, end) {
+	return start <= on && (end === null || on <= end);
+}
+//#endregion
+//#region src/write.ts
+var permitted = /* @__PURE__ */ new WeakSet();
+function hasHrWrite(object) {
+	return permitted.has(object);
+}
+function assertHrWrite(object) {
+	if (!hasHrWrite(object)) throw new HrError("HR_WRITE_FORBIDDEN", "HR records are writable only through EmploymentService and QualificationService.");
+}
+async function persistHr(object) {
+	permitted.add(object);
+	try {
+		await object.save();
+		return object;
+	} finally {
+		permitted.delete(object);
+	}
+}
+async function insertHr(Model, db, values) {
+	const row = await new Model({
+		db,
+		_skipLoad: true,
+		...values
+	}).initialize();
+	row.requireInsertOnSave();
+	return persistHr(row);
+}
+//#endregion
+//#region src/employment/models.ts
+var __defProp$1 = Object.defineProperty;
+var __getOwnPropDesc$1 = Object.getOwnPropertyDescriptor;
+var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, {
+	enumerable: true,
+	configurable: true,
+	writable: true,
+	value
+}) : obj[key] = value;
+var __decorateClass$1 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$1(target, key) : target;
+	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+	if (kind && result) __defProp$1(target, key, result);
+	return result;
+};
+var __publicField$1 = (obj, key, value) => __defNormalProp$1(obj, typeof key !== "symbol" ? key + "" : key, value);
+var PACKAGE_OWNED_COLUMNS = [
+	["tenant_id", "tenantId"],
+	["profile_id", "profileId"],
+	["user_id", "userId"],
+	["employer_profile_id", "employerProfileId"],
+	["employee_number", "employeeNumber"],
+	["worker_type", "workerType"],
+	["position", "position"],
+	["status", "status"]
+];
+var Employment = class extends SmrtObject {
+	tenantId = "";
+	profileId = "";
+	userId = null;
+	employerProfileId = null;
+	/** Free text, unique per tenant. */
+	employeeNumber = "";
+	workerType = "employee";
+	position = null;
+	status = "active";
+	async save() {
+		const prior = this.id ? await this.db.get(this.tableName, { id: this.id }) : null;
+		if (!hasHrWrite(this) && (!prior || PACKAGE_OWNED_COLUMNS.some(([column, property]) => (prior[column] ?? null) !== (this[property] ?? null)))) throw new HrError("HR_WRITE_FORBIDDEN", "Employment columns owned by the HR package are writable only through EmploymentService.");
+		if (prior && (prior.tenant_id !== this.tenantId || prior.profile_id !== this.profileId)) throw new HrError("HR_HISTORY_IMMUTABLE", "Employment identity is immutable.");
+		return await super.save();
+	}
+	async delete() {
+		throw new HrError("HR_HISTORY_IMMUTABLE", "Employment history cannot be deleted; end the employment instead.");
+	}
+};
+__decorateClass$1([tenantId()], Employment.prototype, "tenantId", 2);
+__decorateClass$1([crossPackageRef("@happyvertical/smrt-profiles:Profile", { onDelete: "RESTRICT" })], Employment.prototype, "profileId", 2);
+__decorateClass$1([crossPackageRef("@happyvertical/smrt-users:User", { nullable: true })], Employment.prototype, "userId", 2);
+__decorateClass$1([crossPackageRef("@happyvertical/smrt-profiles:Profile", {
+	nullable: true,
+	onDelete: "RESTRICT"
+})], Employment.prototype, "employerProfileId", 2);
+__decorateClass$1([field({ type: "text" })], Employment.prototype, "workerType", 2);
+__decorateClass$1([field({
+	type: "text",
+	nullable: true
+})], Employment.prototype, "position", 2);
+__decorateClass$1([field({ type: "text" })], Employment.prototype, "status", 2);
+Employment = __decorateClass$1([TenantScoped({ mode: "required" }), smrt({
+	tableName: "employments",
+	sensitive: true,
+	conflictColumns: ["tenant_id", "employee_number"],
+	indexes: [{
+		name: "employments_tenant_profile_uq",
+		columns: ["tenantId", "profileId"],
+		unique: true
+	}, {
+		name: "employments_tenant_user_idx",
+		columns: ["tenantId", "userId"]
+	}],
+	api: { include: [] },
+	cli: { include: [] },
+	mcp: { include: [] }
+})], Employment);
+var EmploymentTerm = class extends SmrtObject {
+	tenantId = "";
+	employmentId = "";
+	startedOn = "";
+	endedOn = null;
+	endReason = "";
+	async save() {
+		assertHrWrite(this);
+		const prior = this.id ? await this.db.get(this.tableName, { id: this.id }) : null;
+		if (prior && (prior.ended_on != null || prior.employment_id !== this.employmentId || prior.started_on !== this.startedOn)) throw new HrError("HR_HISTORY_IMMUTABLE", "A term can only be closed once; its start and employment never change.");
+		return await super.save();
+	}
+	async delete() {
+		throw new HrError("HR_HISTORY_IMMUTABLE", "Employment terms cannot be deleted.");
+	}
+};
+__decorateClass$1([tenantId()], EmploymentTerm.prototype, "tenantId", 2);
+__decorateClass$1([foreignKey("Employment", { onDelete: "RESTRICT" })], EmploymentTerm.prototype, "employmentId", 2);
+__decorateClass$1([field({ type: "text" })], EmploymentTerm.prototype, "startedOn", 2);
+__decorateClass$1([field({
+	type: "text",
+	nullable: true
+})], EmploymentTerm.prototype, "endedOn", 2);
+EmploymentTerm = __decorateClass$1([TenantScoped({ mode: "required" }), smrt({
+	tableName: "employment_terms",
+	sensitive: true,
+	indexes: [{
+		name: "employment_terms_employment_idx",
+		columns: [
+			"tenantId",
+			"employmentId",
+			"startedOn"
+		]
+	}],
+	api: { include: [] },
+	cli: { include: [] },
+	mcp: { include: [] }
+})], EmploymentTerm);
+var EmploymentChange = class extends SmrtObject {
+	tenantId = "";
+	employmentId = "";
+	kind = "hired";
+	effectiveOn = "";
+	fromValue = null;
+	toValue = null;
+	note = "";
+	actorProfileId = "";
+	async save() {
+		assertHrWrite(this);
+		if (this.id && await this.db.get(this.tableName, { id: this.id })) throw new HrError("HR_HISTORY_IMMUTABLE", "Employment changes are append-only.");
+		this.requireInsertOnSave();
+		return await super.save();
+	}
+	async delete() {
+		throw new HrError("HR_HISTORY_IMMUTABLE", "Employment changes cannot be deleted.");
+	}
+};
+__decorateClass$1([tenantId()], EmploymentChange.prototype, "tenantId", 2);
+__decorateClass$1([foreignKey("Employment", { onDelete: "RESTRICT" })], EmploymentChange.prototype, "employmentId", 2);
+__decorateClass$1([field({ type: "text" })], EmploymentChange.prototype, "kind", 2);
+__decorateClass$1([field({ type: "text" })], EmploymentChange.prototype, "effectiveOn", 2);
+__decorateClass$1([field({
+	type: "text",
+	nullable: true
+})], EmploymentChange.prototype, "fromValue", 2);
+__decorateClass$1([field({
+	type: "text",
+	nullable: true
+})], EmploymentChange.prototype, "toValue", 2);
+__decorateClass$1([crossPackageRef("@happyvertical/smrt-profiles:Profile", { onDelete: "RESTRICT" })], EmploymentChange.prototype, "actorProfileId", 2);
+EmploymentChange = __decorateClass$1([TenantScoped({ mode: "required" }), smrt({
+	tableName: "employment_changes",
+	sensitive: true,
+	indexes: [{
+		name: "employment_changes_employment_idx",
+		columns: [
+			"tenantId",
+			"employmentId",
+			"effectiveOn"
+		]
+	}],
+	api: { include: [] },
+	cli: { include: [] },
+	mcp: { include: [] }
+})], EmploymentChange);
+var EmploymentCollection = class extends SmrtCollection {};
+__publicField$1(EmploymentCollection, "_itemClass", Employment);
+EmploymentCollection = __decorateClass$1([smrt({
+	api: { include: [] },
+	mcp: { include: [] },
+	cli: false
+})], EmploymentCollection);
+var EmploymentTermCollection = class extends SmrtCollection {};
+__publicField$1(EmploymentTermCollection, "_itemClass", EmploymentTerm);
+EmploymentTermCollection = __decorateClass$1([smrt({
+	api: { include: [] },
+	mcp: { include: [] },
+	cli: false
+})], EmploymentTermCollection);
+var EmploymentChangeCollection = class extends SmrtCollection {};
+__publicField$1(EmploymentChangeCollection, "_itemClass", EmploymentChange);
+EmploymentChangeCollection = __decorateClass$1([smrt({
+	api: { include: [] },
+	mcp: { include: [] },
+	cli: false
+})], EmploymentChangeCollection);
+//#endregion
+//#region src/qualifications/models.ts
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, {
+	enumerable: true,
+	configurable: true,
+	writable: true,
+	value
+}) : obj[key] = value;
+var __decorateClass = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+	if (kind && result) __defProp(target, key, result);
+	return result;
+};
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var Qualification = class extends SmrtObject {
+	tenantId = "";
+	/** Lowercase kebab-case, unique per tenant: `first-aid`. */
+	key = "";
+	name = "";
+	kind = "certification";
+	issuingBody = "";
+	/** Whether held qualifications of this kind expire. */
+	expires = false;
+	validityMonths = null;
+	scope = "person";
+	isActive = true;
+	async save() {
+		assertHrWrite(this);
+		const prior = this.id ? await this.db.get(this.tableName, { id: this.id }) : null;
+		if (prior && (prior.key !== this.key || prior.scope !== this.scope)) throw new HrError("HR_HISTORY_IMMUTABLE", "A qualification key and scope are immutable; deactivate it instead.");
+		return await super.save();
+	}
+	async delete() {
+		throw new HrError("HR_HISTORY_IMMUTABLE", "Qualifications cannot be deleted; deactivate them instead.");
+	}
+};
+__decorateClass([tenantId()], Qualification.prototype, "tenantId", 2);
+__decorateClass([field({ type: "text" })], Qualification.prototype, "kind", 2);
+__decorateClass([field({
+	type: "integer",
+	nullable: true
+})], Qualification.prototype, "validityMonths", 2);
+__decorateClass([field({ type: "text" })], Qualification.prototype, "scope", 2);
+Qualification = __decorateClass([TenantScoped({ mode: "required" }), smrt({
+	tableName: "qualifications",
+	sensitive: true,
+	conflictColumns: ["tenant_id", "key"],
+	api: { include: [] },
+	cli: { include: [] },
+	mcp: { include: [] }
+})], Qualification);
+var FROZEN_WHEN_REVOKED = [
+	["tenant_id", "tenantId"],
+	["qualification_id", "qualificationId"],
+	["profile_id", "profileId"],
+	["employment_id", "employmentId"],
+	["issued_on", "issuedOn"],
+	["expires_on", "expiresOn"],
+	["certificate_number", "certificateNumber"],
+	["status", "status"],
+	["renewal_of_id", "renewalOfId"]
+];
+var HeldQualification = class extends SmrtObject {
+	tenantId = "";
+	qualificationId = "";
+	profileId = "";
+	employmentId = null;
+	issuedOn = "";
+	expiresOn = null;
+	certificateNumber = "";
+	status = "valid";
+	verifiedByProfileId = null;
+	verifiedAt = null;
+	documentAssetId = null;
+	renewalOfId = null;
+	async save() {
+		assertHrWrite(this);
+		const prior = this.id ? await this.db.get(this.tableName, { id: this.id }) : null;
+		if (prior && (prior.tenant_id !== this.tenantId || prior.profile_id !== this.profileId || prior.qualification_id !== this.qualificationId || prior.issued_on !== this.issuedOn)) throw new HrError("HR_HISTORY_IMMUTABLE", "A held qualification keeps its person, qualification and issue date; renew it instead.");
+		if (prior?.status === "revoked" && FROZEN_WHEN_REVOKED.some(([column, property]) => (prior[column] ?? null) !== (this[property] ?? null))) throw new HrError("HR_HISTORY_IMMUTABLE", "A revoked qualification never changes, apart from its verification; grant a new one.");
+		return await super.save();
+	}
+	async delete() {
+		throw new HrError("HR_HISTORY_IMMUTABLE", "Held qualifications cannot be deleted; revoke them instead.");
+	}
+};
+__decorateClass([tenantId()], HeldQualification.prototype, "tenantId", 2);
+__decorateClass([foreignKey(Qualification, { onDelete: "RESTRICT" })], HeldQualification.prototype, "qualificationId", 2);
+__decorateClass([crossPackageRef("@happyvertical/smrt-profiles:Profile", { onDelete: "RESTRICT" })], HeldQualification.prototype, "profileId", 2);
+__decorateClass([foreignKey("Employment", {
+	nullable: true,
+	onDelete: "RESTRICT"
+})], HeldQualification.prototype, "employmentId", 2);
+__decorateClass([field({ type: "text" })], HeldQualification.prototype, "issuedOn", 2);
+__decorateClass([field({
+	type: "text",
+	nullable: true
+})], HeldQualification.prototype, "expiresOn", 2);
+__decorateClass([field({ type: "text" })], HeldQualification.prototype, "status", 2);
+__decorateClass([crossPackageRef("@happyvertical/smrt-profiles:Profile", {
+	nullable: true,
+	onDelete: "RESTRICT"
+})], HeldQualification.prototype, "verifiedByProfileId", 2);
+__decorateClass([crossPackageRef("@happyvertical/smrt-assets:Asset", { nullable: true })], HeldQualification.prototype, "documentAssetId", 2);
+__decorateClass([foreignKey("HeldQualification", {
+	nullable: true,
+	onDelete: "RESTRICT"
+})], HeldQualification.prototype, "renewalOfId", 2);
+HeldQualification = __decorateClass([TenantScoped({ mode: "required" }), smrt({
+	tableName: "held_qualifications",
+	sensitive: true,
+	indexes: [{
+		name: "held_qualifications_profile_idx",
+		columns: [
+			"tenantId",
+			"profileId",
+			"qualificationId"
+		]
+	}, {
+		name: "held_qualifications_expiry_idx",
+		columns: [
+			"tenantId",
+			"status",
+			"expiresOn"
+		]
+	}],
+	api: { include: [] },
+	cli: { include: [] },
+	mcp: { include: [] }
+})], HeldQualification);
+var HeldQualificationChange = class extends SmrtObject {
+	tenantId = "";
+	heldQualificationId = "";
+	kind = "granted";
+	effectiveOn = "";
+	reason = "";
+	actorProfileId = "";
+	async save() {
+		assertHrWrite(this);
+		if (this.id && await this.db.get(this.tableName, { id: this.id })) throw new HrError("HR_HISTORY_IMMUTABLE", "Held qualification changes are append-only.");
+		this.requireInsertOnSave();
+		return await super.save();
+	}
+	async delete() {
+		throw new HrError("HR_HISTORY_IMMUTABLE", "Held qualification changes cannot be deleted.");
+	}
+};
+__decorateClass([tenantId()], HeldQualificationChange.prototype, "tenantId", 2);
+__decorateClass([foreignKey(HeldQualification, { onDelete: "RESTRICT" })], HeldQualificationChange.prototype, "heldQualificationId", 2);
+__decorateClass([field({ type: "text" })], HeldQualificationChange.prototype, "kind", 2);
+__decorateClass([field({ type: "text" })], HeldQualificationChange.prototype, "effectiveOn", 2);
+__decorateClass([crossPackageRef("@happyvertical/smrt-profiles:Profile", { onDelete: "RESTRICT" })], HeldQualificationChange.prototype, "actorProfileId", 2);
+HeldQualificationChange = __decorateClass([TenantScoped({ mode: "required" }), smrt({
+	tableName: "held_qualification_changes",
+	sensitive: true,
+	indexes: [{
+		name: "held_qualification_changes_held_idx",
+		columns: [
+			"tenantId",
+			"heldQualificationId",
+			"effectiveOn"
+		]
+	}],
+	api: { include: [] },
+	cli: { include: [] },
+	mcp: { include: [] }
+})], HeldQualificationChange);
+var QualificationCollection = class extends SmrtCollection {};
+__publicField(QualificationCollection, "_itemClass", Qualification);
+QualificationCollection = __decorateClass([smrt({
+	api: { include: [] },
+	mcp: { include: [] },
+	cli: false
+})], QualificationCollection);
+var HeldQualificationCollection = class extends SmrtCollection {};
+__publicField(HeldQualificationCollection, "_itemClass", HeldQualification);
+HeldQualificationCollection = __decorateClass([smrt({
+	api: { include: [] },
+	mcp: { include: [] },
+	cli: false
+})], HeldQualificationCollection);
+var HeldQualificationChangeCollection = class extends SmrtCollection {};
+__publicField(HeldQualificationChangeCollection, "_itemClass", HeldQualificationChange);
+HeldQualificationChangeCollection = __decorateClass([smrt({
+	api: { include: [] },
+	mcp: { include: [] },
+	cli: false
+})], HeldQualificationChangeCollection);
+//#endregion
+//#region src/qualifications/internal.ts
+var EMPLOYMENT_ENDED_REASON = "employment-ended";
+async function revokeEmploymentQualifications(db, actor, employmentId, effectiveOn, queue) {
+	const rows = await (await HeldQualificationCollection.create({ db })).list({ where: {
+		tenantId: actor.tenantId,
+		employmentId
+	} });
+	if (rows.length === 0) return [];
+	const changes = await HeldQualificationChangeCollection.create({ db });
+	const revokedOn = /* @__PURE__ */ new Map();
+	for (const change of await changes.list({ where: {
+		tenantId: actor.tenantId,
+		heldQualificationId: rows.map((row) => row.id),
+		kind: "revoked"
+	} })) {
+		const earliest = revokedOn.get(change.heldQualificationId);
+		if (earliest === void 0 || change.effectiveOn < earliest) revokedOn.set(change.heldQualificationId, change.effectiveOn);
+	}
+	const byId = new Map(rows.map((row) => [row.id, row]));
+	const renewed = new Set(rows.map((row) => row.renewalOfId));
+	const cut = [];
+	for (const row of rows) {
+		if (renewed.has(row.id)) continue;
+		let already;
+		const seen = /* @__PURE__ */ new Set();
+		for (let member = row; member && !seen.has(member.id); member = member.renewalOfId ? byId.get(member.renewalOfId) : void 0) {
+			seen.add(member.id);
+			const on = revokedOn.get(member.id);
+			if (on !== void 0 && (already === void 0 || on < already)) already = on;
+		}
+		if (already !== void 0 && already <= effectiveOn) continue;
+		if (row.status !== "revoked") {
+			row.status = "revoked";
+			await persistHr(row);
+		}
+		await insertHr(HeldQualificationChange, db, {
+			tenantId: actor.tenantId,
+			heldQualificationId: row.id,
+			kind: "revoked",
+			effectiveOn,
+			reason: EMPLOYMENT_ENDED_REASON,
+			actorProfileId: actor.profileId
+		});
+		queue({
+			type: "held-qualification.revoked",
+			heldQualification: row,
+			effectiveOn,
+			at: /* @__PURE__ */ new Date(),
+			byProfileId: actor.profileId
+		});
+		cut.push(row);
+	}
+	return cut;
+}
+//#endregion
+//#region src/service-base.ts
+var logger = createLogger({ level: "info" });
+var HrService = class {
+	constructor(db, actor, options = {}) {
+		this.db = db;
+		if (!actor?.tenantId?.trim() || !actor?.profileId?.trim()) throw new HrError("HR_ACTOR_INVALID", "HR services require a trusted tenant/profile actor.");
+		this.actor = Object.freeze({
+			tenantId: this.identity(actor.tenantId),
+			profileId: this.identity(actor.profileId)
+		});
+		this.onEvent = options.onEvent;
+	}
+	db;
+	actor;
+	onEvent;
+	/** Normalize an id; PostgreSQL stores identities as UUIDs. */
+	identity(value) {
+		if (!isPostgresDatabase(this.db)) return value;
+		const hex = value.replace(/[{}-]/g, "").toLowerCase();
+		if (!/^[0-9a-f]{32}$/.test(hex)) throw new HrError("HR_INVALID", "PostgreSQL HR identities must be UUIDs.");
+		return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+	}
+	/**
+	* A required id from caller input, trimmed and normalized.
+	*
+	* @throws HrError `HR_INVALID` when it is not text or is blank
+	*/
+	id(fieldName, value) {
+		if (typeof value !== "string" || !value.trim()) throw new HrError("HR_INVALID", `${fieldName} is required.`);
+		return this.identity(value.trim());
+	}
+	/** An optional id from caller input: null or undefined is null. */
+	optionalId(fieldName, value) {
+		return value === null || value === void 0 ? null : this.id(fieldName, value);
+	}
+	/** Run a read inside the actor's tenant. */
+	scope(run) {
+		const active = getTenantId();
+		if (active && this.identity(active) !== this.actor.tenantId) throw new HrError("HR_TENANT_MISMATCH", "HR actor differs from active tenant.");
+		return withTenant({ tenantId: this.actor.tenantId }, run);
+	}
+	/**
+	* Run a mutation in one transaction, serialized per tenant, then deliver the
+	* events it queued. Nothing is delivered when the transaction fails.
+	*
+	* @throws HrError `HR_TRANSACTION_UNSUPPORTED` when the service was constructed with a handle that is already inside a transaction
+	*/
+	async transact(run) {
+		const unsupported = () => new HrError("HR_TRANSACTION_UNSUPPORTED", "HR services must be constructed with the root database handle, not one that is already inside a transaction: events are delivered when the service commits its own transaction.");
+		const begin = this.db.beginTransaction;
+		if (typeof begin !== "function") throw unsupported();
+		const events = [];
+		const result = await this.scope(() => withEmbeddedWriteQueue(this.db, isEmbeddedDatabase(this.db), async () => {
+			let tx;
+			try {
+				tx = await begin.call(this.db);
+			} catch (error) {
+				if (error instanceof NestedTransactionError) throw unsupported();
+				throw error;
+			}
+			let value;
+			try {
+				if (isPostgresDatabase(this.db)) await tx.query("SELECT pg_advisory_xact_lock(hashtextextended($1, 0))", JSON.stringify(["smrt.human-resources", this.actor.tenantId]));
+				value = await run(tx, (event) => events.push(event));
+			} catch (error) {
+				await tx.rollback().catch(() => void 0);
+				throw error;
+			}
+			await tx.commit();
+			return value;
+		}));
+		for (const event of events) await this.emit(event);
+		return result;
+	}
+	async emit(event) {
+		if (!this.onEvent) return;
+		try {
+			await this.onEvent(event);
+		} catch (error) {
+			logger.error(`[smrt-human-resources] onEvent handler failed for ${event.type}`, { error: error instanceof Error ? error.message : String(error) });
+		}
+	}
+};
+//#endregion
+//#region src/employment/queries.ts
+async function termsCovering(db, tenantId, on) {
+	return (await (await EmploymentTermCollection.create({ db })).list({ where: {
+		tenantId,
+		"startedOn <=": on
+	} })).filter((term) => dateWithin(on, term.startedOn, term.endedOn));
+}
+async function employmentsOn(db, tenantId, on) {
+	const ids = [...new Set((await termsCovering(db, tenantId, on)).map((t) => t.employmentId))];
+	if (ids.length === 0) return [];
+	return (await EmploymentCollection.create({ db })).list({ where: {
+		tenantId,
+		id: ids
+	} });
+}
+//#endregion
+//#region src/employment/service.ts
+var WORKER_TYPE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+var TERM_CHANGE_KINDS = [
+	"hired",
+	"ended",
+	"rehired",
+	"position-changed",
+	"worker-type-changed",
+	"leave-started",
+	"leave-ended"
+];
+var LEAVE_CHANGE_KINDS = ["leave-started", "leave-ended"];
+function workerTypeOf(value) {
+	if (typeof value !== "string" || !WORKER_TYPE.test(value)) throw new HrError("HR_INVALID", `workerType must be lowercase kebab-case, got '${String(value)}'.`);
+	return value;
+}
+function positionOf(value) {
+	if (value === null || value === void 0) return null;
+	if (typeof value !== "string") throw new HrError("HR_INVALID", "position must be text or null.");
+	return value.trim() || null;
+}
+function noteOf(value) {
+	if (value === void 0 || value === null) return "";
+	if (typeof value !== "string") throw new HrError("HR_INVALID", "A note or reason must be text.");
+	return value.trim();
+}
+function createdTime$1(change) {
+	const at = change.created_at;
+	const time = at ? new Date(at).getTime() : 0;
+	return Number.isNaN(time) ? 0 : time;
+}
+function inHistoryOrder(changes) {
+	return [...changes].sort((a, b) => a.effectiveOn === b.effectiveOn ? createdTime$1(a) - createdTime$1(b) : a.effectiveOn < b.effectiveOn ? -1 : 1);
+}
+function onLeaveOn(history, on) {
+	let onLeave = false;
+	for (const change of history) {
+		if (change.effectiveOn > on) break;
+		if (change.kind === "leave-started") onLeave = true;
+		else if (change.kind === "leave-ended" || change.kind === "rehired") onLeave = false;
+	}
+	return onLeave;
+}
+function valueOn(history, kind, on, current) {
+	const ofKind = history.filter((change) => change.kind === kind);
+	if (ofKind.length === 0) return current;
+	let value = ofKind[0].fromValue;
+	for (const change of ofKind) {
+		if (change.effectiveOn > on) break;
+		value = change.toValue;
+	}
+	return value;
+}
+var EmploymentService = class extends HrService {
+	async load(db, id) {
+		const [employment] = await (await EmploymentCollection.create({ db })).list({
+			where: {
+				tenantId: this.actor.tenantId,
+				id: this.id("employmentId", id)
+			},
+			limit: 1
+		});
+		if (!employment) throw new HrError("HR_NOT_FOUND", "Employment not found in this tenant.");
+		return employment;
+	}
+	async one(where, db = this.db) {
+		const [employment] = await (await EmploymentCollection.create({ db })).list({
+			where: {
+				tenantId: this.actor.tenantId,
+				...where
+			},
+			limit: 1
+		});
+		return employment ?? null;
+	}
+	async termsOf(db, employmentId) {
+		return (await (await EmploymentTermCollection.create({ db })).list({ where: {
+			tenantId: this.actor.tenantId,
+			employmentId
+		} })).sort((a, b) => a.startedOn < b.startedOn ? -1 : a.startedOn > b.startedOn ? 1 : 0);
+	}
+	async changesOf(db, employmentId) {
+		return inHistoryOrder(await (await EmploymentChangeCollection.create({ db })).list({ where: {
+			tenantId: this.actor.tenantId,
+			employmentId
+		} }));
+	}
+	/**
+	* Append a change. Creation instants are strictly increasing within one
+	* employment (writes are serialized per tenant), so same-day changes replay
+	* in the order they were recorded.
+	*/
+	async record(db, employmentId, change) {
+		const latest = (await (await EmploymentChangeCollection.create({ db })).list({ where: {
+			tenantId: this.actor.tenantId,
+			employmentId
+		} })).reduce((max, row) => Math.max(max, createdTime$1(row)), 0);
+		await insertHr(EmploymentChange, db, {
+			tenantId: this.actor.tenantId,
+			employmentId,
+			kind: change.kind,
+			effectiveOn: change.effectiveOn,
+			fromValue: change.fromValue ?? null,
+			toValue: change.toValue ?? null,
+			note: change.note ?? "",
+			actorProfileId: this.actor.profileId,
+			created_at: new Date(Math.max(Date.now(), latest + 1))
+		});
+	}
+	/**
+	* The term a dated change belongs to, with `effectiveOn` inside it: the
+	* latest term, which is the open one until an end is recorded and the final
+	* one (up to its last day) afterwards. The stored status plays no part, so
+	* a change dated inside a notice period is accepted.
+	*
+	* @throws HrError `HR_INVALID` before the term started, `HR_STATUS_TRANSITION` after its last day
+	*/
+	async latestTerm(db, employment, effectiveOn) {
+		const term = (await this.termsOf(db, employment.id)).at(-1);
+		if (!term) throw new HrError("HR_STATUS_TRANSITION", "The employment has no term.");
+		if (effectiveOn < term.startedOn) throw new HrError("HR_INVALID", `${effectiveOn} is before the current term started (${term.startedOn}).`);
+		if (term.endedOn !== null && effectiveOn > term.endedOn) throw new HrError("HR_STATUS_TRANSITION", `The employment ended on ${term.endedOn}; rehire it first.`);
+		return term;
+	}
+	async notBeforeLatest(db, employmentId, kinds, effectiveOn) {
+		const latest = (await this.changesOf(db, employmentId)).filter((change) => kinds.includes(change.kind)).at(-1);
+		if (latest && effectiveOn < latest.effectiveOn) throw new HrError("HR_INVALID", `${effectiveOn} is earlier than the latest recorded change (${latest.effectiveOn}).`);
+	}
+	/**
+	* A login is exclusive to the employment that stores it until it is
+	* explicitly unlinked there, whatever that employment's stored status. An
+	* ended employment keeps its login through its notice period and after, so
+	* two employments never share one and `findByUser(userId, on)` cannot be
+	* ambiguous through the service.
+	*/
+	async loginFree(db, userId, employmentId) {
+		if ((await (await EmploymentCollection.create({ db })).list({ where: {
+			tenantId: this.actor.tenantId,
+			userId
+		} })).some((other) => other.id !== employmentId)) throw new HrError("HR_INVALID", "This login is already linked to another employment; unlink it there first.");
+	}
+	transition(employment, to) {
+		if (!EMPLOYMENT_STATUS_TRANSITIONS[employment.status]?.includes(to)) throw new HrError("HR_STATUS_TRANSITION", `An employment cannot go from '${employment.status}' to '${to}'.`);
+		employment.status = to;
+	}
+	/**
+	* Employ a person: creates the employment, its first term and a `hired`
+	* change. A profile has one employment per tenant, so a person who worked
+	* here before is rehired instead.
+	*
+	* @throws HrError `HR_ALREADY_EMPLOYED`, `HR_EMPLOYEE_NUMBER_TAKEN`, `HR_INVALID` (including a login already linked to another employment, ended or not: unlink it there first)
+	*/
+	async hire(input) {
+		const profileId = this.id("profileId", input?.profileId);
+		const employeeNumber = typeof input.employeeNumber === "string" ? input.employeeNumber.trim() : "";
+		if (!employeeNumber) throw new HrError("HR_INVALID", "employeeNumber is required.");
+		const startedOn = assertIsoDate("startedOn", input.startedOn);
+		const workerType = workerTypeOf(input.workerType ?? "employee");
+		const position = positionOf(input.position);
+		const userId = this.optionalId("userId", input.userId);
+		const employerProfileId = this.optionalId("employerProfileId", input.employerProfileId);
+		const id = await this.transact(async (db, queue) => {
+			if (await this.one({ profileId }, db)) throw new HrError("HR_ALREADY_EMPLOYED", "This profile already has an employment in this tenant; rehire it instead.");
+			if (await this.one({ employeeNumber }, db)) throw new HrError("HR_EMPLOYEE_NUMBER_TAKEN", `Employee number '${employeeNumber}' is already used in this tenant.`);
+			if (userId) await this.loginFree(db, userId, null);
+			const employment = await insertHr(Employment, db, {
+				tenantId: this.actor.tenantId,
+				profileId,
+				userId,
+				employerProfileId,
+				employeeNumber,
+				workerType,
+				position,
+				status: "active"
+			});
+			const employmentId = employment.id;
+			await insertHr(EmploymentTerm, db, {
+				tenantId: this.actor.tenantId,
+				employmentId,
+				startedOn
+			});
+			await this.record(db, employmentId, {
+				kind: "hired",
+				effectiveOn: startedOn
+			});
+			queue({
+				type: "employment.hired",
+				employment,
+				effectiveOn: startedOn,
+				at: /* @__PURE__ */ new Date(),
+				byProfileId: this.actor.profileId
+			});
+			return employmentId;
+		});
+		return this.get(id);
+	}
+	/**
+	* End an employment: closes the open term on `endedOn` (the last day
+	* employed, inclusive) and, in the same transaction, revokes its
+	* employment-scoped qualifications from the day after, so they are still
+	* good on the last day. `endedOn` cannot be earlier than a position,
+	* worker-type or leave change already recorded in the term.
+	*
+	* `endedOn` may be ahead of the day the end is recorded (a notice period).
+	* The stored status becomes `ended` at once, meaning "an end has been
+	* recorded": the person is still employed up to and including `endedOn`,
+	* so ask by date with {@link check}, {@link employedOn}, {@link asOf} or
+	* `findByUser(userId, on)`. Position, worker-type and leave changes dated
+	* inside the final term are still accepted.
+	*
+	* @throws HrError `HR_STATUS_TRANSITION` when already ended, `HR_INVALID`, `HR_NOT_FOUND`
+	*/
+	async end(employmentId, input) {
+		const endedOn = assertIsoDate("endedOn", input?.endedOn);
+		const reason = noteOf(input.reason);
+		const id = await this.transact(async (db, queue) => {
+			const employment = await this.load(db, employmentId);
+			this.transition(employment, "ended");
+			const term = await this.latestTerm(db, employment, endedOn);
+			if (term.endedOn !== null) throw new HrError("HR_STATUS_TRANSITION", "The employment has no open term.");
+			await this.notBeforeLatest(db, employment.id, TERM_CHANGE_KINDS, endedOn);
+			term.endedOn = endedOn;
+			term.endReason = reason;
+			await persistHr(term);
+			await persistHr(employment);
+			await this.record(db, employment.id, {
+				kind: "ended",
+				effectiveOn: endedOn,
+				note: reason
+			});
+			await revokeEmploymentQualifications(db, this.actor, employment.id, addDays(endedOn, 1), queue);
+			queue({
+				type: "employment.ended",
+				employment,
+				effectiveOn: endedOn,
+				at: /* @__PURE__ */ new Date(),
+				byProfileId: this.actor.profileId
+			});
+			return employment.id;
+		});
+		return this.get(id);
+	}
+	/**
+	* Rehire an ended employment: adds a term to the same row, so the
+	* employment id stays stable. The new term cannot start before a position,
+	* worker-type or leave change already recorded. The employment keeps the
+	* login it stored, which no other employment can have taken meanwhile.
+	*
+	* @throws HrError `HR_STATUS_TRANSITION` unless ended, `HR_TERM_OVERLAP`, `HR_INVALID`, `HR_NOT_FOUND`
+	*/
+	async rehire(employmentId, input) {
+		const startedOn = assertIsoDate("startedOn", input?.startedOn);
+		const workerType = input.workerType === void 0 ? void 0 : workerTypeOf(input.workerType);
+		const position = input.position === void 0 ? void 0 : positionOf(input.position);
+		const id = await this.transact(async (db, queue) => {
+			const employment = await this.load(db, employmentId);
+			if (employment.status !== "ended") throw new HrError("HR_STATUS_TRANSITION", `Only an ended employment can be rehired; this one is '${employment.status}'.`);
+			const id2 = employment.id;
+			const overlapping = (await this.termsOf(db, id2)).find((term) => term.endedOn === null || startedOn <= term.endedOn);
+			if (overlapping) throw new HrError("HR_TERM_OVERLAP", `A rehire must start after the previous term ended (${overlapping.endedOn ?? "still open"}).`);
+			await this.notBeforeLatest(db, id2, TERM_CHANGE_KINDS, startedOn);
+			if (employment.userId) await this.loginFree(db, employment.userId, id2);
+			const from = {
+				position: employment.position,
+				workerType: employment.workerType
+			};
+			this.transition(employment, "active");
+			if (position !== void 0) employment.position = position;
+			if (workerType !== void 0) employment.workerType = workerType;
+			await persistHr(employment);
+			await insertHr(EmploymentTerm, db, {
+				tenantId: this.actor.tenantId,
+				employmentId: id2,
+				startedOn
+			});
+			await this.record(db, id2, {
+				kind: "rehired",
+				effectiveOn: startedOn
+			});
+			if (employment.position !== from.position) await this.record(db, id2, {
+				kind: "position-changed",
+				effectiveOn: startedOn,
+				fromValue: from.position,
+				toValue: employment.position
+			});
+			if (employment.workerType !== from.workerType) await this.record(db, id2, {
+				kind: "worker-type-changed",
+				effectiveOn: startedOn,
+				fromValue: from.workerType,
+				toValue: employment.workerType
+			});
+			queue({
+				type: "employment.rehired",
+				employment,
+				effectiveOn: startedOn,
+				at: /* @__PURE__ */ new Date(),
+				byProfileId: this.actor.profileId
+			});
+			return id2;
+		});
+		return this.get(id);
+	}
+	/**
+	* Record a new position from `effectiveOn`. The employment row holds the
+	* latest value; the change row carries the old and new ones.
+	*
+	* `effectiveOn` must fall inside the latest term. Once an end has been
+	* recorded that is the final term, up to and including its `endedOn`, so a
+	* change during a notice period is accepted; the stored status stays
+	* `ended`.
+	*
+	* @throws HrError `HR_STATUS_TRANSITION` when `effectiveOn` is after the last day of an ended employment; `HR_INVALID` for a no-op, a date before the term started or before the latest position change; `HR_NOT_FOUND`
+	*/
+	async changePosition(employmentId, input) {
+		const effectiveOn = assertIsoDate("effectiveOn", input?.effectiveOn);
+		const position = positionOf(input.position);
+		const note = noteOf(input.note);
+		const id = await this.transact(async (db, queue) => {
+			const employment = await this.load(db, employmentId);
+			const id2 = employment.id;
+			await this.latestTerm(db, employment, effectiveOn);
+			if (employment.position === position) throw new HrError("HR_INVALID", "The employment already has this position.");
+			await this.notBeforeLatest(db, id2, ["position-changed"], effectiveOn);
+			const fromValue = employment.position;
+			employment.position = position;
+			await persistHr(employment);
+			await this.record(db, id2, {
+				kind: "position-changed",
+				effectiveOn,
+				fromValue,
+				toValue: position,
+				note
+			});
+			queue({
+				type: "employment.position-changed",
+				employment,
+				effectiveOn,
+				at: /* @__PURE__ */ new Date(),
+				byProfileId: this.actor.profileId
+			});
+			return id2;
+		});
+		return this.get(id);
+	}
+	/**
+	* Record a new worker type from `effectiveOn`. The employment row holds the
+	* latest value; the change row carries the old and new ones.
+	*
+	* `effectiveOn` must fall inside the latest term. Once an end has been
+	* recorded that is the final term, up to and including its `endedOn`, so a
+	* change during a notice period is accepted; the stored status stays
+	* `ended`.
+	*
+	* @throws HrError `HR_STATUS_TRANSITION` when `effectiveOn` is after the last day of an ended employment; `HR_INVALID` for a no-op, a bad value, a date before the term started or before the latest worker-type change; `HR_NOT_FOUND`
+	*/
+	async changeWorkerType(employmentId, input) {
+		const effectiveOn = assertIsoDate("effectiveOn", input?.effectiveOn);
+		const workerType = workerTypeOf(input.workerType);
+		const note = noteOf(input.note);
+		const id = await this.transact(async (db, queue) => {
+			const employment = await this.load(db, employmentId);
+			const id2 = employment.id;
+			await this.latestTerm(db, employment, effectiveOn);
+			if (employment.workerType === workerType) throw new HrError("HR_INVALID", "The employment already has this worker type.");
+			await this.notBeforeLatest(db, id2, ["worker-type-changed"], effectiveOn);
+			const fromValue = employment.workerType;
+			employment.workerType = workerType;
+			await persistHr(employment);
+			await this.record(db, id2, {
+				kind: "worker-type-changed",
+				effectiveOn,
+				fromValue,
+				toValue: workerType,
+				note
+			});
+			queue({
+				type: "employment.worker-type-changed",
+				employment,
+				effectiveOn,
+				at: /* @__PURE__ */ new Date(),
+				byProfileId: this.actor.profileId
+			});
+			return id2;
+		});
+		return this.get(id);
+	}
+	async leave(employmentId, input, to) {
+		const effectiveOn = assertIsoDate("effectiveOn", input?.effectiveOn);
+		const note = noteOf(input.note);
+		const kind = to === "on-leave" ? "leave-started" : "leave-ended";
+		const id = await this.transact(async (db, queue) => {
+			const employment = await this.load(db, employmentId);
+			const id2 = employment.id;
+			if (employment.status === "ended") {
+				await this.latestTerm(db, employment, effectiveOn);
+				await this.notBeforeLatest(db, id2, LEAVE_CHANGE_KINDS, effectiveOn);
+				const onLeave = onLeaveOn(await this.changesOf(db, id2), effectiveOn);
+				if (onLeave === (to === "on-leave")) throw new HrError("HR_STATUS_TRANSITION", onLeave ? `The employment is already on leave on ${effectiveOn}.` : `The employment is not on leave on ${effectiveOn}.`);
+			} else {
+				this.transition(employment, to);
+				await this.latestTerm(db, employment, effectiveOn);
+				await this.notBeforeLatest(db, id2, LEAVE_CHANGE_KINDS, effectiveOn);
+				await persistHr(employment);
+			}
+			await this.record(db, id2, {
+				kind,
+				effectiveOn,
+				note
+			});
+			queue({
+				type: `employment.${kind}`,
+				employment,
+				effectiveOn,
+				at: /* @__PURE__ */ new Date(),
+				byProfileId: this.actor.profileId
+			});
+			return id2;
+		});
+		return this.get(id);
+	}
+	/**
+	* Place an employment on leave from `effectiveOn`. A person on leave is
+	* still employed.
+	*
+	* Once an end has been recorded, leave dated inside the final term (up to
+	* and including its `endedOn`) is still accepted: it is recorded as a
+	* change row, the stored status stays `ended`, and whether the person is
+	* already on leave is decided by replaying the history as of `effectiveOn`.
+	*
+	* @throws HrError `HR_STATUS_TRANSITION` when already on leave, or when `effectiveOn` is after the last day of an ended employment; `HR_INVALID` for a date before the term started or before the latest leave change; `HR_NOT_FOUND`
+	*/
+	async placeOnLeave(employmentId, input) {
+		return this.leave(employmentId, input, "on-leave");
+	}
+	/**
+	* Return an employment from leave; `effectiveOn` is the first day back.
+	*
+	* Once an end has been recorded, a return dated inside the final term (up
+	* to and including its `endedOn`) is still accepted: it is recorded as a
+	* change row, the stored status stays `ended`, and whether the person is
+	* on leave is decided by replaying the history as of `effectiveOn`.
+	*
+	* @throws HrError `HR_STATUS_TRANSITION` unless on leave, or when `effectiveOn` is after the last day of an ended employment; `HR_INVALID` for a date before the term started or before the latest leave change; `HR_NOT_FOUND`
+	*/
+	async returnFromLeave(employmentId, input) {
+		return this.leave(employmentId, input, "active");
+	}
+	async login(employmentId, userId, input) {
+		const effectiveOn = assertIsoDate("effectiveOn", input?.effectiveOn);
+		const id = await this.transact(async (db) => {
+			const employment = await this.load(db, employmentId);
+			const id2 = employment.id;
+			if (employment.userId === userId) throw new HrError("HR_INVALID", userId ? "This login is already linked to the employment." : "The employment has no linked login.");
+			if (userId) await this.loginFree(db, userId, id2);
+			const fromValue = employment.userId;
+			employment.userId = userId;
+			await persistHr(employment);
+			await this.record(db, id2, {
+				kind: userId ? "login-linked" : "login-unlinked",
+				effectiveOn,
+				fromValue,
+				toValue: userId
+			});
+			return id2;
+		});
+		return this.get(id);
+	}
+	/**
+	* Link a login (`smrt-users:User` id) to an employment, replacing any
+	* previous one. Grants nothing by itself: permissions stay with smrt-users.
+	* A login belongs to one employment at a time and stays with it, ended or
+	* not, until {@link unlinkLogin} clears it there.
+	*
+	* The link takes effect at once, whatever `effectiveOn` says: the date is
+	* only recorded on the change row, and login links are not replayed by
+	* {@link asOf} or `findByUser(userId, on)`.
+	*
+	* @throws HrError `HR_INVALID` when already linked to this login, or to another employment (unlink it there first); `HR_NOT_FOUND`
+	*/
+	async linkLogin(employmentId, userId, input) {
+		return this.login(employmentId, this.id("userId", userId), input);
+	}
+	/**
+	* Clear an employment's login, which frees it for another employment. Works
+	* on an ended employment too. The login is cleared at once, whatever
+	* `effectiveOn` says; a future date does not keep it linked until then.
+	*
+	* @throws HrError `HR_INVALID` when no login is linked, `HR_NOT_FOUND`
+	*/
+	async unlinkLogin(employmentId, input) {
+		return this.login(employmentId, null, input);
+	}
+	/**
+	* One employment in the actor's tenant.
+	*
+	* @throws HrError `HR_NOT_FOUND` when it does not exist in this tenant
+	*/
+	async get(employmentId) {
+		return this.scope(() => this.load(this.db, employmentId));
+	}
+	/** The profile's employment in this tenant (ended or not), or null. */
+	async findByProfile(profileId) {
+		if (typeof profileId !== "string" || !profileId.trim()) return null;
+		const id = this.identity(profileId.trim());
+		return this.scope(() => this.one({ profileId: id }));
+	}
+	/** The employment with this employee number in this tenant, or null. */
+	async findByEmployeeNumber(employeeNumber) {
+		if (typeof employeeNumber !== "string" || !employeeNumber.trim()) return null;
+		return this.scope(() => this.one({ employeeNumber: employeeNumber.trim() }));
+	}
+	/**
+	* The employment linked to a login. Fails closed: null when there is none,
+	* or when more than one matches (the service keeps a login on one
+	* employment, so that takes rows written some other way).
+	*
+	* With `on`, the answer comes from the dated terms: the employment linked
+	* to the login that has a term covering `on`, whatever its stored status.
+	* Without `on`, it is the linked employment whose stored status is not
+	* `ended`, which stops resolving as soon as an end is recorded. A host that
+	* records end dates ahead of time (a notice period) should pass the date,
+	* or the worker is locked out before their last day.
+	*
+	* @throws HrError `HR_INVALID` when `on` is given and is not a calendar date
+	*/
+	async findByUser(userId, on) {
+		const date = on === void 0 ? null : assertIsoDate("on", on);
+		if (typeof userId !== "string" || !userId.trim()) return null;
+		const id = this.identity(userId.trim());
+		return this.scope(async () => {
+			const linked = await (await EmploymentCollection.create({ db: this.db })).list({ where: {
+				tenantId: this.actor.tenantId,
+				userId: id
+			} });
+			const matching = [];
+			for (const employment of linked) if (date === null ? employment.status !== "ended" : (await this.termsOf(this.db, employment.id)).some((term) => dateWithin(date, term.startedOn, term.endedOn))) matching.push(employment);
+			return matching.length === 1 ? matching[0] : null;
+		});
+	}
+	/** Everyone with a term covering `on`, including people on leave. */
+	async employedOn(on) {
+		const date = assertIsoDate("on", on);
+		return this.scope(() => employmentsOn(this.db, this.actor.tenantId, date));
+	}
+	/**
+	* Whether a profile is employed on a date. Answered from terms, never from
+	* the stored status; `onLeave` is computed as of `on`, so past dates answer
+	* correctly.
+	*/
+	async check(profileId, on) {
+		const date = assertIsoDate("on", on);
+		if (typeof profileId !== "string" || !profileId.trim()) return {
+			ok: false,
+			reason: "not-employed"
+		};
+		const id = this.identity(profileId.trim());
+		return this.scope(async () => {
+			const employment = await this.one({ profileId: id });
+			if (!employment) return {
+				ok: false,
+				reason: "not-employed"
+			};
+			const employmentId = employment.id;
+			const terms = await this.termsOf(this.db, employmentId);
+			if (terms.length === 0) return {
+				ok: false,
+				reason: "not-employed"
+			};
+			if (!terms.some((term) => dateWithin(date, term.startedOn, term.endedOn))) return {
+				ok: false,
+				reason: date < terms[0].startedOn ? "not-started" : "ended"
+			};
+			return {
+				ok: true,
+				employmentId,
+				onLeave: onLeaveOn(await this.changesOf(this.db, employmentId), date)
+			};
+		});
+	}
+	/**
+	* An employment's terms, oldest first.
+	*
+	* @throws HrError `HR_NOT_FOUND` when the employment is not in this tenant
+	*/
+	async terms(employmentId) {
+		return this.scope(async () => {
+			const employment = await this.load(this.db, employmentId);
+			return this.termsOf(this.db, employment.id);
+		});
+	}
+	/**
+	* An employment's dated changes, by effective date and then in the order
+	* they were recorded.
+	*
+	* @throws HrError `HR_NOT_FOUND` when the employment is not in this tenant
+	*/
+	async history(employmentId) {
+		return this.scope(async () => {
+			const employment = await this.load(this.db, employmentId);
+			return this.changesOf(this.db, employment.id);
+		});
+	}
+	/**
+	* An employment's position, worker type and standing on one date, replayed
+	* from the change history. Before the first term the values are those at
+	* hire and `employed` is false.
+	*
+	* @throws HrError `HR_NOT_FOUND` when the employment is not in this tenant
+	*/
+	async asOf(employmentId, on) {
+		const date = assertIsoDate("on", on);
+		return this.scope(async () => {
+			const employment = await this.load(this.db, employmentId);
+			const id = employment.id;
+			const history = await this.changesOf(this.db, id);
+			const employed = (await this.termsOf(this.db, id)).some((term) => dateWithin(date, term.startedOn, term.endedOn));
+			return {
+				position: valueOn(history, "position-changed", date, employment.position),
+				workerType: valueOn(history, "worker-type-changed", date, employment.workerType) ?? employment.workerType,
+				employed,
+				onLeave: employed && onLeaveOn(history, date)
+			};
+		});
+	}
+};
+//#endregion
+//#region src/qualifications/service.ts
+var SUGGESTED_QUALIFICATIONS = Object.freeze([
+	Object.freeze({
+		key: "first-aid",
+		name: "First aid",
+		kind: "certification",
+		expires: true,
+		validityMonths: 36
+	}),
+	Object.freeze({
+		key: "site-orientation",
+		name: "Site orientation",
+		kind: "training"
+	}),
+	Object.freeze({
+		key: "youth-worker",
+		name: "Youth worker",
+		kind: "restriction"
+	})
+]);
+function employmentEnd(endsOn) {
+	return endsOn === null ? null : {
+		on: addDays(endsOn, 1),
+		reason: EMPLOYMENT_ENDED_REASON
+	};
+}
+var KEY = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+var KINDS = [
+	"ticket",
+	"certification",
+	"authorization",
+	"training",
+	"restriction"
+];
+var SCOPES = ["person", "employment"];
+var IN_CHUNK = 500;
+function invalid(message) {
+	return new HrError("HR_INVALID", message);
+}
+function text(fieldName, value, required = false) {
+	if (value == null && !required) return "";
+	if (typeof value !== "string") throw invalid(`${fieldName} must be text.`);
+	const trimmed = value.trim();
+	if (required && !trimmed) throw invalid(`${fieldName} is required.`);
+	return trimmed;
+}
+function flag(fieldName, value, fallback) {
+	if (value === void 0) return fallback;
+	if (typeof value !== "boolean") throw invalid(`${fieldName} must be true or false.`);
+	return value;
+}
+function validity(expires, value) {
+	if (value == null) return null;
+	if (!Number.isInteger(value) || value <= 0) throw invalid("validityMonths must be a positive whole number or null.");
+	if (!expires) throw invalid("validityMonths only applies to a qualification that expires.");
+	return value;
+}
+function normalizeDefinition(input) {
+	const key = text("key", input?.key, true);
+	if (!KEY.test(key)) throw invalid(`key must be lowercase kebab-case, got '${key}'.`);
+	if (!KINDS.includes(input.kind)) throw invalid(`kind must be one of ${KINDS.join(", ")}.`);
+	const scope = input.scope ?? (input.kind === "authorization" ? "employment" : "person");
+	if (!SCOPES.includes(scope)) throw invalid(`scope must be one of ${SCOPES.join(", ")}.`);
+	const expires = flag("expires", input.expires, false);
+	return {
+		key,
+		name: text("name", input.name, true),
+		kind: input.kind,
+		issuingBody: text("issuingBody", input.issuingBody),
+		expires,
+		validityMonths: validity(expires, input.validityMonths),
+		scope
+	};
+}
+function resolveExpiry(definition, issuedOn, given) {
+	if (!definition.expires) {
+		if (given != null) throw invalid(`'${definition.key}' does not expire; omit expiresOn.`);
+		return null;
+	}
+	let expiresOn;
+	if (given != null) expiresOn = assertIsoDate("expiresOn", given);
+	else if (definition.validityMonths != null) expiresOn = addMonths(issuedOn, definition.validityMonths);
+	else throw invalid(`'${definition.key}' expires and has no default validity; give expiresOn.`);
+	if (expiresOn < issuedOn) throw invalid("expiresOn must not be before issuedOn.");
+	return expiresOn;
+}
+function standingOn(changes, on) {
+	let suspensions = 0;
+	for (const change of changes) {
+		if (change.effectiveOn > on) continue;
+		if (change.kind === "revoked") return "revoked";
+		if (change.kind === "suspended") suspensions += 1;
+		else if (change.kind === "reinstated") suspensions -= 1;
+	}
+	return suspensions > 0 ? "suspended" : null;
+}
+function statusOn(row, changes, on) {
+	if (row.issuedOn > on) return "not-yet-issued";
+	const standing = standingOn(changes, on);
+	if (standing) return standing;
+	if (row.expiresOn != null && on > row.expiresOn) return "expired";
+	return "valid";
+}
+function chainStatusesOn(rows, changes, on) {
+	const renewalOf = /* @__PURE__ */ new Map();
+	for (const row of rows) if (row.renewalOfId) renewalOf.set(row.renewalOfId, row);
+	const statuses = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		const id = row.id;
+		let status = statusOn(row, changes.get(id) ?? [], on);
+		const seen = /* @__PURE__ */ new Set([id]);
+		let later = renewalOf.get(id);
+		while (status !== "revoked" && later && !seen.has(later.id)) {
+			seen.add(later.id);
+			const standing = standingOn(changes.get(later.id) ?? [], on);
+			if (standing && (status === "valid" || status === "suspended")) status = standing;
+			later = renewalOf.get(later.id);
+		}
+		statuses.set(id, status);
+	}
+	return statuses;
+}
+var SUSPENSION_KINDS = ["suspended", "reinstated"];
+function revocationOf(changes) {
+	let earliest = null;
+	for (const change of changes) if (change.kind === "revoked" && (earliest === null || change.effectiveOn < earliest.effectiveOn)) earliest = change;
+	return earliest && {
+		on: earliest.effectiveOn,
+		reason: earliest.reason
+	};
+}
+function revokedFrom(changes) {
+	return revocationOf(changes)?.on ?? null;
+}
+function latestOf(changes, kinds) {
+	let latest = null;
+	for (const change of changes) if (kinds.includes(change.kind) && (latest === null || change.effectiveOn > latest)) latest = change.effectiveOn;
+	return latest;
+}
+function createdTime(row) {
+	const time = row.created_at ? new Date(row.created_at).getTime() : 0;
+	return Number.isNaN(time) ? 0 : time;
+}
+function longestLasting(rows) {
+	return rows.reduce((best, row) => {
+		if (best.expiresOn === row.expiresOn) return row.issuedOn > best.issuedOn ? row : best;
+		if (best.expiresOn == null) return best;
+		if (row.expiresOn == null) return row;
+		return row.expiresOn > best.expiresOn ? row : best;
+	});
+}
+var QualificationService = class extends HrService {
+	/** Add a qualification definition; its key is unique per tenant. */
+	async define(input) {
+		const definition = normalizeDefinition(input);
+		const id = await this.transact(async (db) => {
+			if (await this.byKey(db, definition.key)) throw new HrError("HR_QUALIFICATION_KEY_TAKEN", `A qualification with key '${definition.key}' already exists.`);
+			return (await this.insertDefinition(db, definition)).id;
+		});
+		return this.get(id);
+	}
+	/** Change a definition's descriptive fields; key and scope are immutable. */
+	async update(qualificationId, input) {
+		const id = this.id("qualificationId", qualificationId);
+		if (input == null || typeof input !== "object") throw invalid("update needs the fields to change.");
+		await this.transact(async (db) => {
+			const row = await this.definition(db, id);
+			if (input.name !== void 0) row.name = text("name", input.name, true);
+			if (input.issuingBody !== void 0) row.issuingBody = text("issuingBody", input.issuingBody);
+			row.expires = flag("expires", input.expires, row.expires);
+			row.isActive = flag("isActive", input.isActive, row.isActive);
+			if (input.validityMonths !== void 0) row.validityMonths = validity(row.expires, input.validityMonths);
+			else if (!row.expires) row.validityMonths = null;
+			await persistHr(row);
+		});
+		return this.get(id);
+	}
+	/**
+	* Create the definitions whose key is missing and leave existing rows
+	* untouched. Returns one definition per input, in input order.
+	*/
+	async seed(definitions) {
+		const wanted = definitions.map(normalizeDefinition);
+		if (new Set(wanted.map((d) => d.key)).size !== wanted.length) throw invalid("Seed definitions must have distinct keys.");
+		const ids = await this.transact(async (db) => {
+			const result = [];
+			for (const definition of wanted) {
+				const row = await this.byKey(db, definition.key) ?? await this.insertDefinition(db, definition);
+				result.push(row.id);
+			}
+			return result;
+		});
+		return this.scope(async () => {
+			const rows = await (await QualificationCollection.create({ db: this.db })).list({ where: { tenantId: this.actor.tenantId } });
+			const byId = new Map(rows.map((row) => [row.id, row]));
+			return ids.map((id) => byId.get(id));
+		});
+	}
+	/** The tenant's definitions ordered by key; active ones unless asked. */
+	async list(options = {}) {
+		return this.scope(async () => {
+			const rows = await (await QualificationCollection.create({ db: this.db })).list({
+				where: { tenantId: this.actor.tenantId },
+				orderBy: "key ASC"
+			});
+			return options.includeInactive ? rows : rows.filter((r) => r.isActive);
+		});
+	}
+	/**
+	* One definition by id.
+	*
+	* @throws HrError `HR_NOT_FOUND` outside the actor's tenant, `HR_INVALID` for a blank id
+	*/
+	async get(qualificationId) {
+		const id = this.id("qualificationId", qualificationId);
+		return this.scope(() => this.definition(this.db, id));
+	}
+	/** One definition by key, or null. */
+	async findByKey(key) {
+		if (typeof key !== "string" || !key.trim()) return null;
+		return this.scope(() => this.byKey(this.db, key.trim()));
+	}
+	/**
+	* Record that a person holds a qualification from `issuedOn`.
+	*
+	* A person has one live grant of a qualification at a time, decided by
+	* date: the grant is refused unless everything they already hold of it is
+	* revoked effective on or before `issuedOn`. A lapsed ticket (swept or not)
+	* is renewed, not granted again, and a revocation scheduled for a later
+	* date does not free an earlier issue date.
+	*
+	* An employment-scoped grant dated inside a term whose end is already
+	* recorded ends with that employment: the `employment-ended` revocation,
+	* effective the day after the term's last day, is recorded in the same
+	* transaction and the row is stored `revoked`.
+	*
+	* @throws HrError `HR_ALREADY_HELD` unless every earlier grant is revoked effective on or before `issuedOn` (renew the existing one instead), `HR_QUALIFICATION_SCOPE`, `HR_INVALID`, `HR_NOT_FOUND`
+	*/
+	async grant(input) {
+		const qualificationId = this.id("qualificationId", input?.qualificationId);
+		const profileId = this.id("profileId", input.profileId);
+		const issuedOn = assertIsoDate("issuedOn", input.issuedOn);
+		const givenEmploymentId = this.optionalId("employmentId", input.employmentId);
+		const id = await this.transact(async (db, queue) => {
+			const definition = await this.grantable(db, qualificationId);
+			const expiresOn = resolveExpiry(definition, issuedOn, input.expiresOn);
+			const { employmentId, endsOn } = await this.employmentFor(db, definition, profileId, givenEmploymentId, issuedOn);
+			const rows = await this.rows(db, {
+				profileId,
+				qualificationId
+			});
+			const [live] = await this.liveChains(db, rows, issuedOn, null);
+			if (live) throw new HrError("HR_ALREADY_HELD", live.revokedOn ? `This person holds '${definition.key}' until its revocation takes effect on ${live.revokedOn}; renew the existing one instead.` : `This person already holds '${definition.key}'; renew it instead.`);
+			return (await this.insertHeld(db, queue, "granted", {
+				qualificationId,
+				profileId,
+				employmentId,
+				revocation: employmentEnd(endsOn),
+				issuedOn,
+				expiresOn,
+				renewalOfId: null,
+				input
+			})).id;
+		});
+		return this.held(this.db, id);
+	}
+	/**
+	* Renew a held qualification: a new row pointing at the old one. The old row
+	* is not modified, so checks on past dates still answer from it. Only the
+	* latest row of a chain can be renewed.
+	*
+	* The renewal is validated against the old row's dated history, not its
+	* stored status: `issuedOn` cannot be earlier than the row's latest
+	* suspension or reinstatement (the renewal would otherwise answer for dates
+	* the history says were suspended), the row must not be suspended on
+	* `issuedOn`, and it must not be revoked on or before `issuedOn`.
+	*
+	* A revocation recorded for a later date (a scheduled one, or the end of an
+	* employment whose last day is ahead) does not stop a renewal: the
+	* qualification is still in force, so a ticket that lapses first can be
+	* renewed. The renewal carries the cutoff forward. It is stored `revoked`
+	* with a revocation at the earlier of the old row's pending revocation
+	* (with its reason) and, for an employment-scoped one inside a term whose
+	* end is recorded, the day after the last day employed
+	* (`employment-ended`); `held-qualification.renewed` and
+	* `held-qualification.revoked` are both raised.
+	*
+	* @throws HrError `HR_STATUS_TRANSITION` when suspended on `issuedOn` (reinstate it first); `HR_ALREADY_HELD` when the person holds another grant outside this chain that is not revoked on or before `issuedOn` and starts before the day this renewal is cut off; `HR_INVALID` for a row revoked on or before `issuedOn`, an already renewed row, an `issuedOn` before the row's own or before its latest suspension or reinstatement, or an expiry earlier than the row's own (revoke it and grant a new one instead); `HR_NOT_FOUND`
+	*/
+	async renew(heldQualificationId, input) {
+		const priorId = this.id("heldQualificationId", heldQualificationId);
+		const issuedOn = assertIsoDate("issuedOn", input?.issuedOn);
+		const id = await this.transact(async (db, queue) => {
+			const prior = await this.held(db, priorId);
+			const history = (await this.changesByHeld(db, [prior])).get(priorId) ?? [];
+			const pending = revocationOf(history);
+			if (pending !== null && pending.on <= issuedOn || pending === null && prior.status === "revoked") throw invalid("A qualification revoked on or before the renewal date cannot be renewed; grant a new one.");
+			const siblings = await this.rows(db, {
+				profileId: prior.profileId,
+				qualificationId: prior.qualificationId
+			});
+			if (siblings.some((row2) => row2.renewalOfId === priorId)) throw invalid("This qualification was already renewed; renew the latest one.");
+			if (issuedOn < prior.issuedOn) throw invalid("A renewal cannot be issued before what it renews.");
+			const changedOn = latestOf(history, SUSPENSION_KINDS);
+			if (changedOn !== null && issuedOn < changedOn) throw invalid(`A renewal cannot be issued before the latest suspension or reinstatement on ${changedOn}.`);
+			if (standingOn(history, issuedOn) === "suspended") throw new HrError("HR_STATUS_TRANSITION", "A suspended qualification cannot be renewed; reinstate it first.");
+			const definition = await this.grantable(db, prior.qualificationId);
+			const expiresOn = resolveExpiry(definition, issuedOn, input.expiresOn);
+			if (expiresOn !== null && (prior.expiresOn === null || expiresOn < prior.expiresOn)) throw invalid(`A renewal cannot end before what it renews (${prior.expiresOn ?? "no expiry"}). To replace it with a shorter one, revoke it from ${issuedOn} and grant a new one from that day.`);
+			const { employmentId, endsOn } = await this.employmentFor(db, definition, prior.profileId, prior.employmentId, issuedOn);
+			const ended = employmentEnd(endsOn);
+			const revocation = ended !== null && (pending === null || ended.on <= pending.on) ? ended : pending;
+			const byId = new Map(siblings.map((row2) => [row2.id, row2]));
+			const startsOn = (row2) => {
+				let first = row2.issuedOn;
+				const seen = /* @__PURE__ */ new Set();
+				for (let member = row2; member && !seen.has(member.id); member = member.renewalOfId ? byId.get(member.renewalOfId) : void 0) {
+					seen.add(member.id);
+					if (member.issuedOn < first) first = member.issuedOn;
+				}
+				return first;
+			};
+			if ((await this.liveChains(db, siblings, issuedOn, priorId)).filter((other) => revocation === null || startsOn(other.row) < revocation.on).length > 0) throw new HrError("HR_ALREADY_HELD", "This person holds another grant of this qualification outside this renewal chain that overlaps the renewal; renew that one, or revoke it first.");
+			return (await this.insertHeld(db, queue, "renewed", {
+				qualificationId: prior.qualificationId,
+				profileId: prior.profileId,
+				employmentId,
+				revocation,
+				issuedOn,
+				expiresOn,
+				renewalOfId: priorId,
+				input
+			})).id;
+		});
+		return this.held(this.db, id);
+	}
+	/**
+	* Suspend a qualification from `effectiveOn` until it is reinstated. Act on
+	* the latest row of a renewal chain: the whole chain shares its standing,
+	* so the rows it renewed stop passing checks too.
+	*
+	* Whether it can be suspended is decided from the chain's dated history as
+	* of `effectiveOn`, never from the stored status: it must be neither
+	* suspended nor revoked on that day. A revocation recorded for a later date
+	* (scheduled, or the end of an employment whose last day is ahead) does not
+	* prevent it, and neither does a stored `expired`.
+	*
+	* `effectiveOn` may be any date from the chain's first issue date onward,
+	* not before the chain's latest suspension or reinstatement. It may precede
+	* the latest row's own issue date: with a renewal recorded ahead of time,
+	* that is how the ticket in force today is suspended, and the renewal is
+	* then suspended from its issue date until reinstated.
+	*
+	* The stored status becomes `suspended`, except on a row already stored
+	* `revoked`, which keeps it: only the change row is added.
+	*
+	* @throws HrError `HR_INVALID` for a row that was renewed, a date outside that range or a bad input; `HR_STATUS_TRANSITION` when suspended or revoked on `effectiveOn`; `HR_NOT_FOUND`
+	*/
+	async suspend(heldQualificationId, input) {
+		return this.transition(heldQualificationId, "suspended", {
+			effectiveOn: input?.effectiveOn,
+			reason: text("reason", input?.reason, true)
+		});
+	}
+	/**
+	* Lift a suspension from `effectiveOn`, which follows the same date rule as
+	* {@link suspend}. The chain must be suspended on that day by its dated
+	* history, and not yet revoked. The stored status becomes `valid`, or
+	* `expired` when the sweep has recorded the row's lapse; a stored `revoked`
+	* stays.
+	*
+	* @throws HrError `HR_INVALID` for a row that was renewed, a date before the suspension or a bad input; `HR_STATUS_TRANSITION` unless suspended on `effectiveOn`; `HR_NOT_FOUND`
+	*/
+	async reinstate(heldQualificationId, input) {
+		return this.transition(heldQualificationId, "reinstated", {
+			effectiveOn: input?.effectiveOn,
+			reason: text("reason", input?.reason)
+		});
+	}
+	/**
+	* Revoke a qualification from `effectiveOn`. Terminal: grant a new one
+	* dated on or after it. Act on the latest row of a renewal chain: the rows
+	* it renewed stop passing checks from the same date; dated before a renewal
+	* recorded ahead of time, the renewal is revoked from its issue date.
+	*
+	* `effectiveOn` may be any date from the chain's first issue date onward,
+	* whatever else is recorded: an urgent revocation may be dated before a
+	* suspension recorded ahead of time, or before a revocation that has not
+	* taken effect yet (a scheduled one, or the end of an employment whose last
+	* day is ahead). The earliest revocation is the one in force. It is refused
+	* only when the chain is already revoked on or before `effectiveOn`.
+	*
+	* The stored status becomes `revoked` at once, meaning a revocation has
+	* been recorded; until `effectiveOn` the qualification still passes
+	* {@link check}. A row already stored `revoked` is not saved again: the
+	* earlier revocation is one more change row, and the event carries its
+	* date.
+	*
+	* @throws HrError `HR_INVALID` for a row that was renewed, a date before the chain was issued or a bad input; `HR_STATUS_TRANSITION` when already revoked on or before `effectiveOn`; `HR_NOT_FOUND`
+	*/
+	async revoke(heldQualificationId, input) {
+		return this.transition(heldQualificationId, "revoked", {
+			effectiveOn: input?.effectiveOn,
+			reason: text("reason", input?.reason, true)
+		});
+	}
+	/**
+	* Record that the actor has verified a held qualification's document, now.
+	* Optionally attaches, replaces or removes the document. The status and the
+	* dated history do not change, and no event is raised. Verification is not
+	* a status, so it works whatever the standing, including on a row stored
+	* `revoked` (which may still be in force until its revocation takes effect).
+	*
+	* @throws HrError `HR_INVALID`, `HR_NOT_FOUND`
+	*/
+	async verify(heldQualificationId, input = {}) {
+		const id = this.id("heldQualificationId", heldQualificationId);
+		if (input == null || typeof input !== "object") throw invalid("verify takes an options object.");
+		const documentAssetId = input.documentAssetId === void 0 ? void 0 : this.optionalId("documentAssetId", input.documentAssetId);
+		await this.transact(async (db) => {
+			const row = await this.held(db, id);
+			if (documentAssetId !== void 0) row.documentAssetId = documentAssetId;
+			row.verifiedByProfileId = this.actor.profileId;
+			row.verifiedAt = /* @__PURE__ */ new Date();
+			await persistHr(row);
+		});
+		return this.held(this.db, id);
+	}
+	/**
+	* Record the lapse of every qualification whose last day is before `today`
+	* and that was still in force on it: an `expired` change dated the day
+	* after `expiresOn`. The application calls this from its own scheduler;
+	* checks never depend on it. Idempotent: a row is recorded once.
+	*
+	* Which rows lapsed is decided by date, not by the stored status, so a
+	* ticket that runs out while a suspension is in force, or while a
+	* revocation is recorded for a later day (a notice period), is recorded
+	* too. A row revoked on or before the day after `expiresOn` did not lapse:
+	* it was revoked. The stored status becomes `expired` only on a row stored
+	* `valid`; a stored `suspended` or `revoked` stays as it is.
+	*
+	* Every run re-reads the lapsed rows stored `suspended` or `revoked`, a set
+	* that only grows with a tenant's history. Pass `since` (a day on or before
+	* the last day the previous run covered) to look only at rows whose last
+	* day is on or after it.
+	*
+	* Emits `held-qualification.expired`, and returns the row, only for
+	* qualifications that were not renewed.
+	*
+	* @throws HrError `HR_INVALID` for a bad `today` or `since`
+	*/
+	async sweepExpired(today, options = {}) {
+		assertIsoDate("today", today);
+		const since = options?.since == null ? null : assertIsoDate("since", options.since);
+		const ids = await this.transact(async (db, queue) => {
+			const candidates = (await this.rows(db, {
+				status: [
+					"valid",
+					"suspended",
+					"revoked"
+				],
+				"expiresOn <": today,
+				...since === null ? {} : { "expiresOn >=": since }
+			})).filter((row) => row.expiresOn != null);
+			const changes = await this.changesByHeld(db, candidates);
+			const due = candidates.filter((row) => {
+				const history = changes.get(row.id) ?? [];
+				if (history.some((change) => change.kind === "expired")) return false;
+				const revokedOn = revokedFrom(history);
+				return revokedOn === null || revokedOn > addDays(row.expiresOn, 1);
+			});
+			const superseded = await this.supersededIds(db, due);
+			const emitted = [];
+			for (const row of due) {
+				const effectiveOn = addDays(row.expiresOn, 1);
+				if (row.status === "valid") {
+					row.status = "expired";
+					await persistHr(row);
+				}
+				await this.recordChange(db, row, "expired", effectiveOn, "");
+				if (superseded.has(row.id)) continue;
+				this.announce(queue, "held-qualification.expired", row, effectiveOn);
+				emitted.push(row.id);
+			}
+			return emitted;
+		});
+		return this.scope(async () => {
+			return (await this.rowsById(this.db, ids)).sort((a, b) => (a.expiresOn ?? "").localeCompare(b.expiresOn ?? "") || String(a.id).localeCompare(String(b.id)));
+		});
+	}
+	/**
+	* Whether a person holds a qualification on a calendar date. Computed from
+	* issue and expiry dates and the dated change history, never from the stored
+	* status alone, so it is correct for past dates and without the sweep. A
+	* renewal chain shares its standing: while a renewal is revoked or
+	* suspended, the row it renewed does not pass either. A blank profile or
+	* qualification id is `not-held`.
+	*/
+	async check(profileId, qualificationId, on) {
+		assertIsoDate("on", on);
+		const blank = (value) => typeof value !== "string" || !value.trim();
+		if (blank(profileId) || blank(qualificationId)) return {
+			ok: false,
+			reason: "not-held"
+		};
+		const where = {
+			profileId: this.id("profileId", profileId),
+			qualificationId: this.id("qualificationId", qualificationId)
+		};
+		return this.scope(async () => {
+			const rows = await this.rows(this.db, where);
+			if (rows.length === 0) return {
+				ok: false,
+				reason: "not-held"
+			};
+			const statuses = chainStatusesOn(rows, await this.changesByHeld(this.db, rows), on);
+			const good = rows.filter((row) => statuses.get(row.id) === "valid");
+			if (good.length > 0) {
+				const best = longestLasting(good);
+				return {
+					ok: true,
+					heldQualificationId: best.id,
+					expiresOn: best.expiresOn
+				};
+			}
+			const issued = rows.filter((row) => row.issuedOn <= on);
+			if (issued.length === 0) return {
+				ok: false,
+				reason: "not-yet-issued"
+			};
+			const latest = issued.reduce((a, b) => b.issuedOn > a.issuedOn || b.issuedOn === a.issuedOn && createdTime(b) >= createdTime(a) ? b : a);
+			return {
+				ok: false,
+				reason: statuses.get(latest.id)
+			};
+		});
+	}
+	/**
+	* One held qualification per person who passes {@link check} on `on`,
+	* ordered by profile id.
+	*/
+	async holders(qualificationId, on, options = {}) {
+		assertIsoDate("on", on);
+		const id = this.id("qualificationId", qualificationId);
+		return this.scope(async () => {
+			const rows = await this.rows(this.db, { qualificationId: id });
+			const statuses = chainStatusesOn(rows, await this.changesByHeld(this.db, rows), on);
+			const employed = options?.employedOnly ? new Set((await employmentsOn(this.db, this.actor.tenantId, on)).map((employment) => employment.profileId)) : null;
+			const good = /* @__PURE__ */ new Map();
+			for (const row of rows) {
+				if (employed && !employed.has(row.profileId)) continue;
+				if (statuses.get(row.id) !== "valid") continue;
+				good.set(row.profileId, [...good.get(row.profileId) ?? [], row]);
+			}
+			return [...good.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([, held]) => longestLasting(held));
+		});
+	}
+	/**
+	* Qualifications good on `today` (issued, and not suspended or revoked by
+	* the dated history, exactly as {@link check} decides) whose last day falls
+	* in `[today, today + days]`, soonest first. The stored status plays no
+	* part. A qualification that was already renewed is left out, and
+	* `employedOnly` keeps only people with an employment term covering `today`.
+	*/
+	async expiringWithin(days, today, options = {}) {
+		assertIsoDate("today", today);
+		if (!Number.isInteger(days) || days < 0) throw invalid("days must be a whole number, zero or more.");
+		return this.scope(async () => {
+			const rows = await this.rows(this.db, {
+				"issuedOn <=": today,
+				"expiresOn >=": today,
+				"expiresOn <=": addDays(today, days)
+			}, "expiresOn ASC");
+			const superseded = await this.supersededIds(this.db, rows);
+			const changes = await this.changesByHeld(this.db, rows);
+			const employed = options?.employedOnly ? new Set((await employmentsOn(this.db, this.actor.tenantId, today)).map((employment) => employment.profileId)) : null;
+			return rows.filter((row) => !superseded.has(row.id) && statusOn(row, changes.get(row.id) ?? [], today) === "valid" && (!employed || employed.has(row.profileId)));
+		});
+	}
+	/**
+	* Everything a person holds (renewed rows are replaced by their renewal),
+	* each with its definition and its status computed for `on`. The status
+	* agrees with {@link check}: it is `valid` when the row, or a row it renews,
+	* is good on `on`, and otherwise the status of the latest row of the chain
+	* issued by `on`. Ordered by qualification key, then issue date.
+	*
+	* @throws HrError `HR_INVALID` for a blank profile id or a bad date
+	*/
+	async listForProfile(profileId, on) {
+		assertIsoDate("on", on);
+		const id = this.id("profileId", profileId);
+		return this.scope(async () => {
+			const rows = await this.rows(this.db, { profileId: id });
+			const superseded = await this.supersededIds(this.db, rows);
+			const statuses = chainStatusesOn(rows, await this.changesByHeld(this.db, rows), on);
+			const byRowId = new Map(rows.map((row) => [row.id, row]));
+			const chainStatus = (held) => {
+				let answer = "not-yet-issued";
+				const seen = /* @__PURE__ */ new Set();
+				let earlier = held;
+				while (earlier && !seen.has(earlier.id)) {
+					seen.add(earlier.id);
+					const status = statuses.get(earlier.id);
+					if (status === "valid") return "valid";
+					if (answer === "not-yet-issued") answer = status;
+					earlier = earlier.renewalOfId ? byRowId.get(earlier.renewalOfId) : void 0;
+				}
+				return answer;
+			};
+			const definitions = await QualificationCollection.create({ db: this.db });
+			const byId = new Map((await definitions.list({ where: { tenantId: this.actor.tenantId } })).map((definition) => [definition.id, definition]));
+			return rows.filter((row) => !superseded.has(row.id)).map((held) => ({
+				held,
+				qualification: byId.get(held.qualificationId),
+				status: chainStatus(held)
+			})).sort((a, b) => a.qualification.key.localeCompare(b.qualification.key) || a.held.issuedOn.localeCompare(b.held.issuedOn) || createdTime(a.held) - createdTime(b.held));
+		});
+	}
+	/**
+	* The dated changes of one held qualification, oldest first.
+	*
+	* @throws HrError `HR_NOT_FOUND` outside the actor's tenant, `HR_INVALID` for a blank id
+	*/
+	async history(heldQualificationId) {
+		const id = this.id("heldQualificationId", heldQualificationId);
+		return this.scope(async () => {
+			const row = await this.held(this.db, id);
+			return (await this.changesByHeld(this.db, [row])).get(id) ?? [];
+		});
+	}
+	async byKey(db, key) {
+		const [row] = await (await QualificationCollection.create({ db })).list({
+			where: {
+				tenantId: this.actor.tenantId,
+				key
+			},
+			limit: 1
+		});
+		return row ?? null;
+	}
+	async definition(db, id) {
+		const [row] = await (await QualificationCollection.create({ db })).list({
+			where: {
+				tenantId: this.actor.tenantId,
+				id
+			},
+			limit: 1
+		});
+		if (!row) throw new HrError("HR_NOT_FOUND", "Qualification not found.");
+		return row;
+	}
+	async grantable(db, id) {
+		const definition = await this.definition(db, id);
+		if (!definition.isActive) throw invalid(`'${definition.key}' is inactive and cannot be granted.`);
+		return definition;
+	}
+	insertDefinition(db, definition) {
+		return insertHr(Qualification, db, {
+			tenantId: this.actor.tenantId,
+			...definition
+		});
+	}
+	async held(db, id) {
+		const [row] = await this.scope(() => this.rows(db, { id }));
+		if (!row) throw new HrError("HR_NOT_FOUND", "Held qualification not found.");
+		return row;
+	}
+	/** Held rows in the actor's tenant matching `where`. */
+	async rows(db, where, orderBy) {
+		return (await HeldQualificationCollection.create({ db })).list({
+			where: {
+				tenantId: this.actor.tenantId,
+				...where
+			},
+			orderBy
+		});
+	}
+	async rowsById(db, ids) {
+		const rows = [];
+		for (let at = 0; at < ids.length; at += IN_CHUNK) rows.push(...await this.rows(db, { id: ids.slice(at, at + IN_CHUNK) }));
+		return rows;
+	}
+	/**
+	* The chains among `rows` (everything one person holds of one
+	* qualification) that are not revoked effective on or before `on`, each
+	* represented by its latest row and the date its revocation takes effect,
+	* if one is recorded. The chain whose latest row is `exceptId` is skipped.
+	* Decided from the dated history: a revocation stored now but effective
+	* later still counts as held.
+	*/
+	async liveChains(db, rows, on, exceptId) {
+		const renewed = new Set(rows.map((row) => row.renewalOfId));
+		const latest = rows.filter((row) => !renewed.has(row.id) && row.id !== exceptId);
+		const changes = await this.changesByHeld(db, latest);
+		return latest.map((row) => ({
+			row,
+			revokedOn: revokedFrom(changes.get(row.id) ?? [])
+		})).filter(({ revokedOn }) => revokedOn === null || revokedOn > on);
+	}
+	/** Ids, among `rows`, that a later row renews. */
+	async supersededIds(db, rows) {
+		const ids = rows.map((row) => row.id);
+		const superseded = /* @__PURE__ */ new Set();
+		for (let at = 0; at < ids.length; at += IN_CHUNK) for (const renewal of await this.rows(db, { renewalOfId: ids.slice(at, at + IN_CHUNK) })) if (renewal.renewalOfId) superseded.add(renewal.renewalOfId);
+		return superseded;
+	}
+	/** Change rows per held qualification, oldest first. */
+	async changesByHeld(db, rows) {
+		const ids = rows.map((row) => row.id);
+		const collection = await HeldQualificationChangeCollection.create({ db });
+		const all = [];
+		for (let at = 0; at < ids.length; at += IN_CHUNK) all.push(...await collection.list({ where: {
+			tenantId: this.actor.tenantId,
+			heldQualificationId: ids.slice(at, at + IN_CHUNK)
+		} }));
+		all.sort((a, b) => a.effectiveOn.localeCompare(b.effectiveOn) || createdTime(a) - createdTime(b));
+		const grouped = /* @__PURE__ */ new Map();
+		for (const change of all) grouped.set(change.heldQualificationId, [...grouped.get(change.heldQualificationId) ?? [], change]);
+		return grouped;
+	}
+	/**
+	* The employment an employment-scoped grant belongs to (null for a
+	* person-scoped one) and, when the term covering `issuedOn` already has its
+	* end recorded, that term's last day. The person must be employed on
+	* `issuedOn`.
+	*/
+	async employmentFor(db, definition, profileId, given, issuedOn) {
+		const mismatch = (message) => new HrError("HR_QUALIFICATION_SCOPE", message);
+		if (definition.scope !== "employment") {
+			if (given != null) throw mismatch(`'${definition.key}' belongs to the person; omit employmentId.`);
+			return {
+				employmentId: null,
+				endsOn: null
+			};
+		}
+		const [employment] = await (await EmploymentCollection.create({ db })).list({
+			where: {
+				tenantId: this.actor.tenantId,
+				profileId,
+				...given != null ? { id: given } : {}
+			},
+			limit: 1
+		});
+		if (!employment) throw mismatch(`'${definition.key}' belongs to an employment, and this person has no matching employment.`);
+		const term = (await (await EmploymentTermCollection.create({ db })).list({ where: {
+			tenantId: this.actor.tenantId,
+			employmentId: employment.id,
+			"startedOn <=": issuedOn
+		} })).find((covering) => dateWithin(issuedOn, covering.startedOn, covering.endedOn));
+		if (!term) throw mismatch(`'${definition.key}' belongs to an employment, and this person is not employed on ${issuedOn}.`);
+		return {
+			employmentId: employment.id,
+			endsOn: term.endedOn
+		};
+	}
+	/**
+	* Insert a granted or renewed row with its change and event. With a
+	* `revocation` (the end of an employment term that is already closed, or a
+	* pending revocation a renewal carries forward) the row starts out cut off,
+	* exactly as `EmploymentService.end()` leaves the rows that existed when
+	* the end was recorded: stored `revoked`, a revocation on that date, and
+	* the revoked event.
+	*/
+	async insertHeld(db, queue, kind, values) {
+		const { input, revocation, ...identityFields } = values;
+		const verified = flag("verified", input.verified, false);
+		const row = await insertHr(HeldQualification, db, {
+			tenantId: this.actor.tenantId,
+			...identityFields,
+			certificateNumber: text("certificateNumber", input.certificateNumber),
+			documentAssetId: this.optionalId("documentAssetId", input.documentAssetId),
+			status: revocation === null ? "valid" : "revoked",
+			verifiedByProfileId: verified ? this.actor.profileId : null,
+			verifiedAt: verified ? /* @__PURE__ */ new Date() : null
+		});
+		await this.recordChange(db, row, kind, values.issuedOn, "");
+		this.announce(queue, `held-qualification.${kind}`, row, values.issuedOn);
+		if (revocation !== null) {
+			await this.recordChange(db, row, "revoked", revocation.on, revocation.reason);
+			this.announce(queue, "held-qualification.revoked", row, revocation.on);
+		}
+		return row;
+	}
+	/**
+	* Suspend, reinstate or revoke the latest row of a chain. The change is
+	* validated against the chain's dated history as of `effectiveOn`; the
+	* stored status is not consulted, except that a row stored `revoked` is
+	* never saved again and gets the change row only.
+	*/
+	async transition(heldQualificationId, kind, input) {
+		const id = this.id("heldQualificationId", heldQualificationId);
+		const effectiveOn = assertIsoDate("effectiveOn", input.effectiveOn);
+		await this.transact(async (db, queue) => {
+			const row = await this.held(db, id);
+			const siblings = await this.rows(db, {
+				profileId: row.profileId,
+				qualificationId: row.qualificationId
+			});
+			if (siblings.some((other) => other.renewalOfId === id)) throw invalid(`This qualification was renewed and cannot be ${kind} by itself; act on the latest row in its renewal chain.`);
+			const byId = new Map(siblings.map((other) => [other.id, other]));
+			const chain = [];
+			for (let member = row; member && !chain.includes(member); member = member.renewalOfId ? byId.get(member.renewalOfId) : void 0) chain.push(member);
+			const firstIssuedOn = chain.reduce((first, member) => member.issuedOn < first ? member.issuedOn : first, row.issuedOn);
+			if (effectiveOn < firstIssuedOn) throw invalid(`effectiveOn must not be before the qualification was issued on ${firstIssuedOn}.`);
+			const changes = await this.changesByHeld(db, chain);
+			const history = chain.flatMap((member) => changes.get(member.id) ?? []);
+			if (kind === "revoked") {
+				const revokedOn = revokedFrom(history);
+				if (revokedOn !== null && revokedOn <= effectiveOn) throw new HrError("HR_STATUS_TRANSITION", `This qualification is already revoked from ${revokedOn}.`);
+			} else {
+				const changedOn = latestOf(history, SUSPENSION_KINDS);
+				if (changedOn !== null && effectiveOn < changedOn) throw invalid(`effectiveOn must not be before the latest suspension or reinstatement on ${changedOn}.`);
+				const standing = standingOn(history, effectiveOn) ?? "valid";
+				if (standing !== (kind === "suspended" ? "valid" : "suspended")) throw new HrError("HR_STATUS_TRANSITION", standing === "valid" ? `A qualification that is not suspended on ${effectiveOn} cannot be reinstated.` : `A qualification that is ${standing} on ${effectiveOn} cannot be ${kind}.`);
+			}
+			if (row.status !== "revoked") {
+				const lapsed = (changes.get(id) ?? []).some((change) => change.kind === "expired");
+				row.status = kind === "reinstated" ? lapsed ? "expired" : "valid" : kind;
+				await persistHr(row);
+			}
+			await this.recordChange(db, row, kind, effectiveOn, input.reason);
+			this.announce(queue, `held-qualification.${kind}`, row, effectiveOn);
+		});
+		return this.held(this.db, id);
+	}
+	async recordChange(db, row, kind, effectiveOn, reason) {
+		await insertHr(HeldQualificationChange, db, {
+			tenantId: this.actor.tenantId,
+			heldQualificationId: row.id,
+			kind,
+			effectiveOn,
+			reason,
+			actorProfileId: this.actor.profileId
+		});
+	}
+	announce(queue, type, heldQualification, effectiveOn) {
+		queue({
+			type,
+			heldQualification,
+			effectiveOn,
+			at: /* @__PURE__ */ new Date(),
+			byProfileId: this.actor.profileId
+		});
+	}
+};
+//#endregion
+export { EMPLOYMENT_STATUS_TRANSITIONS, Employment, EmploymentChange, EmploymentChangeCollection, EmploymentCollection, EmploymentService, EmploymentTerm, EmploymentTermCollection, HUMAN_RESOURCES_MODULE_META, HUMAN_RESOURCES_UI_SLOTS, HeldQualification, HeldQualificationChange, HeldQualificationChangeCollection, HeldQualificationCollection, HrError, Qualification, QualificationCollection, QualificationService, SUGGESTED_QUALIFICATIONS, SUGGESTED_WORKER_TYPES, addDays, addMonths, assertIsoDate, isIsoDate };
+
+//# sourceMappingURL=index.js.map