@things-factory/worklist 10.1.248 → 10.1.249

package/dist-server/service/installable-activity/installable-activity-mutation.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstallableActivityMutation = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const activity_installation_controller_js_1 = require("../../controllers/activity-installation/activity-installation-controller.js");
+const activity_js_1 = require("../activity/activity.js");
+const installable_activity_js_1 = require("./installable-activity.js");
+let InstallableActivityMutation = class InstallableActivityMutation {
+    /**
+     * 양식을 이 도메인에 세운다.
+     *
+     * 세우는 방법은 `installActivity` 한 벌만 갖는다 — 화면에서 누르는 것과 앱이 기동할 때 세우는 것이
+     * 서로 다른 코드를 타면 언젠가 갈라지고, 그때 「화면으로 세운 것만 되는」 결함이 된다.
+     */
+    /*
+     * Authorization (2026-09-11)
+     *
+     * Both mutations here had no `@privilege` directive and no `checkAuthority` call inside, so any
+     * signed-in user of the domain could deactivate an activity. Deactivating one blocks the work it
+     * carries: with `OOC Review` (dataset) deactivated, that domain can no longer raise or process an
+     * out-of-control review.
+     *
+     * The pair is `activity:mutation`. These calls write this module's own `Activity` rows and grant
+     * no capability outside it, so one pair covers both. Seven existing declarations in this package
+     * already use that pair for creating, deleting and enabling the same entity, and both mutations
+     * return `Activity` rather than `Boolean`, which matches those seven rather than a light switch.
+     *
+     * `domainOwnerGranted: true` matches those seven as well. The people who actually call this are
+     * domain owners, and they pass without an explicit grant.
+     *
+     * This closes the door for the first time; it is not a rename, so there is no `legacy` alias to
+     * carry and no record of who was passing through while it was undeclared. If someone is blocked
+     * after this deploys, an administrator grants `activity:mutation` (the privilege row is created
+     * at boot).
+     */
+    async activateInstallableActivity(name, context) {
+        const { domain, user, tx } = context.state;
+        return await (0, activity_installation_controller_js_1.installActivity)(name, domain, { manager: tx, user });
+    }
+    /* Same privilege pair as activating. Deactivating is the heavier of the two: it stops submissions. */
+    async deactivateInstallableActivity(name, context) {
+        const { domain, user, tx } = context.state;
+        const repository = tx.getRepository(activity_js_1.Activity);
+        const activity = await repository.findOneBy({
+            domain: { id: domain.id },
+            name
+        });
+        if (!activity) {
+            return;
+        }
+        return await repository.save({
+            ...activity,
+            state: activity_js_1.ActivityStatus.Deprecated,
+            updater: user
+        });
+    }
+};
+exports.InstallableActivityMutation = InstallableActivityMutation;
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Directive)('@privilege(category: "activity", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Mutation)(returns => activity_js_1.Activity, { description: 'To activate installable activity to Activity on given domain' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('name')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], InstallableActivityMutation.prototype, "activateInstallableActivity", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Directive)('@privilege(category: "activity", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Mutation)(returns => activity_js_1.Activity, { description: 'To deactivate installable activity to Activity on given domain' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('name')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], InstallableActivityMutation.prototype, "deactivateInstallableActivity", null);
+exports.InstallableActivityMutation = InstallableActivityMutation = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(installable_activity_js_1.InstallableActivity)
+], InstallableActivityMutation);
+//# sourceMappingURL=installable-activity-mutation.js.map

package/dist-server/service/installable-activity/installable-activity-mutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installable-activity-mutation.js","sourceRoot":"","sources":["../../../server/service/installable-activity/installable-activity-mutation.ts"],"names":[],"mappings":";;;;AAAA,+CAAsE;AAEtE,qIAA6G;AAC7G,yDAAkE;AAClE,uEAA+D;AAGxD,IAAM,2BAA2B,GAAjC,MAAM,2BAA2B;IACtC;;;;;OAKG;IACH;;;;;;;;;;;;;;;;;;;;OAoBG;IAIG,AAAN,KAAK,CAAC,2BAA2B,CAAc,IAAY,EAAS,OAAwB;QAC1F,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAE1C,OAAO,MAAM,IAAA,qDAAe,EAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;IACnE,CAAC;IAED,sGAAsG;IAIhG,AAAN,KAAK,CAAC,6BAA6B,CAAc,IAAY,EAAS,OAAwB;QAC5F,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAC1C,MAAM,UAAU,GAAG,EAAE,CAAC,aAAa,CAAC,sBAAQ,CAAC,CAAA;QAE7C,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC;YAC1C,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE;YACzB,IAAI;SACL,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAM;QACR,CAAC;QAED,OAAO,MAAM,UAAU,CAAC,IAAI,CAAC;YAC3B,GAAG,QAAQ;YACX,KAAK,EAAE,4BAAc,CAAC,UAAU;YAChC,OAAO,EAAE,IAAI;SACd,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AA5DY,kEAA2B;AA+BhC;IAHL,IAAA,wBAAS,EAAC,cAAc,CAAC;IACzB,IAAA,wBAAS,EAAC,mFAAmF,CAAC;IAC9F,IAAA,uBAAQ,EAAC,OAAO,CAAC,EAAE,CAAC,sBAAQ,EAAE,EAAE,WAAW,EAAE,8DAA8D,EAAE,CAAC;IAC5E,mBAAA,IAAA,kBAAG,EAAC,MAAM,CAAC,CAAA;IAAgB,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;8EAIlE;AAMK;IAHL,IAAA,wBAAS,EAAC,cAAc,CAAC;IACzB,IAAA,wBAAS,EAAC,mFAAmF,CAAC;IAC9F,IAAA,uBAAQ,EAAC,OAAO,CAAC,EAAE,CAAC,sBAAQ,EAAE,EAAE,WAAW,EAAE,gEAAgE,EAAE,CAAC;IAC5E,mBAAA,IAAA,kBAAG,EAAC,MAAM,CAAC,CAAA;IAAgB,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;gFAkBpE;sCA3DU,2BAA2B;IADvC,IAAA,uBAAQ,EAAC,6CAAmB,CAAC;GACjB,2BAA2B,CA4DvC","sourcesContent":["import { Arg, Ctx, Directive, Mutation, Resolver } from 'type-graphql'\n\nimport { installActivity } from '../../controllers/activity-installation/activity-installation-controller.js'\nimport { Activity, ActivityStatus } from '../activity/activity.js'\nimport { InstallableActivity } from './installable-activity.js'\n\n@Resolver(InstallableActivity)\nexport class InstallableActivityMutation {\n  /**\n   * 양식을 이 도메인에 세운다.\n   *\n   * 세우는 방법은 `installActivity` 한 벌만 갖는다 — 화면에서 누르는 것과 앱이 기동할 때 세우는 것이\n   * 서로 다른 코드를 타면 언젠가 갈라지고, 그때 「화면으로 세운 것만 되는」 결함이 된다.\n   */\n  /*\n   * Authorization (2026-09-11)\n   *\n   * Both mutations here had no `@privilege` directive and no `checkAuthority` call inside, so any\n   * signed-in user of the domain could deactivate an activity. Deactivating one blocks the work it\n   * carries: with `OOC Review` (dataset) deactivated, that domain can no longer raise or process an\n   * out-of-control review.\n   *\n   * The pair is `activity:mutation`. These calls write this module's own `Activity` rows and grant\n   * no capability outside it, so one pair covers both. Seven existing declarations in this package\n   * already use that pair for creating, deleting and enabling the same entity, and both mutations\n   * return `Activity` rather than `Boolean`, which matches those seven rather than a light switch.\n   *\n   * `domainOwnerGranted: true` matches those seven as well. The people who actually call this are\n   * domain owners, and they pass without an explicit grant.\n   *\n   * This closes the door for the first time; it is not a rename, so there is no `legacy` alias to\n   * carry and no record of who was passing through while it was undeclared. If someone is blocked\n   * after this deploys, an administrator grants `activity:mutation` (the privilege row is created\n   * at boot).\n   */\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"activity\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Mutation(returns => Activity, { description: 'To activate installable activity to Activity on given domain' })\n  async activateInstallableActivity(@Arg('name') name: string, @Ctx() context: ResolverContext): Promise<Activity> {\n    const { domain, user, tx } = context.state\n\n    return await installActivity(name, domain, { manager: tx, user })\n  }\n\n  /* Same privilege pair as activating. Deactivating is the heavier of the two: it stops submissions. */\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"activity\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Mutation(returns => Activity, { description: 'To deactivate installable activity to Activity on given domain' })\n  async deactivateInstallableActivity(@Arg('name') name: string, @Ctx() context: ResolverContext): Promise<Activity> {\n    const { domain, user, tx } = context.state\n    const repository = tx.getRepository(Activity)\n\n    const activity = await repository.findOneBy({\n      domain: { id: domain.id },\n      name\n    })\n\n    if (!activity) {\n      return\n    }\n\n    return await repository.save({\n      ...activity,\n      state: ActivityStatus.Deprecated,\n      updater: user\n    })\n  }\n}\n"]}

package/dist-server/service/installable-activity/installable-activity-query.d.ts

@@ -0,0 +1,22 @@
+import { ListParam } from '@things-factory/shell';
+import { InstallableActivity } from './installable-activity.js';
+import { InstallableActivityList } from './installable-activity-type.js';
+export declare class InstallableActivityQuery {
+    installableActivity(name: string, context: ResolverContext): Promise<InstallableActivity>;
+    installableActivities(params: ListParam, context: ResolverContext): Promise<InstallableActivityList>;
+    /** The key `label` is translated from. Computed from `name`, never stored — see activityTKey. */
+    labelTKey(one: InstallableActivity): string;
+    /** One key per `guide` line, in the same order and always the same length. */
+    guideTKeys(one: InstallableActivity): string[];
+    /**
+     * The keys `readiness.notes` and `readiness.gaps` are translated from.
+     *
+     * The catalog is built at boot, before any request names a locale, so the module keeps declaring
+     * sentences and the screen reads a translation of them - the same arrangement as label and guide
+     * (ADR-0054). A module that declares nothing gets no keys to look up, and the screen shows
+     * nothing, which is what it did before.
+     */
+    readinessNotesTKey(one: InstallableActivity): string;
+    /** One key per `readiness.gaps` line, in the same order and always the same length. */
+    readinessGapTKeys(one: InstallableActivity): string[];
+}

package/dist-server/service/installable-activity/installable-activity-query.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstallableActivityQuery = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const activity_installation_controller_js_1 = require("../../controllers/activity-installation/activity-installation-controller.js");
+const activity_js_1 = require("../activity/activity.js");
+const installable_activity_js_1 = require("./installable-activity.js");
+const approval_line_js_1 = require("../../controllers/activity-approval/approval-line.js");
+const installable_activity_type_js_1 = require("./installable-activity-type.js");
+const decision_key_declaration_js_1 = require("../activity/decision-key-declaration.js");
+let InstallableActivityQuery = class InstallableActivityQuery {
+    async installableActivity(name, context) {
+        return await activity_installation_controller_js_1.ActivityInstallations.get(name);
+    }
+    async installableActivities(params, context) {
+        const { domain } = context.state;
+        const items = activity_installation_controller_js_1.ActivityInstallations.list();
+        for (var item of items) {
+            item.activity = await (0, shell_1.getRepository)(activity_js_1.Activity).findOneBy({
+                domain: { id: domain.id },
+                name: item.name
+            });
+            /*
+             * 「이 도메인이 이 단계를 쓰나」를 값으로 낸다 — 판단은 여기서 다시 짜지 않는다.
+             *
+             * `isApprovalStep` 이 참조를 걸러 내는 그 자리다. 화면이 길이를 세면 참조만 있는 결재선을
+             * 「결재자 있음」으로 그리고, 실제로는 그냥 지나간다.
+             */
+            item.approvalSteps = (item.activity?.approvalLine || []).filter(approval_line_js_1.isApprovalStep).length;
+        }
+        /*
+         * Identified-but-unbuilt work comes out of this query too, because the catalog is the plan of
+         * record — "what is left" has to be answerable on the screen.
+         *
+         * Shaped to look like an installable activity so the screen has one list to draw, but it
+         * carries no `activity` (nothing is installed) and no callback. Its stage says planned or
+         * not-worklist, and the screen keeps those apart from the built ones: a decision must not read
+         * as a promise.
+         */
+        const intended = activity_installation_controller_js_1.ActivityInstallations.listIntended().map(one => ({
+            name: one.key,
+            label: one.label,
+            description: undefined,
+            guide: one.guide,
+            category: one.category,
+            readiness: one.readiness
+        }));
+        const merged = [...items, ...intended];
+        return { items: merged, total: merged.length };
+    }
+    /** The key `label` is translated from. Computed from `name`, never stored — see activityTKey. */
+    labelTKey(one) {
+        return (0, decision_key_declaration_js_1.activityTKey)(one.name, 'label');
+    }
+    /** One key per `guide` line, in the same order and always the same length. */
+    guideTKeys(one) {
+        return (0, decision_key_declaration_js_1.activityGuideTKeys)(one.name, one.guide);
+    }
+    /**
+     * The keys `readiness.notes` and `readiness.gaps` are translated from.
+     *
+     * The catalog is built at boot, before any request names a locale, so the module keeps declaring
+     * sentences and the screen reads a translation of them - the same arrangement as label and guide
+     * (ADR-0054). A module that declares nothing gets no keys to look up, and the screen shows
+     * nothing, which is what it did before.
+     */
+    readinessNotesTKey(one) {
+        return (0, decision_key_declaration_js_1.activityTKey)(one.name, 'readiness-notes');
+    }
+    /** One key per `readiness.gaps` line, in the same order and always the same length. */
+    readinessGapTKeys(one) {
+        return (0, decision_key_declaration_js_1.activityReadinessGapTKeys)(one.name, one.readiness?.gaps);
+    }
+};
+exports.InstallableActivityQuery = InstallableActivityQuery;
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(returns => installable_activity_js_1.InstallableActivity, { nullable: true, description: 'To fetch a InstallableActivity' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('name')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], InstallableActivityQuery.prototype, "installableActivity", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(returns => installable_activity_type_js_1.InstallableActivityList, { description: 'To fetch multiple InstallableActivitys' }),
+    tslib_1.__param(0, (0, type_graphql_1.Args)(type => shell_1.ListParam)),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [shell_1.ListParam, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], InstallableActivityQuery.prototype, "installableActivities", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => String, { description: 'i18n key the label is translated from, computed from name' }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [installable_activity_js_1.InstallableActivity]),
+    tslib_1.__metadata("design:returntype", String)
+], InstallableActivityQuery.prototype, "labelTKey", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => [String], { description: 'One i18n key per guide line, in order, computed from name' }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [installable_activity_js_1.InstallableActivity]),
+    tslib_1.__metadata("design:returntype", Array)
+], InstallableActivityQuery.prototype, "guideTKeys", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => String, { description: 'i18n key readiness.notes is translated from, computed from name' }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [installable_activity_js_1.InstallableActivity]),
+    tslib_1.__metadata("design:returntype", String)
+], InstallableActivityQuery.prototype, "readinessNotesTKey", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => [String], {
+        description: 'One i18n key per readiness.gaps line, in order, computed from name'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [installable_activity_js_1.InstallableActivity]),
+    tslib_1.__metadata("design:returntype", Array)
+], InstallableActivityQuery.prototype, "readinessGapTKeys", null);
+exports.InstallableActivityQuery = InstallableActivityQuery = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(installable_activity_js_1.InstallableActivity)
+], InstallableActivityQuery);
+//# sourceMappingURL=installable-activity-query.js.map

package/dist-server/service/installable-activity/installable-activity-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installable-activity-query.js","sourceRoot":"","sources":["../../../server/service/installable-activity/installable-activity-query.ts"],"names":[],"mappings":"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","sourcesContent":["import { Arg, Args, Ctx, Query, Resolver, FieldResolver, Root } from 'type-graphql'\nimport { Domain, getRepository, ListParam } from '@things-factory/shell'\n\nimport { ActivityInstallations } from '../../controllers/activity-installation/activity-installation-controller.js'\nimport { Activity } from '../activity/activity.js'\nimport { InstallableActivity } from './installable-activity.js'\nimport { isApprovalStep } from '../../controllers/activity-approval/approval-line.js'\nimport { InstallableActivityList } from './installable-activity-type.js'\nimport { activityGuideTKeys, activityReadinessGapTKeys, activityTKey } from '../activity/decision-key-declaration.js'\n\n@Resolver(InstallableActivity)\nexport class InstallableActivityQuery {\n  @Query(returns => InstallableActivity!, { nullable: true, description: 'To fetch a InstallableActivity' })\n  async installableActivity(@Arg('name') name: string, @Ctx() context: ResolverContext): Promise<InstallableActivity> {\n    return await ActivityInstallations.get(name)\n  }\n\n  @Query(returns => InstallableActivityList, { description: 'To fetch multiple InstallableActivitys' })\n  async installableActivities(\n    @Args(type => ListParam) params: ListParam,\n    @Ctx() context: ResolverContext\n  ): Promise<InstallableActivityList> {\n    const { domain } = context.state\n\n    const items = ActivityInstallations.list()\n\n    for (var item of items) {\n      item.activity = await getRepository(Activity).findOneBy({\n        domain: { id: domain.id },\n        name: item.name\n      })\n\n      /*\n       * 「이 도메인이 이 단계를 쓰나」를 값으로 낸다 — 판단은 여기서 다시 짜지 않는다.\n       *\n       * `isApprovalStep` 이 참조를 걸러 내는 그 자리다. 화면이 길이를 세면 참조만 있는 결재선을\n       * 「결재자 있음」으로 그리고, 실제로는 그냥 지나간다.\n       */\n      item.approvalSteps = (item.activity?.approvalLine || []).filter(isApprovalStep).length\n    }\n\n    /*\n     * Identified-but-unbuilt work comes out of this query too, because the catalog is the plan of\n     * record — \"what is left\" has to be answerable on the screen.\n     *\n     * Shaped to look like an installable activity so the screen has one list to draw, but it\n     * carries no `activity` (nothing is installed) and no callback. Its stage says planned or\n     * not-worklist, and the screen keeps those apart from the built ones: a decision must not read\n     * as a promise.\n     */\n    const intended: InstallableActivity[] = ActivityInstallations.listIntended().map(one => ({\n      name: one.key,\n      label: one.label,\n      description: undefined,\n      guide: one.guide,\n      category: one.category,\n      readiness: one.readiness\n    }))\n\n    const merged = [...items, ...intended]\n\n    return { items: merged, total: merged.length }\n  }\n\n  /** The key `label` is translated from. Computed from `name`, never stored — see activityTKey. */\n  @FieldResolver(type => String, { description: 'i18n key the label is translated from, computed from name' })\n  labelTKey(@Root() one: InstallableActivity): string {\n    return activityTKey(one.name, 'label')\n  }\n\n  /** One key per `guide` line, in the same order and always the same length. */\n  @FieldResolver(type => [String], { description: 'One i18n key per guide line, in order, computed from name' })\n  guideTKeys(@Root() one: InstallableActivity): string[] {\n    return activityGuideTKeys(one.name, one.guide)\n  }\n\n  /**\n   * The keys `readiness.notes` and `readiness.gaps` are translated from.\n   *\n   * The catalog is built at boot, before any request names a locale, so the module keeps declaring\n   * sentences and the screen reads a translation of them - the same arrangement as label and guide\n   * (ADR-0054). A module that declares nothing gets no keys to look up, and the screen shows\n   * nothing, which is what it did before.\n   */\n  @FieldResolver(type => String, { description: 'i18n key readiness.notes is translated from, computed from name' })\n  readinessNotesTKey(@Root() one: InstallableActivity): string {\n    return activityTKey(one.name, 'readiness-notes')\n  }\n\n  /** One key per `readiness.gaps` line, in the same order and always the same length. */\n  @FieldResolver(type => [String], {\n    description: 'One i18n key per readiness.gaps line, in order, computed from name'\n  })\n  readinessGapTKeys(@Root() one: InstallableActivity): string[] {\n    return activityReadinessGapTKeys(one.name, one.readiness?.gaps)\n  }\n}\n"]}

package/dist-server/service/installable-activity/installable-activity-type.d.ts

@@ -0,0 +1,5 @@
+import { InstallableActivity } from './installable-activity.js';
+export declare class InstallableActivityList {
+    items: InstallableActivity[];
+    total: number;
+}

package/dist-server/service/installable-activity/installable-activity-type.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstallableActivityList = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const installable_activity_js_1 = require("./installable-activity.js");
+let InstallableActivityList = class InstallableActivityList {
+};
+exports.InstallableActivityList = InstallableActivityList;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [installable_activity_js_1.InstallableActivity]),
+    tslib_1.__metadata("design:type", Array)
+], InstallableActivityList.prototype, "items", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int),
+    tslib_1.__metadata("design:type", Number)
+], InstallableActivityList.prototype, "total", void 0);
+exports.InstallableActivityList = InstallableActivityList = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)()
+], InstallableActivityList);
+//# sourceMappingURL=installable-activity-type.js.map

package/dist-server/service/installable-activity/installable-activity-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installable-activity-type.js","sourceRoot":"","sources":["../../../server/service/installable-activity/installable-activity-type.ts"],"names":[],"mappings":";;;;AAAA,+CAAqD;AAErD,uEAA+D;AAGxD,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;CAMnC,CAAA;AANY,0DAAuB;AAElC;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,6CAAmB,CAAC,CAAC;;sDACT;AAG5B;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,CAAC;;sDACN;kCALF,uBAAuB;IADnC,IAAA,yBAAU,GAAE;GACA,uBAAuB,CAMnC","sourcesContent":["import { Field, Int, ObjectType } from 'type-graphql'\n\nimport { InstallableActivity } from './installable-activity.js'\n\n@ObjectType()\nexport class InstallableActivityList {\n  @Field(type => [InstallableActivity])\n  items: InstallableActivity[]\n\n  @Field(type => Int)\n  total: number\n}\n"]}

package/dist-server/service/installable-activity/installable-activity.d.ts

@@ -0,0 +1,92 @@
+import { Activity, ActivityStartingType, ActivityType, ActivityUIType, MultipleInstanceType } from '../activity/activity.js';
+import { ActivityModelItem } from '../activity/activity-model-type.js';
+import { ActivityDecisionKeyItem } from '../activity/activity-decision-key-item-type.js';
+import { ActivityReadiness } from './activity-readiness.js';
+import { UpdateActivityInstanceStateAddendum } from '../../controllers/common.js';
+export declare class InstallableActivity {
+    /**
+     * The key. **Not a name to show anyone.**
+     *
+     * The callback is found by this value (`activityInstance.activity.name`), so renaming it stops
+     * the callback from running — an approval completes and the effect never happens, with nothing
+     * on screen to say so. plant hit exactly that on 2026-09-01.
+     */
+    name?: string;
+    /**
+     * What to call this work on screen, when the key is not something a person reads.
+     *
+     * The catalog showed 「MES Disposition Approval」 among twenty-three Korean cards because the key
+     * was the only name it had. Declared work already carried a `label` for this; built work had
+     * nowhere to put one, so the identifier leaked into the screen.
+     *
+     * Optional. Without it the catalog falls back to the key, which is right for activities whose
+     * key already reads as a name.
+     */
+    label?: string;
+    release?: string;
+    provider?: string;
+    /** One line for developers, in English, like every other GraphQL description in this repo. */
+    description?: string;
+    /**
+     * What this work is, **in the words of the person who receives it.**
+     *
+     * `description` is written for us and it is English by convention, so a Korean screen showing it
+     * to an approver says nothing useful. This field is the sentence that person actually needs:
+     * when the item reaches them, and what happens once they approve it.
+     *
+     * Plain sentences, never keys. A translation is read from `guideTKeys` — one key per line,
+     * computed from `name` — with the sentence here as its default. A value that could be either a key
+     * or a sentence leaves no way to count which keys a locale is missing.
+     */
+    guide?: string[];
+    category?: string;
+    activityType?: ActivityType;
+    priority?: number;
+    startingType?: ActivityStartingType;
+    multiple?: MultipleInstanceType;
+    model?: ActivityModelItem[];
+    /**
+     * Which input values an approver judges by. See Activity.decisionKeys.
+     *
+     * A field declared here reaches the Activity row only if it is named in ACTIVITY_ROW_FIELDS and
+     * the entity has a column for it. It used to be a spread, which dropped what it did not recognise
+     * and reported success; naming the fields means a new one has to be wired over on purpose.
+     */
+    decisionKeys?: ActivityDecisionKeyItem[];
+    uiType?: ActivityUIType;
+    uiSource?: string;
+    viewType?: ActivityUIType;
+    viewSource?: string;
+    reportType?: ActivityUIType;
+    reportSource?: string;
+    thumbnail?: string;
+    activity?: Activity;
+    /**
+     * **이 도메인이 이 단계를 쓰나** — 세워진 양식의 결재선에 결재자가 있나.
+     *
+     * 결재선은 양식이 아니라 **그 현장이 정하는 것**이다(installActivity 머리말). 그래서 같은 업무가
+     * 어느 공장에서는 결재를 받고 어느 공장에서는 그냥 지나간다.
+     *
+     * 그 사실이 지금까지 **기동 로그 한 줄**에만 있었다 — 「결재선 비어 있음 miratek, system」. 로그는
+     * 기동할 때 한 번 지나가고 그 뒤로 아무 데도 없다. 사람이 조치해야 하는 사실의 집이 아니다.
+     *
+     * 세지 않는 것 둘을 적어 둔다.
+     *
+     * - **사람 수가 아니라 단계 수다.** 역할로 걸린 한 단계는 그 역할을 가진 여러 사람이 본다. 「3명」
+     *   이라고 적으면 틀린 수를 말하게 된다.
+     * - **참조는 세지 않는다.** 참조는 결재를 막지 않으므로, 참조만 있는 결재선은 결재자가 없는 것과
+     *   같다(needsApproval). 세면 「이 단계를 쓴다」로 읽히는데 실제로는 그냥 지나간다.
+     *
+     * 비어 있다는 것이 무슨 일을 뜻하는지는 **업무마다 다르다** — 부적합 처분은 상신이 막히고, 정비
+     * 완료 확인은 확인 없이 닫힌다. 그 결과는 각 업무의 guide 가 말할 자리다. 이 칸은 사실만 낸다.
+     */
+    approvalSteps?: number;
+    /**
+     * What the registering module says about how far along this type is.
+     *
+     * Declared, not computed — see ActivityReadiness. Missing means nobody has said, which the
+     * screen shows as 「선언 없음」 rather than as a zero.
+     */
+    readiness?: ActivityReadiness;
+    callback?: (content: any, addendum: UpdateActivityInstanceStateAddendum, context: ResolverContext) => void;
+}

package/dist-server/service/installable-activity/installable-activity.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstallableActivity = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const activity_js_1 = require("../activity/activity.js");
+const activity_model_type_js_1 = require("../activity/activity-model-type.js");
+const activity_decision_key_item_type_js_1 = require("../activity/activity-decision-key-item-type.js");
+const activity_readiness_js_1 = require("./activity-readiness.js");
+let InstallableActivity = class InstallableActivity {
+    constructor() {
+        this.priority = 1;
+    }
+};
+exports.InstallableActivity = InstallableActivity;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], InstallableActivity.prototype, "name", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'What to call this work on screen, when the key is not readable' }),
+    tslib_1.__metadata("design:type", String)
+], InstallableActivity.prototype, "label", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Release information of the Activity' }),
+    tslib_1.__metadata("design:type", String)
+], InstallableActivity.prototype, "release", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Provider information of the Activity' }),
+    tslib_1.__metadata("design:type", String)
+], InstallableActivity.prototype, "provider", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], InstallableActivity.prototype, "description", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [String], {
+        nullable: true,
+        description: 'What this work is, for the person who receives it. Plain sentences; translated through guideTKeys.'
+    }),
+    tslib_1.__metadata("design:type", Array)
+], InstallableActivity.prototype, "guide", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], InstallableActivity.prototype, "category", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], InstallableActivity.prototype, "activityType", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Number)
+], InstallableActivity.prototype, "priority", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], InstallableActivity.prototype, "startingType", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({
+        nullable: true,
+        description: 'Parallel or sequential are properties as a multi-instance activity, otherwise it means a single instance.'
+    }),
+    tslib_1.__metadata("design:type", String)
+], InstallableActivity.prototype, "multiple", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [activity_model_type_js_1.ActivityModelItem], { nullable: true }),
+    tslib_1.__metadata("design:type", Array)
+], InstallableActivity.prototype, "model", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [activity_decision_key_item_type_js_1.ActivityDecisionKeyItem], { nullable: true }),
+    tslib_1.__metadata("design:type", Array)
+], InstallableActivity.prototype, "decisionKeys", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], InstallableActivity.prototype, "uiType", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], InstallableActivity.prototype, "uiSource", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], InstallableActivity.prototype, "viewType", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], InstallableActivity.prototype, "viewSource", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], InstallableActivity.prototype, "reportType", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], InstallableActivity.prototype, "reportSource", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => String, { nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], InstallableActivity.prototype, "thumbnail", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => activity_js_1.Activity, { nullable: true }),
+    tslib_1.__metadata("design:type", activity_js_1.Activity
+    /**
+     * **이 도메인이 이 단계를 쓰나** — 세워진 양식의 결재선에 결재자가 있나.
+     *
+     * 결재선은 양식이 아니라 **그 현장이 정하는 것**이다(installActivity 머리말). 그래서 같은 업무가
+     * 어느 공장에서는 결재를 받고 어느 공장에서는 그냥 지나간다.
+     *
+     * 그 사실이 지금까지 **기동 로그 한 줄**에만 있었다 — 「결재선 비어 있음 miratek, system」. 로그는
+     * 기동할 때 한 번 지나가고 그 뒤로 아무 데도 없다. 사람이 조치해야 하는 사실의 집이 아니다.
+     *
+     * 세지 않는 것 둘을 적어 둔다.
+     *
+     * - **사람 수가 아니라 단계 수다.** 역할로 걸린 한 단계는 그 역할을 가진 여러 사람이 본다. 「3명」
+     *   이라고 적으면 틀린 수를 말하게 된다.
+     * - **참조는 세지 않는다.** 참조는 결재를 막지 않으므로, 참조만 있는 결재선은 결재자가 없는 것과
+     *   같다(needsApproval). 세면 「이 단계를 쓴다」로 읽히는데 실제로는 그냥 지나간다.
+     *
+     * 비어 있다는 것이 무슨 일을 뜻하는지는 **업무마다 다르다** — 부적합 처분은 상신이 막히고, 정비
+     * 완료 확인은 확인 없이 닫힌다. 그 결과는 각 업무의 guide 가 말할 자리다. 이 칸은 사실만 낸다.
+     */
+    )
+], InstallableActivity.prototype, "activity", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, {
+        nullable: true,
+        description: 'How many approval steps this activity has in this domain. Steps, not people; references excluded.'
+    }),
+    tslib_1.__metadata("design:type", Number)
+], InstallableActivity.prototype, "approvalSteps", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => activity_readiness_js_1.ActivityReadiness, { nullable: true }),
+    tslib_1.__metadata("design:type", activity_readiness_js_1.ActivityReadiness)
+], InstallableActivity.prototype, "readiness", void 0);
+exports.InstallableActivity = InstallableActivity = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'Entity for InstallableActivity' })
+], InstallableActivity);
+//# sourceMappingURL=installable-activity.js.map

package/dist-server/service/installable-activity/installable-activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installable-activity.js","sourceRoot":"","sources":["../../../server/service/installable-activity/installable-activity.ts"],"names":[],"mappings":"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","sourcesContent":["import { Field, Int, ObjectType } from 'type-graphql'\n\nimport {\n  Activity,\n  ActivityStartingType,\n  ActivityType,\n  ActivityUIType,\n  MultipleInstanceType\n} from '../activity/activity.js'\nimport { ActivityModelItem } from '../activity/activity-model-type.js'\nimport { ActivityDecisionKeyItem } from '../activity/activity-decision-key-item-type.js'\nimport { ActivityReadiness } from './activity-readiness.js'\nimport { UpdateActivityInstanceStateAddendum } from '../../controllers/common.js'\n\n@ObjectType({ description: 'Entity for InstallableActivity' })\nexport class InstallableActivity {\n  /**\n   * The key. **Not a name to show anyone.**\n   *\n   * The callback is found by this value (`activityInstance.activity.name`), so renaming it stops\n   * the callback from running — an approval completes and the effect never happens, with nothing\n   * on screen to say so. plant hit exactly that on 2026-09-01.\n   */\n  @Field({ nullable: true })\n  name?: string\n\n  /**\n   * What to call this work on screen, when the key is not something a person reads.\n   *\n   * The catalog showed 「MES Disposition Approval」 among twenty-three Korean cards because the key\n   * was the only name it had. Declared work already carried a `label` for this; built work had\n   * nowhere to put one, so the identifier leaked into the screen.\n   *\n   * Optional. Without it the catalog falls back to the key, which is right for activities whose\n   * key already reads as a name.\n   */\n  @Field({ nullable: true, description: 'What to call this work on screen, when the key is not readable' })\n  label?: string\n\n  @Field({ nullable: true, description: 'Release information of the Activity' })\n  release?: string\n\n  @Field({ nullable: true, description: 'Provider information of the Activity' })\n  provider?: string\n\n  /** One line for developers, in English, like every other GraphQL description in this repo. */\n  @Field({ nullable: true })\n  description?: string\n\n  /**\n   * What this work is, **in the words of the person who receives it.**\n   *\n   * `description` is written for us and it is English by convention, so a Korean screen showing it\n   * to an approver says nothing useful. This field is the sentence that person actually needs:\n   * when the item reaches them, and what happens once they approve it.\n   *\n   * Plain sentences, never keys. A translation is read from `guideTKeys` — one key per line,\n   * computed from `name` — with the sentence here as its default. A value that could be either a key\n   * or a sentence leaves no way to count which keys a locale is missing.\n   */\n  @Field(type => [String], {\n    nullable: true,\n    description: 'What this work is, for the person who receives it. Plain sentences; translated through guideTKeys.'\n  })\n  guide?: string[]\n\n  @Field({ nullable: true })\n  category?: string\n\n  @Field({ nullable: true })\n  activityType?: ActivityType\n\n  @Field({ nullable: true })\n  priority?: number = 1\n\n  @Field({ nullable: true })\n  startingType?: ActivityStartingType\n\n  @Field({\n    nullable: true,\n    description:\n      'Parallel or sequential are properties as a multi-instance activity, otherwise it means a single instance.'\n  })\n  multiple?: MultipleInstanceType\n\n  @Field(type => [ActivityModelItem], { nullable: true })\n  model?: ActivityModelItem[]\n\n  /**\n   * Which input values an approver judges by. See Activity.decisionKeys.\n   *\n   * A field declared here reaches the Activity row only if it is named in ACTIVITY_ROW_FIELDS and\n   * the entity has a column for it. It used to be a spread, which dropped what it did not recognise\n   * and reported success; naming the fields means a new one has to be wired over on purpose.\n   */\n  @Field(type => [ActivityDecisionKeyItem], { nullable: true })\n  decisionKeys?: ActivityDecisionKeyItem[]\n\n  @Field({ nullable: true })\n  uiType?: ActivityUIType\n\n  @Field({ nullable: true })\n  uiSource?: string\n\n  @Field({ nullable: true })\n  viewType?: ActivityUIType\n\n  @Field({ nullable: true })\n  viewSource?: string\n\n  @Field({ nullable: true })\n  reportType?: ActivityUIType\n\n  @Field({ nullable: true })\n  reportSource?: string\n\n  @Field(type => String, { nullable: true })\n  thumbnail?: string\n\n  @Field(type => Activity, { nullable: true })\n  activity?: Activity\n\n  /**\n   * **이 도메인이 이 단계를 쓰나** — 세워진 양식의 결재선에 결재자가 있나.\n   *\n   * 결재선은 양식이 아니라 **그 현장이 정하는 것**이다(installActivity 머리말). 그래서 같은 업무가\n   * 어느 공장에서는 결재를 받고 어느 공장에서는 그냥 지나간다.\n   *\n   * 그 사실이 지금까지 **기동 로그 한 줄**에만 있었다 — 「결재선 비어 있음 miratek, system」. 로그는\n   * 기동할 때 한 번 지나가고 그 뒤로 아무 데도 없다. 사람이 조치해야 하는 사실의 집이 아니다.\n   *\n   * 세지 않는 것 둘을 적어 둔다.\n   *\n   * - **사람 수가 아니라 단계 수다.** 역할로 걸린 한 단계는 그 역할을 가진 여러 사람이 본다. 「3명」\n   *   이라고 적으면 틀린 수를 말하게 된다.\n   * - **참조는 세지 않는다.** 참조는 결재를 막지 않으므로, 참조만 있는 결재선은 결재자가 없는 것과\n   *   같다(needsApproval). 세면 「이 단계를 쓴다」로 읽히는데 실제로는 그냥 지나간다.\n   *\n   * 비어 있다는 것이 무슨 일을 뜻하는지는 **업무마다 다르다** — 부적합 처분은 상신이 막히고, 정비\n   * 완료 확인은 확인 없이 닫힌다. 그 결과는 각 업무의 guide 가 말할 자리다. 이 칸은 사실만 낸다.\n   */\n  @Field(type => Int, {\n    nullable: true,\n    description: 'How many approval steps this activity has in this domain. Steps, not people; references excluded.'\n  })\n  approvalSteps?: number\n\n  /**\n   * What the registering module says about how far along this type is.\n   *\n   * Declared, not computed — see ActivityReadiness. Missing means nobody has said, which the\n   * screen shows as 「선언 없음」 rather than as a zero.\n   */\n  @Field(type => ActivityReadiness, { nullable: true })\n  readiness?: ActivityReadiness\n\n  callback?: (content: any, addendum: UpdateActivityInstanceStateAddendum, context: ResolverContext) => void\n}\n"]}

package/dist-server/service/nulls-last.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Sorting a column where a missing value means "not yet", not "smallest".
+ *
+ * Where NULL lands is decided by the database: sqlite puts it first ascending, postgres last. Left
+ * alone, the same code orders one way in development and another in production. And on a due-date
+ * column the database's answer is wrong either way — a task with no deadline is not the most urgent
+ * one.
+ *
+ * ORDER BY ... NULLS LAST would say it directly, but it is postgres and oracle syntax; mysql and
+ * mssql raise a syntax error, and this framework has to run on five drivers. TypeORM's third
+ * orderBy argument is no help either — SelectQueryBuilder appends "ASC NULLS LAST" without checking
+ * the driver.
+ *
+ * CASE WHEN ... IS NULL THEN 1 ELSE 0 END is standard SQL and behaves the same on all five.
+ *
+ * The expression cannot go straight into orderBy: TypeORM reads everything up to the first dot as
+ * an alias, and the field reference inside contains one — `"CASE WHEN "at"" alias was not found`.
+ * So it is added to the select under a name, and the ordering is done by that name.
+ */
+/** The select name the rank is added under. No dots, so TypeORM passes it through untouched. */
+export declare const NULL_RANK_ALIAS = "nulls_last_rank";
+/**
+ * Rank rows so the ones with no value sort last.
+ *
+ * `field` is a fully quoted column reference, resolved by the caller from TypeORM metadata — this
+ * module never spells a column name itself. The rank is always ordered ascending, in either
+ * direction of the sort it accompanies: an empty deadline belongs at the bottom whichever way the
+ * dated rows are pointing.
+ */
+export declare function nullsLastSelect(field: string): string;

package/dist-server/service/nulls-last.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Sorting a column where a missing value means "not yet", not "smallest".
+ *
+ * Where NULL lands is decided by the database: sqlite puts it first ascending, postgres last. Left
+ * alone, the same code orders one way in development and another in production. And on a due-date
+ * column the database's answer is wrong either way — a task with no deadline is not the most urgent
+ * one.
+ *
+ * ORDER BY ... NULLS LAST would say it directly, but it is postgres and oracle syntax; mysql and
+ * mssql raise a syntax error, and this framework has to run on five drivers. TypeORM's third
+ * orderBy argument is no help either — SelectQueryBuilder appends "ASC NULLS LAST" without checking
+ * the driver.
+ *
+ * CASE WHEN ... IS NULL THEN 1 ELSE 0 END is standard SQL and behaves the same on all five.
+ *
+ * The expression cannot go straight into orderBy: TypeORM reads everything up to the first dot as
+ * an alias, and the field reference inside contains one — `"CASE WHEN "at"" alias was not found`.
+ * So it is added to the select under a name, and the ordering is done by that name.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NULL_RANK_ALIAS = void 0;
+exports.nullsLastSelect = nullsLastSelect;
+/** The select name the rank is added under. No dots, so TypeORM passes it through untouched. */
+exports.NULL_RANK_ALIAS = 'nulls_last_rank';
+/**
+ * Rank rows so the ones with no value sort last.
+ *
+ * `field` is a fully quoted column reference, resolved by the caller from TypeORM metadata — this
+ * module never spells a column name itself. The rank is always ordered ascending, in either
+ * direction of the sort it accompanies: an empty deadline belongs at the bottom whichever way the
+ * dated rows are pointing.
+ */
+function nullsLastSelect(field) {
+    return `CASE WHEN ${field} IS NULL THEN 1 ELSE 0 END`;
+}
+//# sourceMappingURL=nulls-last.js.map

package/dist-server/service/nulls-last.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nulls-last.js","sourceRoot":"","sources":["../../server/service/nulls-last.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAaH,0CAEC;AAbD,gGAAgG;AACnF,QAAA,eAAe,GAAG,iBAAiB,CAAA;AAEhD;;;;;;;GAOG;AACH,SAAgB,eAAe,CAAC,KAAa;IAC3C,OAAO,aAAa,KAAK,4BAA4B,CAAA;AACvD,CAAC","sourcesContent":["/**\n * Sorting a column where a missing value means \"not yet\", not \"smallest\".\n *\n * Where NULL lands is decided by the database: sqlite puts it first ascending, postgres last. Left\n * alone, the same code orders one way in development and another in production. And on a due-date\n * column the database's answer is wrong either way — a task with no deadline is not the most urgent\n * one.\n *\n * ORDER BY ... NULLS LAST would say it directly, but it is postgres and oracle syntax; mysql and\n * mssql raise a syntax error, and this framework has to run on five drivers. TypeORM's third\n * orderBy argument is no help either — SelectQueryBuilder appends \"ASC NULLS LAST\" without checking\n * the driver.\n *\n * CASE WHEN ... IS NULL THEN 1 ELSE 0 END is standard SQL and behaves the same on all five.\n *\n * The expression cannot go straight into orderBy: TypeORM reads everything up to the first dot as\n * an alias, and the field reference inside contains one — `\"CASE WHEN \"at\"\" alias was not found`.\n * So it is added to the select under a name, and the ordering is done by that name.\n */\n\n/** The select name the rank is added under. No dots, so TypeORM passes it through untouched. */\nexport const NULL_RANK_ALIAS = 'nulls_last_rank'\n\n/**\n * Rank rows so the ones with no value sort last.\n *\n * `field` is a fully quoted column reference, resolved by the caller from TypeORM metadata — this\n * module never spells a column name itself. The rank is always ordered ascending, in either\n * direction of the sort it accompanies: an empty deadline belongs at the bottom whichever way the\n * dated rows are pointing.\n */\nexport function nullsLastSelect(field: string): string {\n  return `CASE WHEN ${field} IS NULL THEN 1 ELSE 0 END`\n}\n"]}