@things-factory/shell 10.1.188 → 10.1.205

package/dist-server/utils/calendar-day.d.ts

@@ -0,0 +1,12 @@
+/**
+ * **The calendar day in a timezone** - the one "today" of every module that keeps days (ADR-0120 decision 8).
+ *
+ * It lives here because the zone it reads is the domain's (`Domain.timezone`, `service/domain/domain.ts`): a site's day
+ * is a fact of the site, not of the module asking. It moved from `@things-factory/invoice` on 2026-10-20 when the
+ * warehouse needed a site's day for expiry (ADR-0076 ruling) - one function, one home, no second name.
+ *
+ * There is no default zone: a domain that names none would have its days moved silently in another country. The
+ * caller passes the zone its rule reads (a bank account's before its domain's); without one the person is told to set
+ * the domain's timezone.
+ */
+export declare function calendarDay(timezone: string | null | undefined, now?: Date | number): string;

package/dist-server/utils/calendar-day.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calendarDay = calendarDay;
+const refusal_js_1 = require("../refusal/refusal.js");
+/**
+ * **The calendar day in a timezone** - the one "today" of every module that keeps days (ADR-0120 decision 8).
+ *
+ * It lives here because the zone it reads is the domain's (`Domain.timezone`, `service/domain/domain.ts`): a site's day
+ * is a fact of the site, not of the module asking. It moved from `@things-factory/invoice` on 2026-10-20 when the
+ * warehouse needed a site's day for expiry (ADR-0076 ruling) - one function, one home, no second name.
+ *
+ * There is no default zone: a domain that names none would have its days moved silently in another country. The
+ * caller passes the zone its rule reads (a bank account's before its domain's); without one the person is told to set
+ * the domain's timezone.
+ */
+function calendarDay(timezone, now = new Date()) {
+    if (!timezone)
+        throw new refusal_js_1.Refusal('timezone-required', {}, "Set the domain's timezone in domain management");
+    return new Intl.DateTimeFormat('en-CA', { timeZone: timezone, year: 'numeric', month: '2-digit', day: '2-digit' }).format(now);
+}
+//# sourceMappingURL=calendar-day.js.map

package/dist-server/utils/calendar-day.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-day.js","sourceRoot":"","sources":["../../server/utils/calendar-day.ts"],"names":[],"mappings":";;AAaA,kCAGC;AAhBD,sDAA+C;AAE/C;;;;;;;;;;GAUG;AACH,SAAgB,WAAW,CAAC,QAAmC,EAAE,MAAqB,IAAI,IAAI,EAAE;IAC9F,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,oBAAO,CAAC,mBAAmB,EAAE,EAAE,EAAE,gDAAgD,CAAC,CAAA;IAC3G,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;AAChI,CAAC","sourcesContent":["import { Refusal } from '../refusal/refusal.js'\n\n/**\n * **The calendar day in a timezone** - the one \"today\" of every module that keeps days (ADR-0120 decision 8).\n *\n * It lives here because the zone it reads is the domain's (`Domain.timezone`, `service/domain/domain.ts`): a site's day\n * is a fact of the site, not of the module asking. It moved from `@things-factory/invoice` on 2026-10-20 when the\n * warehouse needed a site's day for expiry (ADR-0076 ruling) - one function, one home, no second name.\n *\n * There is no default zone: a domain that names none would have its days moved silently in another country. The\n * caller passes the zone its rule reads (a bank account's before its domain's); without one the person is told to set\n * the domain's timezone.\n */\nexport function calendarDay(timezone: string | null | undefined, now: Date | number = new Date()): string {\n  if (!timezone) throw new Refusal('timezone-required', {}, \"Set the domain's timezone in domain management\")\n  return new Intl.DateTimeFormat('en-CA', { timeZone: timezone, year: 'numeric', month: '2-digit', day: '2-digit' }).format(now)\n}\n"]}

package/dist-server/utils/index.d.ts

@@ -13,3 +13,4 @@ export * from './subscribe-auth.js';
 export * from './after-commit.js';
 export * from './domain-ancestry.js';
 export * from './secret-hint.js';
+export * from './calendar-day.js';

package/dist-server/utils/index.js

@@ -16,4 +16,5 @@ tslib_1.__exportStar(require("./subscribe-auth.js"), exports);
 tslib_1.__exportStar(require("./after-commit.js"), exports);
 tslib_1.__exportStar(require("./domain-ancestry.js"), exports);
 tslib_1.__exportStar(require("./secret-hint.js"), exports);
+tslib_1.__exportStar(require("./calendar-day.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist-server/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/utils/index.ts"],"names":[],"mappings":";;;AAAA,0DAA+B;AAC/B,mEAAwC;AACxC,iEAAsC;AACtC,kEAAuC;AACvC,qEAA0C;AAC1C,gEAAqC;AACrC,kFAAuD;AACvD,6DAAkC;AAClC,mEAAwC;AACxC,oEAAyC;AACzC,mEAAwC;AACxC,8DAAmC;AACnC,4DAAiC;AACjC,+DAAoC;AACpC,2DAAgC","sourcesContent":["export * from './get-domain.js'\nexport * from './apply-domain-filter.js'\nexport * from './condition-builder.js'\nexport * from './list-query-builder.js'\nexport * from './list-params-converter.js'\nexport * from './publish-progress.js'\nexport * from './get-query-builder-from-list-params.js'\nexport * from './keyset-cursor.js'\nexport * from './list-param-adjuster.js'\nexport * from './get-times-for-period.js'\nexport * from './headless-pool/index.js'\nexport * from './subscribe-auth.js'\nexport * from './after-commit.js'\nexport * from './domain-ancestry.js'\nexport * from './secret-hint.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/utils/index.ts"],"names":[],"mappings":";;;AAAA,0DAA+B;AAC/B,mEAAwC;AACxC,iEAAsC;AACtC,kEAAuC;AACvC,qEAA0C;AAC1C,gEAAqC;AACrC,kFAAuD;AACvD,6DAAkC;AAClC,mEAAwC;AACxC,oEAAyC;AACzC,mEAAwC;AACxC,8DAAmC;AACnC,4DAAiC;AACjC,+DAAoC;AACpC,2DAAgC;AAChC,4DAAiC","sourcesContent":["export * from './get-domain.js'\nexport * from './apply-domain-filter.js'\nexport * from './condition-builder.js'\nexport * from './list-query-builder.js'\nexport * from './list-params-converter.js'\nexport * from './publish-progress.js'\nexport * from './get-query-builder-from-list-params.js'\nexport * from './keyset-cursor.js'\nexport * from './list-param-adjuster.js'\nexport * from './get-times-for-period.js'\nexport * from './headless-pool/index.js'\nexport * from './subscribe-auth.js'\nexport * from './after-commit.js'\nexport * from './domain-ancestry.js'\nexport * from './secret-hint.js'\nexport * from './calendar-day.js'\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/shell",
-  "version": "10.1.188",
+  "version": "10.1.205",
   "description": "Core module for framework",
   "bin": {
     "things-factory": "bin/things-factory",
@@ -142,5 +142,5 @@
     "pg": "^8.7.3",
     "sqlite3": "^5.0.8"
   },
-  "gitHead": "c5e75e2e0b565e0666472bc835f5f1538fb18f48"
+  "gitHead": "7311492aa5eaa00993c0325053f5f7ae8b1fb024"
 }

package/tests/calendar-day.test.ts

@@ -0,0 +1,21 @@
+import { calendarDay } from '../server/utils/calendar-day'
+
+/**
+ * A site's day (ADR-0120 decision 8). One instant is a different day in different zones, and a domain without a zone
+ * is told to set one - never moved to the server's day. Moved from `@things-factory/invoice` with the function.
+ */
+describe('calendarDay', () => {
+  const at = new Date('2026-12-31T20:00:00Z')
+
+  it('is the day in the zone it is given, not the server clock\'s', () => {
+    expect(calendarDay('Asia/Seoul', at)).toBe('2027-01-01')
+    expect(calendarDay('UTC', at)).toBe('2026-12-31')
+    expect(calendarDay('America/Los_Angeles', at.getTime())).toBe('2026-12-31')
+  })
+
+  it('refuses a missing zone by name instead of falling back to one', () => {
+    for (const none of ['', undefined, null]) {
+      expect(() => calendarDay(none as any, at)).toThrow(expect.objectContaining({ code: 'timezone-required' }))
+    }
+  })
+})

package/translations/en.json

@@ -185,5 +185,6 @@
   "button.resume-editing": "resume editing",
   "button.discard": "discard",
   "figure.label.motion": "Motion",
-  "figure.text.preview-needs-a-part": "add a part to see how it looks placed on a drawing."
+  "figure.text.preview-needs-a-part": "add a part to see how it looks placed on a drawing.",
+  "error.timezone-required": "The $t(term.domain) has no timezone. Set it in $t(term.domain) management."
 }

package/translations/es.json

@@ -185,5 +185,6 @@
   "button.resume-editing": "reanudar edición",
   "button.discard": "descartar",
   "figure.label.motion": "Movimiento",
-  "figure.text.preview-needs-a-part": "añada una pieza para ver cómo se ve colocada en un plano."
+  "figure.text.preview-needs-a-part": "añada una pieza para ver cómo se ve colocada en un plano.",
+  "error.timezone-required": "El dominio no tiene zona horaria. Configúrela en la gestión de dominios."
 }

package/translations/ja.json

@@ -185,5 +185,6 @@
   "button.resume-editing": "編集を続ける",
   "button.discard": "破棄",
   "figure.label.motion": "Motion",
-  "figure.text.preview-needs-a-part": "部品を追加すると、図面に置いたときの姿が表示されます。"
+  "figure.text.preview-needs-a-part": "部品を追加すると、図面に置いたときの姿が表示されます。",
+  "error.timezone-required": "事業所のタイムゾーンが設定されていません。事業所管理でタイムゾーンを設定してください。"
 }

package/translations/ko.json

@@ -185,5 +185,6 @@
   "button.resume-editing": "이어서 편집",
   "button.discard": "버리기",
   "figure.label.motion": "움직임",
-  "figure.text.preview-needs-a-part": "부품을 추가하면 도면에 놓았을 때의 모습이 표시됩니다."
+  "figure.text.preview-needs-a-part": "부품을 추가하면 도면에 놓았을 때의 모습이 표시됩니다.",
+  "error.timezone-required": "$t(term.domain) 시간대가 정해지지 않았습니다. $t(term.domain) 관리에서 시간대를 정하세요."
 }

package/translations/ms.json

@@ -185,5 +185,6 @@
   "button.resume-editing": "sambung menyunting",
   "button.discard": "buang",
   "figure.label.motion": "Motion",
-  "figure.text.preview-needs-a-part": "tambah bahagian untuk melihat rupanya apabila diletakkan pada lukisan."
+  "figure.text.preview-needs-a-part": "tambah bahagian untuk melihat rupanya apabila diletakkan pada lukisan.",
+  "error.timezone-required": "Domain tiada zon waktu. Tetapkannya dalam pengurusan domain."
 }

package/translations/zh.json

@@ -185,5 +185,6 @@
   "button.resume-editing": "继续编辑",
   "button.discard": "放弃",
   "figure.label.motion": "Motion",
-  "figure.text.preview-needs-a-part": "添加部件后会显示放置到图面上的效果。"
+  "figure.text.preview-needs-a-part": "添加部件后会显示放置到图面上的效果。",
+  "error.timezone-required": "尚未设置单位时区。请在单位管理中设置时区。"
 }