react-semaphor 0.1.443 → 0.1.445

package/dist/chunks/temporal-bucket-contract-B2bJ1oe4.js

@@ -0,0 +1,108 @@
+import { t as i, T as l, d as u } from "./validators-wZ2WlNHc.js";
+function c(e) {
+  const r = i.safeParse(e);
+  return r.success ? { ok: !0, value: r.data } : {
+    ok: !1,
+    error: {
+      code: l.invalidMetadata,
+      message: "Temporal bucket metadata is invalid.",
+      path: "temporalBucket"
+    }
+  };
+}
+function s(e, r) {
+  if (!e.temporalBucket)
+    return r.metadataRequired ? {
+      ok: !1,
+      error: {
+        code: l.missingMetadata,
+        message: "Activated temporal bucket result is missing metadata.",
+        path: "temporalBucket"
+      }
+    } : { ok: !0 };
+  const t = c(
+    e.temporalBucket
+  );
+  if (!t.ok || !t.value)
+    return t;
+  const a = u(
+    t.value.granularity
+  );
+  return e.dataType !== a ? {
+    ok: !1,
+    error: {
+      code: l.invalidMetadata,
+      message: `${t.value.granularity} temporal buckets require dataType ${a}.`,
+      path: "dataType"
+    }
+  } : t;
+}
+function d(e, r) {
+  var t, a, o, n;
+  return e.granularity === r.granularity && e.calendar.tz === r.calendar.tz && e.calendar.weekStart === r.calendar.weekStart && ((t = e.calendar.fiscalCalendar) == null ? void 0 : t.kind) === ((a = r.calendar.fiscalCalendar) == null ? void 0 : a.kind) && ((o = e.calendar.fiscalCalendar) == null ? void 0 : o.yearStartMonth) === ((n = r.calendar.fiscalCalendar) == null ? void 0 : n.yearStartMonth);
+}
+function k(e, r) {
+  const t = /* @__PURE__ */ new Map();
+  for (const a of e) {
+    if (t.has(a.key))
+      return {
+        ok: !1,
+        error: {
+          code: l.invalidMetadata,
+          message: `Canonical result contains duplicate column key "${a.key}".`,
+          path: "columns"
+        }
+      };
+    if (t.set(a.key, a), a.temporalBucket) {
+      const o = s(a, {
+        metadataRequired: !1
+      });
+      if (!o.ok)
+        return {
+          ok: !1,
+          error: {
+            ...o.error,
+            path: `columns.${a.key}.${o.error.path || "temporalBucket"}`
+          }
+        };
+    }
+  }
+  for (const a of r) {
+    const o = t.get(a.key);
+    if (!o)
+      return {
+        ok: !1,
+        error: {
+          code: l.missingMetadata,
+          message: `Activated temporal bucket result is missing column "${a.key}".`,
+          path: `columns.${a.key}`
+        }
+      };
+    const n = s(o, {
+      metadataRequired: !0
+    });
+    if (!n.ok)
+      return {
+        ok: !1,
+        error: {
+          ...n.error,
+          path: `columns.${a.key}.${n.error.path || "temporalBucket"}`
+        }
+      };
+    if (!n.value || !d(n.value, a.metadata))
+      return {
+        ok: !1,
+        error: {
+          code: l.invalidMetadata,
+          message: `Temporal bucket metadata for column "${a.key}" contradicts the governed query context.`,
+          path: `columns.${a.key}.temporalBucket`
+        }
+      };
+  }
+  return { ok: !0, value: e };
+}
+export {
+  k as a,
+  s as b,
+  c as v
+};

package/dist/chunks/temporal-bucket-contract-ChDBWX8I.cjs

@@ -0,0 +1 @@
+"use strict";const n=require("./validators-9D4KBqKD.cjs");function s(e){const r=n.temporalBucketMetadataSchema.safeParse(e);return r.success?{ok:!0,value:r.data}:{ok:!1,error:{code:n.TEMPORAL_BUCKET_CONTRACT_ERROR_CODES.invalidMetadata,message:"Temporal bucket metadata is invalid.",path:"temporalBucket"}}}function u(e,r){if(!e.temporalBucket)return r.metadataRequired?{ok:!1,error:{code:n.TEMPORAL_BUCKET_CONTRACT_ERROR_CODES.missingMetadata,message:"Activated temporal bucket result is missing metadata.",path:"temporalBucket"}}:{ok:!0};const t=s(e.temporalBucket);if(!t.ok||!t.value)return t;const a=n.temporalBucketDataTypeForGrain(t.value.granularity);return e.dataType!==a?{ok:!1,error:{code:n.TEMPORAL_BUCKET_CONTRACT_ERROR_CODES.invalidMetadata,message:`${t.value.granularity} temporal buckets require dataType ${a}.`,path:"dataType"}}:t}function i(e,r){var t,a,o,l;return e.granularity===r.granularity&&e.calendar.tz===r.calendar.tz&&e.calendar.weekStart===r.calendar.weekStart&&((t=e.calendar.fiscalCalendar)==null?void 0:t.kind)===((a=r.calendar.fiscalCalendar)==null?void 0:a.kind)&&((o=e.calendar.fiscalCalendar)==null?void 0:o.yearStartMonth)===((l=r.calendar.fiscalCalendar)==null?void 0:l.yearStartMonth)}function c(e,r){const t=new Map;for(const a of e){if(t.has(a.key))return{ok:!1,error:{code:n.TEMPORAL_BUCKET_CONTRACT_ERROR_CODES.invalidMetadata,message:`Canonical result contains duplicate column key "${a.key}".`,path:"columns"}};if(t.set(a.key,a),a.temporalBucket){const o=u(a,{metadataRequired:!1});if(!o.ok)return{ok:!1,error:{...o.error,path:`columns.${a.key}.${o.error.path||"temporalBucket"}`}}}}for(const a of r){const o=t.get(a.key);if(!o)return{ok:!1,error:{code:n.TEMPORAL_BUCKET_CONTRACT_ERROR_CODES.missingMetadata,message:`Activated temporal bucket result is missing column "${a.key}".`,path:`columns.${a.key}`}};const l=u(o,{metadataRequired:!0});if(!l.ok)return{ok:!1,error:{...l.error,path:`columns.${a.key}.${l.error.path||"temporalBucket"}`}};if(!l.value||!i(l.value,a.metadata))return{ok:!1,error:{code:n.TEMPORAL_BUCKET_CONTRACT_ERROR_CODES.invalidMetadata,message:`Temporal bucket metadata for column "${a.key}" contradicts the governed query context.`,path:`columns.${a.key}.temporalBucket`}}}return{ok:!0,value:e}}exports.validateActivatedTemporalBucketResultColumns=c;exports.validateTemporalBucketMetadata=s;exports.validateTemporalBucketResultColumn=u;

package/dist/chunks/temporal-bucket-pMnV-4Nj.cjs

@@ -0,0 +1 @@
+"use strict";var q=Object.defineProperty;var F=(e,t,r)=>t in e?q(e,t,{enumerable:!0,configurable:!0,writable:!0,value:r}):e[t]=r;var b=(e,t,r)=>F(e,typeof t!="symbol"?t+"":t,r);const w=require("../value-format-preferences/index.cjs"),Y=["YYYY","MMMM","MMM","YY","MM","DD","HH","mm","ss"],O=new Set([" ","-","/",":",".",",","T"]),A={week_of_short:"week",week_of_long:"week",quarter_short:"quarter",quarter_long:"quarter",fiscal_quarter_short:"quarter",fiscal_year:"year"};function E(e){return typeof e=="string"&&Object.prototype.hasOwnProperty.call(A,e)}function N(e,t){return Y.find(r=>e.startsWith(r,t))}function p(e){var a;if(!e||e.trim()!==e)return{ok:!1,code:"invalid_temporal_bucket_pattern",message:"Temporal bucket patterns must be non-empty and trimmed."};const t=[];let r=0,n=!1;for(;r<e.length;){const o=N(e,r);if(o){if(n)return{ok:!1,code:"invalid_temporal_bucket_pattern",message:"Adjacent temporal bucket tokens require a separator."};t.push({kind:"token",value:o}),r+=o.length,n=!0;continue}const u=e[r];if(!O.has(u))return{ok:!1,code:"invalid_temporal_bucket_pattern",message:`Unsupported temporal bucket pattern character "${u}".`};if(t.length===0)return{ok:!1,code:"invalid_temporal_bucket_pattern",message:"Temporal bucket patterns cannot begin with a separator."};const s=t[t.length-1];s.kind==="literal"?s.value+=u:t.push({kind:"literal",value:u}),r+=1,n=!1}return((a=t[t.length-1])==null?void 0:a.kind)!=="token"?{ok:!1,code:"invalid_temporal_bucket_pattern",message:"Temporal bucket patterns cannot end with a separator."}:{ok:!0,segments:t}}function H(e){return e.flatMap(t=>t.kind==="token"?[t.value]:[])}function g(e,t){return e.filter(r=>t.includes(r)).length===1}function m(e,t){return e.some(r=>t.includes(r))}function R(e){return new Set(e).size!==e.length}function C(e,t){if(R(e))return!1;const r=["YYYY","YY"],n=["MMMM","MMM","MM"],a=["HH","mm","ss"],o=g(e,r),u=g(e,n),s=e.includes("DD"),d=m(e,a);switch(t){case"second":return e.includes("HH")&&e.includes("mm")&&e.includes("ss")&&(!m(e,[...r,...n,"DD"])||o&&u&&s);case"minute":return e.includes("HH")&&e.includes("mm")&&(!m(e,[...r,...n,"DD"])||o&&u&&s);case"hour":return e.includes("HH")&&(!m(e,[...r,...n,"DD"])||o&&u&&s);case"day":case"week":return o&&u&&s&&!d;case"month":return o&&u&&!s&&!d;case"quarter":return!1;case"year":return o&&!u&&!s&&!d}}function y(e,t){if(e.presentation.mode==="auto")return{ok:!0};if(e.presentation.mode==="preset"){const n=A[e.presentation.preset];return n===t?{ok:!0}:{ok:!1,code:"incompatible_temporal_bucket_preset",message:`Preset ${e.presentation.preset} requires ${n} granularity.`}}const r=p(e.presentation.pattern);return r.ok?C(H(r.segments),t)?{ok:!0,segments:r.segments}:{ok:!1,code:"incompatible_temporal_bucket_pattern",message:`Pattern ${e.presentation.pattern} is not compatible with ${t} granularity.`}:r}function x(e,t){if(!(!e||!t))return y(e,t).ok?e:void 0}class i extends Error{constructor(r,n){super(n);b(this,"code");this.name="TemporalBucketContractError",this.code=r}}const j={type:"temporal_bucket",presentation:{mode:"auto"}},P=["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"],U=["January","February","March","April","May","June","July","August","September","October","November","December"];function h(e){return{ok:!1,error:{code:"invalid_temporal_bucket_value",message:e}}}function z(e){return e%4===0&&(e%100!==0||e%400===0)}function L(e,t){return t===2?z(e)?29:28:[4,6,9,11].includes(t)?30:31}function J(e,t,r){const n=[0,3,2,5,0,3,5,1,4,6,2,4],a=t<3?e-1:e;return(a+Math.floor(a/4)-Math.floor(a/100)+Math.floor(a/400)+n[t-1]+r)%7}function _(e){var t;return(t=e.calendar.fiscalCalendar)==null?void 0:t.yearStartMonth}function K(e,t){return(e-t+12)%12%3===0}function I(e,t){const{granularity:r}=t,n=_(t)??1;switch(r){case"second":return!0;case"minute":return e.second===0;case"hour":return e.minute===0&&e.second===0;case"day":return!0;case"week":return J(e.year,e.month,e.day)===t.calendar.weekStart;case"month":return e.day===1;case"quarter":return e.day===1&&K(e.month,n);case"year":return e.day===1&&e.month===n}}function S(e,t){if(e===null)return{ok:!0,value:null};const r=t.granularity==="second"||t.granularity==="minute"||t.granularity==="hour",n=r?/^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})$/.exec(e):/^(\d{4})-(\d{2})-(\d{2})$/.exec(e);if(!n)return h(`Expected ${r?"YYYY-MM-DDTHH:mm:ss":"YYYY-MM-DD"} for ${t.granularity} granularity.`);const a={year:Number(n[1]),month:Number(n[2]),day:Number(n[3]),hour:r?Number(n[4]):0,minute:r?Number(n[5]):0,second:r?Number(n[6]):0};return a.year<1||a.month<1||a.month>12||a.day<1||a.day>L(a.year,a.month)||a.hour>23||a.minute>59||a.second>59?h(`Invalid canonical ${t.granularity} bucket value ${e}.`):I(a,t)?{ok:!0,value:a}:h(`Canonical value ${e} is not aligned to ${t.granularity} granularity and its governed Calendar.`)}function T(e){if(e===null||typeof e!="object"||Array.isArray(e))return!1;const t=Object.getPrototypeOf(e);return t===null||t===Object.prototype}function B(e){if(!T(e))return{ok:!1,issues:[{path:"$",message:"Resolved temporal bucket format must be an object."}]};const t=[],r=new Set(["type","presentation","locale"]);for(const o of Object.keys(e))r.has(o)||t.push({path:o,message:`Unknown property "${o}".`});e.type!=="temporal_bucket"&&t.push({path:"type",message:"Expected temporal_bucket."});const n=e.presentation;if(!T(n))t.push({path:"presentation",message:"Expected a presentation object."});else{const o=n.mode,u=o==="preset"?new Set(["mode","preset"]):o==="pattern"?new Set(["mode","pattern"]):new Set(["mode"]);for(const s of Object.keys(n))u.has(s)||t.push({path:`presentation.${s}`,message:`Unknown property "${s}".`});if(o==="preset")E(n.preset)||t.push({path:"presentation.preset",message:"Expected a supported preset."});else if(o==="pattern")if(typeof n.pattern!="string"||!n.pattern)t.push({path:"presentation.pattern",message:"Expected a non-empty pattern."});else{const s=p(n.pattern);s.ok||t.push({path:"presentation.pattern",message:s.message})}else o!=="auto"&&t.push({path:"presentation.mode",message:"Expected auto, preset, or pattern."})}const a=w.canonicalizeSupportedLocale(e.locale);return a||t.push({path:"locale",message:"Expected a supported base BCP 47 locale."}),t.length>0||!a?{ok:!1,issues:t}:{ok:!0,value:{type:"temporal_bucket",presentation:n,locale:a}}}function G(e,t){const r=!!t.calendar.fiscalCalendar;return e==="fiscal_quarter_short"||e==="fiscal_year"?r:e==="quarter_short"||e==="quarter_long"?!r:!0}function D(e,t){return y(e,t.granularity).ok?e.presentation.mode==="preset"?G(e.presentation.preset,t):!(e.presentation.mode==="pattern"&&t.calendar.fiscalCalendar&&(t.granularity==="quarter"||t.granularity==="year")):!1}function M(e,t){if(!(!e||e.presentation.mode==="auto"))return D(e,t)?e:void 0}function Q(e){var a;const t=w.canonicalizeSupportedLocale(e.locale);if(!t)throw new i("invalid_temporal_bucket_format","Temporal bucket locale must be a supported base BCP 47 locale.");const r=M(e.cardFormat,e.metadata);if(r)return{format:{...r,locale:t},source:"card"};const n=((a=e.semanticFormat)==null?void 0:a.granularity)===e.metadata.granularity?M(e.semanticFormat.format,e.metadata):void 0;return n?{format:{...n,locale:t},source:"semantic"}:{format:{...j,locale:t},source:"automatic"}}function c(e,t=2){return String(e).padStart(t,"0")}function l(e,t,r){if(t==="en-US")return(r==="short"?P:U)[e-1];const n=new Date(Date.UTC(2e3,e-1,15));return new Intl.DateTimeFormat(t,{month:r,timeZone:"UTC"}).format(n)}function V(e,t,r){return t.map(n=>{if(n.kind==="literal")return n.value;switch(n.value){case"YYYY":return c(e.year,4);case"YY":return c(e.year%100);case"MMMM":return l(e.month,r,"long");case"MMM":return l(e.month,r,"short");case"MM":return c(e.month);case"DD":return c(e.day);case"HH":return c(e.hour);case"mm":return c(e.minute);case"ss":return c(e.second)}}).join("")}function $(e,t){return`${e.hour%12||12}:${c(e.minute)}${t?`:${c(e.second)}`:""} ${e.hour<12?"AM":"PM"}`}function k(e){return`${P[e.month-1]} ${e.day}, ${e.year}`}function W(e,t){return Math.floor((e.month-t+12)%12/3)+1}function v(e,t){return t===1||e.month<t?e.year:e.year+1}function Z(e){return e===1?"1st":e===2?"2nd":e===3?"3rd":`${e}th`}function f(e,t,r,n){const a=_(n)??1,o=W(e,a);switch(t){case"week_of_short":return`Week of ${l(e.month,r,"short")} ${e.day}, ${e.year}`;case"week_of_long":return`Week of ${l(e.month,r,"long")} ${e.day}, ${e.year}`;case"quarter_short":return`Q${o} ${e.year}`;case"quarter_long":return`${Z(o)} Quarter ${e.year}`;case"fiscal_quarter_short":return`Q${o} FY${v(e,a)}`;case"fiscal_year":return`FY${v(e,a)}`}}function X(e,t,r){const n=_(t);switch(t.granularity){case"second":return`${k(e)}, ${$(e,!0)}`;case"minute":case"hour":return`${k(e)}, ${$(e,!1)}`;case"day":return k(e);case"week":return f(e,"week_of_short",r,t);case"month":return`${l(e.month,r,"short")} ${e.year}`;case"quarter":return f(e,n?"fiscal_quarter_short":"quarter_short",r,t);case"year":return n?f(e,"fiscal_year",r,t):String(e.year)}}function ee(e){const t=B(e.format);if(!t.ok||!D(t.value,e.metadata))throw new i("invalid_temporal_bucket_format","Resolved temporal bucket format is invalid or inapplicable to its metadata.");const r=S(e.value,e.metadata);if(!r.ok)throw new i(r.error.code,r.error.message);if(r.value===null)return"(Blank)";const{presentation:n,locale:a}=t.value;if(n.mode==="auto")return X(r.value,e.metadata,a);if(n.mode==="preset")return f(r.value,n.preset,a,e.metadata);const o=p(n.pattern);if(!o.ok)throw new i("invalid_temporal_bucket_format",o.message);return V(r.value,o.segments,a)}exports.TEMPORAL_BUCKET_PATTERN_TOKENS=Y;exports.TemporalBucketContractError=i;exports.formatTemporalBucket=ee;exports.isTemporalBucketPreset=E;exports.parseResolvedTemporalBucketFormat=B;exports.parseTemporalBucketValue=S;exports.resolveApplicableTemporalBucketFormat=x;exports.resolveTemporalBucketPresentation=Q;exports.tokenizeTemporalBucketPattern=p;exports.validateTemporalBucketFormatApplicability=y;