@qpqjs/core 0.6.3 → 0.7.0

package/lib/commonjs/actions/ai/getAiUsageAmountMicroUsd.d.ts

@@ -0,0 +1,9 @@
+import { AiStreamUsage } from './types/AiStreamUsage';
+import { AiTokenRates } from './types/AiTokenRates';
+import { AiCacheTtl } from './AiCacheTtl';
+/**
+ * What a call's tokens come to at `rates`, in millionths of a US dollar, rounded to a whole number
+ * so totals add up exactly. Cache writes are priced at the five minute rate only when every write
+ * lived for five minutes (`cacheTtl` FiveMinutes); otherwise at the hour rate, the dearer one.
+ */
+export declare const getAiUsageAmountMicroUsd: (usage: AiStreamUsage, rates: AiTokenRates, cacheTtl?: AiCacheTtl) => number;

package/lib/commonjs/actions/ai/getAiUsageAmountMicroUsd.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAiUsageAmountMicroUsd = void 0;
+const AiCacheTtl_1 = require("./AiCacheTtl");
+/**
+ * What a call's tokens come to at `rates`, in millionths of a US dollar, rounded to a whole number
+ * so totals add up exactly. Cache writes are priced at the five minute rate only when every write
+ * lived for five minutes (`cacheTtl` FiveMinutes); otherwise at the hour rate, the dearer one.
+ */
+const getAiUsageAmountMicroUsd = (usage, rates, cacheTtl) => {
+    var _a, _b, _c, _d, _e, _f;
+    const cacheReadTokens = (_a = usage.cacheReadInputTokens) !== null && _a !== void 0 ? _a : 0;
+    const cacheWriteTokens = (_b = usage.cacheWriteInputTokens) !== null && _b !== void 0 ? _b : 0;
+    // `inputTokens` is the total of the three input kinds, so only the uncached part is priced as input.
+    const noCacheTokens = (_c = usage.noCacheInputTokens) !== null && _c !== void 0 ? _c : Math.max(0, ((_d = usage.inputTokens) !== null && _d !== void 0 ? _d : 0) - cacheReadTokens - cacheWriteTokens);
+    const cacheWriteRate = cacheTtl === AiCacheTtl_1.AiCacheTtl.FiveMinutes ? rates.cacheWriteFiveMinutes : ((_e = rates.cacheWriteOneHour) !== null && _e !== void 0 ? _e : rates.cacheWriteFiveMinutes);
+    // A rate per million tokens times a token count is already millionths of a dollar.
+    return Math.round(noCacheTokens * rates.input + cacheReadTokens * rates.cacheRead + cacheWriteTokens * cacheWriteRate + ((_f = usage.outputTokens) !== null && _f !== void 0 ? _f : 0) * rates.output);
+};
+exports.getAiUsageAmountMicroUsd = getAiUsageAmountMicroUsd;
+//# sourceMappingURL=getAiUsageAmountMicroUsd.js.map

package/lib/commonjs/actions/ai/getAiUsageAmountMicroUsd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAiUsageAmountMicroUsd.js","sourceRoot":"","sources":["../../../../src/actions/ai/getAiUsageAmountMicroUsd.ts"],"names":[],"mappings":";;;AAEA,6CAA0C;AAE1C;;;;GAIG;AACI,MAAM,wBAAwB,GAAG,CAAC,KAAoB,EAAE,KAAmB,EAAE,QAAqB,EAAU,EAAE;;IACnH,MAAM,eAAe,GAAG,MAAA,KAAK,CAAC,oBAAoB,mCAAI,CAAC,CAAC;IACxD,MAAM,gBAAgB,GAAG,MAAA,KAAK,CAAC,qBAAqB,mCAAI,CAAC,CAAC;IAE1D,qGAAqG;IACrG,MAAM,aAAa,GAAG,MAAA,KAAK,CAAC,kBAAkB,mCAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,MAAA,KAAK,CAAC,WAAW,mCAAI,CAAC,CAAC,GAAG,eAAe,GAAG,gBAAgB,CAAC,CAAC;IAE7H,MAAM,cAAc,GAAG,QAAQ,KAAK,uBAAU,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,MAAA,KAAK,CAAC,iBAAiB,mCAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAEpJ,mFAAmF;IACnF,OAAO,IAAI,CAAC,KAAK,CACf,aAAa,GAAG,KAAK,CAAC,KAAK,GAAG,eAAe,GAAG,KAAK,CAAC,SAAS,GAAG,gBAAgB,GAAG,cAAc,GAAG,CAAC,MAAA,KAAK,CAAC,YAAY,mCAAI,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAC/I,CAAC;AACJ,CAAC,CAAC;AAbW,QAAA,wBAAwB,4BAanC","sourcesContent":["import { AiStreamUsage } from './types/AiStreamUsage';\nimport { AiTokenRates } from './types/AiTokenRates';\nimport { AiCacheTtl } from './AiCacheTtl';\n\n/**\n * What a call's tokens come to at `rates`, in millionths of a US dollar, rounded to a whole number\n * so totals add up exactly. Cache writes are priced at the five minute rate only when every write\n * lived for five minutes (`cacheTtl` FiveMinutes); otherwise at the hour rate, the dearer one.\n */\nexport const getAiUsageAmountMicroUsd = (usage: AiStreamUsage, rates: AiTokenRates, cacheTtl?: AiCacheTtl): number => {\n  const cacheReadTokens = usage.cacheReadInputTokens ?? 0;\n  const cacheWriteTokens = usage.cacheWriteInputTokens ?? 0;\n\n  // `inputTokens` is the total of the three input kinds, so only the uncached part is priced as input.\n  const noCacheTokens = usage.noCacheInputTokens ?? Math.max(0, (usage.inputTokens ?? 0) - cacheReadTokens - cacheWriteTokens);\n\n  const cacheWriteRate = cacheTtl === AiCacheTtl.FiveMinutes ? rates.cacheWriteFiveMinutes : (rates.cacheWriteOneHour ?? rates.cacheWriteFiveMinutes);\n\n  // A rate per million tokens times a token count is already millionths of a dollar.\n  return Math.round(\n    noCacheTokens * rates.input + cacheReadTokens * rates.cacheRead + cacheWriteTokens * cacheWriteRate + (usage.outputTokens ?? 0) * rates.output,\n  );\n};\n"]}

package/lib/commonjs/actions/ai/index.d.ts

@@ -10,5 +10,6 @@ export * from './AiReasoningEffort';
 export * from './askAiGetModelRegions';
 export * from './askAiPrompt';
 export * from './askAiPromptStream';
+export * from './getAiUsageAmountMicroUsd';
 export * from './sumAiStreamUsage';
 export * from './types';

package/lib/commonjs/actions/ai/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./AiReasoningEffort"), exports);
 __exportStar(require("./askAiGetModelRegions"), exports);
 __exportStar(require("./askAiPrompt"), exports);
 __exportStar(require("./askAiPromptStream"), exports);
+__exportStar(require("./getAiUsageAmountMicroUsd"), exports);
 __exportStar(require("./sumAiStreamUsage"), exports);
 __exportStar(require("./types"), exports);
 //# sourceMappingURL=index.js.map

package/lib/commonjs/actions/ai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/ai/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,+CAA6B;AAC7B,iDAA+B;AAC/B,iDAA+B;AAC/B,8CAA4B;AAC5B,4CAA0B;AAC1B,qDAAmC;AACnC,sDAAoC;AACpC,sDAAoC;AACpC,yDAAuC;AACvC,gDAA8B;AAC9B,sDAAoC;AACpC,qDAAmC;AACnC,0CAAwB","sourcesContent":["export * from './AiActionType';\nexport * from './AiCacheTtl';\nexport * from './AiDataRegion';\nexport * from './AiJsonSchema';\nexport * from './AiMessage';\nexport * from './AiModel';\nexport * from './AiModelRegionMap';\nexport * from './AiReasoningConfig';\nexport * from './AiReasoningEffort';\nexport * from './askAiGetModelRegions';\nexport * from './askAiPrompt';\nexport * from './askAiPromptStream';\nexport * from './sumAiStreamUsage';\nexport * from './types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/ai/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,+CAA6B;AAC7B,iDAA+B;AAC/B,iDAA+B;AAC/B,8CAA4B;AAC5B,4CAA0B;AAC1B,qDAAmC;AACnC,sDAAoC;AACpC,sDAAoC;AACpC,yDAAuC;AACvC,gDAA8B;AAC9B,sDAAoC;AACpC,6DAA2C;AAC3C,qDAAmC;AACnC,0CAAwB","sourcesContent":["export * from './AiActionType';\nexport * from './AiCacheTtl';\nexport * from './AiDataRegion';\nexport * from './AiJsonSchema';\nexport * from './AiMessage';\nexport * from './AiModel';\nexport * from './AiModelRegionMap';\nexport * from './AiReasoningConfig';\nexport * from './AiReasoningEffort';\nexport * from './askAiGetModelRegions';\nexport * from './askAiPrompt';\nexport * from './askAiPromptStream';\nexport * from './getAiUsageAmountMicroUsd';\nexport * from './sumAiStreamUsage';\nexport * from './types';\n"]}

package/lib/commonjs/actions/ai/sumAiStreamUsage.d.ts

@@ -1,6 +1,6 @@
 import { AiStreamUsage } from './types/AiStreamUsage';
 /**
- * Adds token usages together field by field, for a chat's cost or a turn that spanned several
+ * Adds token usages (and their costs and charges) together field by field, for a chat's cost or a turn that spanned several
  * executions. A field no usage reported stays undefined rather than becoming zero.
  */
 export declare const sumAiStreamUsage: (usages: readonly AiStreamUsage[]) => AiStreamUsage;

package/lib/commonjs/actions/ai/sumAiStreamUsage.js

@@ -1,9 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.sumAiStreamUsage = void 0;
-const USAGE_FIELDS = ['inputTokens', 'outputTokens', 'totalTokens', 'cacheReadInputTokens', 'cacheWriteInputTokens', 'noCacheInputTokens'];
+const USAGE_FIELDS = [
+    'inputTokens',
+    'outputTokens',
+    'totalTokens',
+    'cacheReadInputTokens',
+    'cacheWriteInputTokens',
+    'noCacheInputTokens',
+    'costMicroUsd',
+    'chargeMicroUsd',
+];
 /**
- * Adds token usages together field by field, for a chat's cost or a turn that spanned several
+ * Adds token usages (and their costs and charges) together field by field, for a chat's cost or a turn that spanned several
  * executions. A field no usage reported stays undefined rather than becoming zero.
  */
 const sumAiStreamUsage = (usages) => USAGE_FIELDS.reduce((sum, field) => {

package/lib/commonjs/actions/ai/sumAiStreamUsage.js.map

@@ -1 +1 @@
-{"version":3,"file":"sumAiStreamUsage.js","sourceRoot":"","sources":["../../../../src/actions/ai/sumAiStreamUsage.ts"],"names":[],"mappings":";;;AAEA,MAAM,YAAY,GAAG,CAAC,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,oBAAoB,CAAU,CAAC;AAEpJ;;;GAGG;AACI,MAAM,gBAAgB,GAAG,CAAC,MAAgC,EAAiB,EAAE,CAClF,YAAY,CAAC,MAAM,CAAgB,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;IAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IAE7G,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,iCAAM,GAAG,KAAE,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC,IAAG,CAAC,CAAC,GAAG,CAAC;AAC9G,CAAC,EAAE,EAAE,CAAC,CAAC;AALI,QAAA,gBAAgB,oBAKpB","sourcesContent":["import { AiStreamUsage } from './types/AiStreamUsage';\n\nconst USAGE_FIELDS = ['inputTokens', 'outputTokens', 'totalTokens', 'cacheReadInputTokens', 'cacheWriteInputTokens', 'noCacheInputTokens'] as const;\n\n/**\n * Adds token usages together field by field, for a chat's cost or a turn that spanned several\n * executions. A field no usage reported stays undefined rather than becoming zero.\n */\nexport const sumAiStreamUsage = (usages: readonly AiStreamUsage[]): AiStreamUsage =>\n  USAGE_FIELDS.reduce<AiStreamUsage>((sum, field) => {\n    const reported = usages.map((usage) => usage[field]).filter((value): value is number => value !== undefined);\n\n    return reported.length > 0 ? { ...sum, [field]: reported.reduce((total, value) => total + value, 0) } : sum;\n  }, {});\n"]}
+{"version":3,"file":"sumAiStreamUsage.js","sourceRoot":"","sources":["../../../../src/actions/ai/sumAiStreamUsage.ts"],"names":[],"mappings":";;;AAEA,MAAM,YAAY,GAAG;IACnB,aAAa;IACb,cAAc;IACd,aAAa;IACb,sBAAsB;IACtB,uBAAuB;IACvB,oBAAoB;IACpB,cAAc;IACd,gBAAgB;CACR,CAAC;AAEX;;;GAGG;AACI,MAAM,gBAAgB,GAAG,CAAC,MAAgC,EAAiB,EAAE,CAClF,YAAY,CAAC,MAAM,CAAgB,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;IAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IAE7G,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,iCAAM,GAAG,KAAE,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC,IAAG,CAAC,CAAC,GAAG,CAAC;AAC9G,CAAC,EAAE,EAAE,CAAC,CAAC;AALI,QAAA,gBAAgB,oBAKpB","sourcesContent":["import { AiStreamUsage } from './types/AiStreamUsage';\n\nconst USAGE_FIELDS = [\n  'inputTokens',\n  'outputTokens',\n  'totalTokens',\n  'cacheReadInputTokens',\n  'cacheWriteInputTokens',\n  'noCacheInputTokens',\n  'costMicroUsd',\n  'chargeMicroUsd',\n] as const;\n\n/**\n * Adds token usages (and their costs and charges) together field by field, for a chat's cost or a turn that spanned several\n * executions. A field no usage reported stays undefined rather than becoming zero.\n */\nexport const sumAiStreamUsage = (usages: readonly AiStreamUsage[]): AiStreamUsage =>\n  USAGE_FIELDS.reduce<AiStreamUsage>((sum, field) => {\n    const reported = usages.map((usage) => usage[field]).filter((value): value is number => value !== undefined);\n\n    return reported.length > 0 ? { ...sum, [field]: reported.reduce((total, value) => total + value, 0) } : sum;\n  }, {});\n"]}

package/lib/commonjs/actions/ai/types/AiModelTokenRates.d.ts

@@ -0,0 +1,4 @@
+import { AiModel } from '../AiModel';
+import { AiTokenRates } from './AiTokenRates';
+/** Token rates for each model that has them, in US dollars per million tokens. */
+export type AiModelTokenRates = Partial<Record<AiModel, AiTokenRates>>;

package/lib/commonjs/actions/ai/types/AiModelTokenRates.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=AiModelTokenRates.js.map

package/lib/commonjs/actions/ai/types/AiModelTokenRates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiModelTokenRates.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiModelTokenRates.ts"],"names":[],"mappings":"","sourcesContent":["import { AiModel } from '../AiModel';\nimport { AiTokenRates } from './AiTokenRates';\n\n/** Token rates for each model that has them, in US dollars per million tokens. */\nexport type AiModelTokenRates = Partial<Record<AiModel, AiTokenRates>>;\n"]}

package/lib/commonjs/actions/ai/types/AiStreamUsage.d.ts

@@ -1,5 +1,6 @@
 /**
- * Token usage reported by the model.
+ * Token usage reported by the model, what it cost when the platform knows its prices, and what it
+ * is charged at when an app bills for it.
  *
  * Each field may be undefined if the underlying provider doesn't report it.
  * `totalTokens` is the sum of input + output (plus any reasoning tokens, when applicable).
@@ -17,4 +18,8 @@ export type AiStreamUsage = {
     cacheWriteInputTokens?: number;
     /** Prompt tokens neither read from nor written to the cache. */
     noCacheInputTokens?: number;
+    /** What the call cost at the platform's list price, in millionths of a US dollar. Set only by a platform that knows its prices. */
+    costMicroUsd?: number;
+    /** What the call is charged at an app's own rates, in millionths of a US dollar. Set by the app that bills for it, never by a platform. */
+    chargeMicroUsd?: number;
 };

package/lib/commonjs/actions/ai/types/AiStreamUsage.js.map

@@ -1 +1 @@
-{"version":3,"file":"AiStreamUsage.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamUsage.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Token usage reported by the model.\n *\n * Each field may be undefined if the underlying provider doesn't report it.\n * `totalTokens` is the sum of input + output (plus any reasoning tokens, when applicable).\n */\nexport type AiStreamUsage = {\n  /** Prompt tokens consumed. */\n  inputTokens?: number;\n  /** Completion tokens produced. */\n  outputTokens?: number;\n  /** Total tokens, typically `inputTokens + outputTokens` (+ reasoning, when applicable). */\n  totalTokens?: number;\n  /** Prompt tokens served from the prompt cache. */\n  cacheReadInputTokens?: number;\n  /** Prompt tokens written to the prompt cache by this request. */\n  cacheWriteInputTokens?: number;\n  /** Prompt tokens neither read from nor written to the cache. */\n  noCacheInputTokens?: number;\n};\n"]}
+{"version":3,"file":"AiStreamUsage.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamUsage.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Token usage reported by the model, what it cost when the platform knows its prices, and what it\n * is charged at when an app bills for it.\n *\n * Each field may be undefined if the underlying provider doesn't report it.\n * `totalTokens` is the sum of input + output (plus any reasoning tokens, when applicable).\n */\nexport type AiStreamUsage = {\n  /** Prompt tokens consumed. */\n  inputTokens?: number;\n  /** Completion tokens produced. */\n  outputTokens?: number;\n  /** Total tokens, typically `inputTokens + outputTokens` (+ reasoning, when applicable). */\n  totalTokens?: number;\n  /** Prompt tokens served from the prompt cache. */\n  cacheReadInputTokens?: number;\n  /** Prompt tokens written to the prompt cache by this request. */\n  cacheWriteInputTokens?: number;\n  /** Prompt tokens neither read from nor written to the cache. */\n  noCacheInputTokens?: number;\n  /** What the call cost at the platform's list price, in millionths of a US dollar. Set only by a platform that knows its prices. */\n  costMicroUsd?: number;\n  /** What the call is charged at an app's own rates, in millionths of a US dollar. Set by the app that bills for it, never by a platform. */\n  chargeMicroUsd?: number;\n};\n"]}

package/lib/commonjs/actions/ai/types/AiTokenRates.d.ts

@@ -0,0 +1,14 @@
+/**
+ * What a model's tokens are priced at, in US dollars per million tokens: a platform's list price,
+ * or an app's own rates for what it charges.
+ */
+export type AiTokenRates = {
+    /** Prompt tokens neither read from nor written to the cache. */
+    input: number;
+    output: number;
+    cacheRead: number;
+    /** A cache write that lives for five minutes. */
+    cacheWriteFiveMinutes: number;
+    /** A cache write that lives for an hour. Absent for a model that only caches for five minutes. */
+    cacheWriteOneHour?: number;
+};

package/lib/commonjs/actions/ai/types/AiTokenRates.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=AiTokenRates.js.map

package/lib/commonjs/actions/ai/types/AiTokenRates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiTokenRates.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiTokenRates.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * What a model's tokens are priced at, in US dollars per million tokens: a platform's list price,\n * or an app's own rates for what it charges.\n */\nexport type AiTokenRates = {\n  /** Prompt tokens neither read from nor written to the cache. */\n  input: number;\n  output: number;\n  cacheRead: number;\n  /** A cache write that lives for five minutes. */\n  cacheWriteFiveMinutes: number;\n  /** A cache write that lives for an hour. Absent for a model that only caches for five minutes. */\n  cacheWriteOneHour?: number;\n};\n"]}

package/lib/commonjs/actions/ai/types/index.d.ts

@@ -1,3 +1,4 @@
+export * from './AiModelTokenRates';
 export * from './AiStreamAbort';
 export * from './AiStreamCustom';
 export * from './AiStreamError';
@@ -30,3 +31,4 @@ export * from './AiStreamToolInputStart';
 export * from './AiStreamToolOutputDenied';
 export * from './AiStreamToolResult';
 export * from './AiStreamUsage';
+export * from './AiTokenRates';

package/lib/commonjs/actions/ai/types/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./AiModelTokenRates"), exports);
 __exportStar(require("./AiStreamAbort"), exports);
 __exportStar(require("./AiStreamCustom"), exports);
 __exportStar(require("./AiStreamError"), exports);
@@ -46,4 +47,5 @@ __exportStar(require("./AiStreamToolInputStart"), exports);
 __exportStar(require("./AiStreamToolOutputDenied"), exports);
 __exportStar(require("./AiStreamToolResult"), exports);
 __exportStar(require("./AiStreamUsage"), exports);
+__exportStar(require("./AiTokenRates"), exports);
 //# sourceMappingURL=index.js.map

package/lib/commonjs/actions/ai/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,mDAAiC;AACjC,kDAAgC;AAChC,iDAA+B;AAC/B,qDAAmC;AACnC,mDAAiC;AACjC,yDAAuC;AACvC,uDAAqC;AACrC,iDAA+B;AAC/B,qDAAmC;AACnC,gDAA8B;AAC9B,2DAAyC;AACzC,yDAAuC;AACvC,8DAA4C;AAC5C,2DAAyC;AACzC,mDAAiC;AACjC,uDAAqC;AACrC,kDAAgC;AAChC,sDAAoC;AACpC,sDAAoC;AACpC,oDAAkC;AAClC,sDAAoC;AACpC,gEAA8C;AAC9C,iEAA+C;AAC/C,qDAAmC;AACnC,sDAAoC;AACpC,2DAAyC;AACzC,yDAAuC;AACvC,2DAAyC;AACzC,6DAA2C;AAC3C,uDAAqC;AACrC,kDAAgC","sourcesContent":["export * from './AiStreamAbort';\nexport * from './AiStreamCustom';\nexport * from './AiStreamError';\nexport * from './AiStreamFile';\nexport * from './AiStreamFilePart';\nexport * from './AiStreamFinish';\nexport * from './AiStreamFinishReason';\nexport * from './AiStreamFinishStep';\nexport * from './AiStreamPart';\nexport * from './AiStreamPartType';\nexport * from './AiStreamRaw';\nexport * from './AiStreamReasoningDelta';\nexport * from './AiStreamReasoningEnd';\nexport * from './AiStreamReasoningFilePart';\nexport * from './AiStreamReasoningStart';\nexport * from './AiStreamSource';\nexport * from './AiStreamSourcePart';\nexport * from './AiStreamStart';\nexport * from './AiStreamStartStep';\nexport * from './AiStreamTextDelta';\nexport * from './AiStreamTextEnd';\nexport * from './AiStreamTextStart';\nexport * from './AiStreamToolApprovalRequest';\nexport * from './AiStreamToolApprovalResponse';\nexport * from './AiStreamToolCall';\nexport * from './AiStreamToolError';\nexport * from './AiStreamToolInputDelta';\nexport * from './AiStreamToolInputEnd';\nexport * from './AiStreamToolInputStart';\nexport * from './AiStreamToolOutputDenied';\nexport * from './AiStreamToolResult';\nexport * from './AiStreamUsage';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,kDAAgC;AAChC,mDAAiC;AACjC,kDAAgC;AAChC,iDAA+B;AAC/B,qDAAmC;AACnC,mDAAiC;AACjC,yDAAuC;AACvC,uDAAqC;AACrC,iDAA+B;AAC/B,qDAAmC;AACnC,gDAA8B;AAC9B,2DAAyC;AACzC,yDAAuC;AACvC,8DAA4C;AAC5C,2DAAyC;AACzC,mDAAiC;AACjC,uDAAqC;AACrC,kDAAgC;AAChC,sDAAoC;AACpC,sDAAoC;AACpC,oDAAkC;AAClC,sDAAoC;AACpC,gEAA8C;AAC9C,iEAA+C;AAC/C,qDAAmC;AACnC,sDAAoC;AACpC,2DAAyC;AACzC,yDAAuC;AACvC,2DAAyC;AACzC,6DAA2C;AAC3C,uDAAqC;AACrC,kDAAgC;AAChC,iDAA+B","sourcesContent":["export * from './AiModelTokenRates';\nexport * from './AiStreamAbort';\nexport * from './AiStreamCustom';\nexport * from './AiStreamError';\nexport * from './AiStreamFile';\nexport * from './AiStreamFilePart';\nexport * from './AiStreamFinish';\nexport * from './AiStreamFinishReason';\nexport * from './AiStreamFinishStep';\nexport * from './AiStreamPart';\nexport * from './AiStreamPartType';\nexport * from './AiStreamRaw';\nexport * from './AiStreamReasoningDelta';\nexport * from './AiStreamReasoningEnd';\nexport * from './AiStreamReasoningFilePart';\nexport * from './AiStreamReasoningStart';\nexport * from './AiStreamSource';\nexport * from './AiStreamSourcePart';\nexport * from './AiStreamStart';\nexport * from './AiStreamStartStep';\nexport * from './AiStreamTextDelta';\nexport * from './AiStreamTextEnd';\nexport * from './AiStreamTextStart';\nexport * from './AiStreamToolApprovalRequest';\nexport * from './AiStreamToolApprovalResponse';\nexport * from './AiStreamToolCall';\nexport * from './AiStreamToolError';\nexport * from './AiStreamToolInputDelta';\nexport * from './AiStreamToolInputEnd';\nexport * from './AiStreamToolInputStart';\nexport * from './AiStreamToolOutputDenied';\nexport * from './AiStreamToolResult';\nexport * from './AiStreamUsage';\nexport * from './AiTokenRates';\n"]}

package/lib/commonjs/types/QpqIsoDateTime.d.ts

@@ -1,9 +1,16 @@
+/** The four-digit year of an ISO 8601 date, such as `2026`. */
 export type TYear = `${number}${number}${number}${number}`;
+/** The two-digit month of an ISO 8601 date, `01` to `12`. */
 export type TMonth = `${number}${number}`;
+/** The two-digit day of the month of an ISO 8601 date, `01` to `31`. */
 export type TDay = `${number}${number}`;
+/** The two-digit hour of an ISO 8601 time on a 24-hour clock, `00` to `23`; also the hours of a UtcOffset. */
 export type THours = `${number}${number}`;
+/** The two-digit minute of an ISO 8601 time, `00` to `59`; also the minutes of a UtcOffset. */
 export type TMinutes = `${number}${number}`;
+/** The two-digit second of an ISO 8601 time, `00` to `59`. */
 export type TSeconds = `${number}${number}`;
+/** The three-digit millisecond of an ISO 8601 time, `000` to `999`. */
 export type TMilliseconds = `${number}${number}${number}`;
 /**
  * Represent a string like `2021-01-08`
@@ -21,3 +28,7 @@ export type TDateISOTime = `${THours}:${TMinutes}:${TSeconds}.${TMilliseconds}`;
  *   "Expression produces a union type that is too complex to represent. ts(2590)
  */
 export type QpqIsoDateTime = `${TDateISODate}T${TDateISOTime}Z`;
+/**
+ * A fixed offset from UTC as `±HH:MM` ('+10:00', '+09:30', '-03:30'). Fixed: it never follows daylight saving.
+ */
+export type UtcOffset = `${'+' | '-'}${THours}:${TMinutes}`;

package/lib/commonjs/types/QpqIsoDateTime.js

@@ -1,5 +1,9 @@
 "use strict";
+/* eslint-disable qpq/one-export-per-file */
 // Template-literal typing for ISO-8601 timestamps
 // (from https://gist.github.com/MrChocolatine/367fb2a35d02f6175cc8ccb3d3a20054)
+//
+// Each `${number}` placeholder accepts any numeric text, so these types catch a missing part, a separator in the wrong
+// place or letters, never an out-of-range value: '99' is a TMonth and '1.5' a THours. Check values at runtime.
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=QpqIsoDateTime.js.map

package/lib/commonjs/types/QpqIsoDateTime.js.map

@@ -1 +1 @@
-{"version":3,"file":"QpqIsoDateTime.js","sourceRoot":"","sources":["../../../src/types/QpqIsoDateTime.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,gFAAgF","sourcesContent":["// Template-literal typing for ISO-8601 timestamps\n// (from https://gist.github.com/MrChocolatine/367fb2a35d02f6175cc8ccb3d3a20054)\n\nexport type TYear = `${number}${number}${number}${number}`;\nexport type TMonth = `${number}${number}`;\nexport type TDay = `${number}${number}`;\nexport type THours = `${number}${number}`;\nexport type TMinutes = `${number}${number}`;\nexport type TSeconds = `${number}${number}`;\nexport type TMilliseconds = `${number}${number}${number}`;\n\n/**\n * Represent a string like `2021-01-08`\n */\nexport type TDateISODate = `${TYear}-${TMonth}-${TDay}`;\n\n/**\n * Represent a string like `14:42:34.678`\n */\nexport type TDateISOTime = `${THours}:${TMinutes}:${TSeconds}.${TMilliseconds}`;\n\n/**\n * Represent a string like `2021-01-08T14:42:34.678Z` (format: ISO 8601).\n *\n * It is not possible to type more precisely (list every possible values for months, hours etc) as\n * it would result in a warning from TypeScript:\n *   \"Expression produces a union type that is too complex to represent. ts(2590)\n */\nexport type QpqIsoDateTime = `${TDateISODate}T${TDateISOTime}Z`;\n"]}
+{"version":3,"file":"QpqIsoDateTime.js","sourceRoot":"","sources":["../../../src/types/QpqIsoDateTime.ts"],"names":[],"mappings":";AAAA,4CAA4C;AAC5C,kDAAkD;AAClD,gFAAgF;AAChF,EAAE;AACF,uHAAuH;AACvH,+GAA+G","sourcesContent":["/* eslint-disable qpq/one-export-per-file */\n// Template-literal typing for ISO-8601 timestamps\n// (from https://gist.github.com/MrChocolatine/367fb2a35d02f6175cc8ccb3d3a20054)\n//\n// Each `${number}` placeholder accepts any numeric text, so these types catch a missing part, a separator in the wrong\n// place or letters, never an out-of-range value: '99' is a TMonth and '1.5' a THours. Check values at runtime.\n\n/** The four-digit year of an ISO 8601 date, such as `2026`. */\nexport type TYear = `${number}${number}${number}${number}`;\n\n/** The two-digit month of an ISO 8601 date, `01` to `12`. */\nexport type TMonth = `${number}${number}`;\n\n/** The two-digit day of the month of an ISO 8601 date, `01` to `31`. */\nexport type TDay = `${number}${number}`;\n\n/** The two-digit hour of an ISO 8601 time on a 24-hour clock, `00` to `23`; also the hours of a UtcOffset. */\nexport type THours = `${number}${number}`;\n\n/** The two-digit minute of an ISO 8601 time, `00` to `59`; also the minutes of a UtcOffset. */\nexport type TMinutes = `${number}${number}`;\n\n/** The two-digit second of an ISO 8601 time, `00` to `59`. */\nexport type TSeconds = `${number}${number}`;\n\n/** The three-digit millisecond of an ISO 8601 time, `000` to `999`. */\nexport type TMilliseconds = `${number}${number}${number}`;\n\n/**\n * Represent a string like `2021-01-08`\n */\nexport type TDateISODate = `${TYear}-${TMonth}-${TDay}`;\n\n/**\n * Represent a string like `14:42:34.678`\n */\nexport type TDateISOTime = `${THours}:${TMinutes}:${TSeconds}.${TMilliseconds}`;\n\n/**\n * Represent a string like `2021-01-08T14:42:34.678Z` (format: ISO 8601).\n *\n * It is not possible to type more precisely (list every possible values for months, hours etc) as\n * it would result in a warning from TypeScript:\n *   \"Expression produces a union type that is too complex to represent. ts(2590)\n */\nexport type QpqIsoDateTime = `${TDateISODate}T${TDateISOTime}Z`;\n\n/**\n * A fixed offset from UTC as `±HH:MM` ('+10:00', '+09:30', '-03:30'). Fixed: it never follows daylight saving.\n */\nexport type UtcOffset = `${'+' | '-'}${THours}:${TMinutes}`;\n"]}

package/lib/commonjs/utils/dateTime/addCalendarMonths.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The calendar day (`YYYY-MM-DD`) some whole months after `day` (negative for before), the day of the month kept where the
+ * target month has it and clamped to its last day where not: 31 March less a month is 28 or 29 February. Unlike
+ * addMonthsToTDateIso, which lets a short month overflow into the next (31 March less a month is 3 March).
+ */
+export declare const addCalendarMonths: (day: string, months: number) => string;

package/lib/commonjs/utils/dateTime/addCalendarMonths.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addCalendarMonths = void 0;
+/**
+ * The calendar day (`YYYY-MM-DD`) some whole months after `day` (negative for before), the day of the month kept where the
+ * target month has it and clamped to its last day where not: 31 March less a month is 28 or 29 February. Unlike
+ * addMonthsToTDateIso, which lets a short month overflow into the next (31 March less a month is 3 March).
+ */
+const addCalendarMonths = (day, months) => {
+    const [year = 0, month = 1, date = 1] = day.split('-').map(Number);
+    const index = year * 12 + (month - 1) + months;
+    const targetYear = Math.floor(index / 12);
+    const targetMonth = index - targetYear * 12 + 1;
+    // Day 0 of the month after is the last day of this one.
+    const lastDate = new Date(Date.UTC(targetYear, targetMonth, 0)).getUTCDate();
+    const pad = (value) => String(value).padStart(2, '0');
+    return `${String(targetYear).padStart(4, '0')}-${pad(targetMonth)}-${pad(Math.min(date, lastDate))}`;
+};
+exports.addCalendarMonths = addCalendarMonths;
+//# sourceMappingURL=addCalendarMonths.js.map

package/lib/commonjs/utils/dateTime/addCalendarMonths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addCalendarMonths.js","sourceRoot":"","sources":["../../../../src/utils/dateTime/addCalendarMonths.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACI,MAAM,iBAAiB,GAAG,CAAC,GAAW,EAAE,MAAc,EAAU,EAAE;IACvE,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAE,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC;IAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,KAAK,GAAG,UAAU,GAAG,EAAE,GAAG,CAAC,CAAC;IAChD,wDAAwD;IACxD,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;IAC7E,MAAM,GAAG,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAEtE,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC;AACvG,CAAC,CAAC;AAVW,QAAA,iBAAiB,qBAU5B","sourcesContent":["/**\n * The calendar day (`YYYY-MM-DD`) some whole months after `day` (negative for before), the day of the month kept where the\n * target month has it and clamped to its last day where not: 31 March less a month is 28 or 29 February. Unlike\n * addMonthsToTDateIso, which lets a short month overflow into the next (31 March less a month is 3 March).\n */\nexport const addCalendarMonths = (day: string, months: number): string => {\n  const [year = 0, month = 1, date = 1] = day.split('-').map(Number);\n  const index = year * 12 + (month - 1) + months;\n  const targetYear = Math.floor(index / 12);\n  const targetMonth = index - targetYear * 12 + 1;\n  // Day 0 of the month after is the last day of this one.\n  const lastDate = new Date(Date.UTC(targetYear, targetMonth, 0)).getUTCDate();\n  const pad = (value: number): string => String(value).padStart(2, '0');\n\n  return `${String(targetYear).padStart(4, '0')}-${pad(targetMonth)}-${pad(Math.min(date, lastDate))}`;\n};\n"]}

package/lib/commonjs/utils/dateTime/getUtcOffsetMinutes.d.ts

@@ -0,0 +1,7 @@
+import { Nullable } from '../../types/Nullable';
+import { UtcOffset } from '../../types/QpqIsoDateTime';
+/**
+ * The minutes an offset adds to UTC ('+09:30' is 570), or null when it is not a real one. The UtcOffset type only checks
+ * the shape (`'+99:00'` compiles), so the range and the quarter hours are checked here.
+ */
+export declare const getUtcOffsetMinutes: (utcOffset: UtcOffset) => Nullable<number>;

package/lib/commonjs/utils/dateTime/getUtcOffsetMinutes.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUtcOffsetMinutes = void 0;
+// Every offset in use lies from -12:00 to +14:00, in whole quarter hours (Nepal is +05:45).
+const MIN_OFFSET_MINUTES = -12 * 60;
+const MAX_OFFSET_MINUTES = 14 * 60;
+const OFFSET_PATTERN = /^([+-])(\d{2}):(\d{2})$/;
+/**
+ * The minutes an offset adds to UTC ('+09:30' is 570), or null when it is not a real one. The UtcOffset type only checks
+ * the shape (`'+99:00'` compiles), so the range and the quarter hours are checked here.
+ */
+const getUtcOffsetMinutes = (utcOffset) => {
+    const match = OFFSET_PATTERN.exec(utcOffset);
+    if (!match) {
+        return null;
+    }
+    const [, sign, hours = '', minutes = ''] = match;
+    const total = (Number(hours) * 60 + Number(minutes)) * (sign === '-' ? -1 : 1);
+    const isQuarterHour = Number(minutes) % 15 === 0 && Number(minutes) < 60;
+    return isQuarterHour && total >= MIN_OFFSET_MINUTES && total <= MAX_OFFSET_MINUTES ? total : null;
+};
+exports.getUtcOffsetMinutes = getUtcOffsetMinutes;
+//# sourceMappingURL=getUtcOffsetMinutes.js.map

package/lib/commonjs/utils/dateTime/getUtcOffsetMinutes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getUtcOffsetMinutes.js","sourceRoot":"","sources":["../../../../src/utils/dateTime/getUtcOffsetMinutes.ts"],"names":[],"mappings":";;;AAGA,4FAA4F;AAC5F,MAAM,kBAAkB,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC;AACpC,MAAM,kBAAkB,GAAG,EAAE,GAAG,EAAE,CAAC;AACnC,MAAM,cAAc,GAAG,yBAAyB,CAAC;AAEjD;;;GAGG;AACI,MAAM,mBAAmB,GAAG,CAAC,SAAoB,EAAoB,EAAE;IAC5E,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAE7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,EAAE,EAAE,OAAO,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC;IACjD,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/E,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAEzE,OAAO,aAAa,IAAI,KAAK,IAAI,kBAAkB,IAAI,KAAK,IAAI,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACpG,CAAC,CAAC;AAZW,QAAA,mBAAmB,uBAY9B","sourcesContent":["import { Nullable } from '../../types/Nullable';\nimport { UtcOffset } from '../../types/QpqIsoDateTime';\n\n// Every offset in use lies from -12:00 to +14:00, in whole quarter hours (Nepal is +05:45).\nconst MIN_OFFSET_MINUTES = -12 * 60;\nconst MAX_OFFSET_MINUTES = 14 * 60;\nconst OFFSET_PATTERN = /^([+-])(\\d{2}):(\\d{2})$/;\n\n/**\n * The minutes an offset adds to UTC ('+09:30' is 570), or null when it is not a real one. The UtcOffset type only checks\n * the shape (`'+99:00'` compiles), so the range and the quarter hours are checked here.\n */\nexport const getUtcOffsetMinutes = (utcOffset: UtcOffset): Nullable<number> => {\n  const match = OFFSET_PATTERN.exec(utcOffset);\n\n  if (!match) {\n    return null;\n  }\n\n  const [, sign, hours = '', minutes = ''] = match;\n  const total = (Number(hours) * 60 + Number(minutes)) * (sign === '-' ? -1 : 1);\n  const isQuarterHour = Number(minutes) % 15 === 0 && Number(minutes) < 60;\n\n  return isQuarterHour && total >= MIN_OFFSET_MINUTES && total <= MAX_OFFSET_MINUTES ? total : null;\n};\n"]}

package/lib/commonjs/utils/dateTime/getWeekdayFromMonday.d.ts

@@ -0,0 +1,2 @@
+/** The weekday of a calendar day (`YYYY-MM-DD`), 0 for Monday to 6 for Sunday. A civil date's weekday needs no zone. */
+export declare const getWeekdayFromMonday: (day: string) => number;

package/lib/commonjs/utils/dateTime/getWeekdayFromMonday.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getWeekdayFromMonday = void 0;
+/** The weekday of a calendar day (`YYYY-MM-DD`), 0 for Monday to 6 for Sunday. A civil date's weekday needs no zone. */
+const getWeekdayFromMonday = (day) => (new Date(`${day}T00:00:00.000Z`).getUTCDay() + 6) % 7;
+exports.getWeekdayFromMonday = getWeekdayFromMonday;
+//# sourceMappingURL=getWeekdayFromMonday.js.map

package/lib/commonjs/utils/dateTime/getWeekdayFromMonday.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWeekdayFromMonday.js","sourceRoot":"","sources":["../../../../src/utils/dateTime/getWeekdayFromMonday.ts"],"names":[],"mappings":";;;AAAA,wHAAwH;AACjH,MAAM,oBAAoB,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,GAAG,gBAAgB,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AAAvG,QAAA,oBAAoB,wBAAmF","sourcesContent":["/** The weekday of a calendar day (`YYYY-MM-DD`), 0 for Monday to 6 for Sunday. A civil date's weekday needs no zone. */\nexport const getWeekdayFromMonday = (day: string): number => (new Date(`${day}T00:00:00.000Z`).getUTCDay() + 6) % 7;\n"]}

package/lib/commonjs/utils/dateTime/index.d.ts

@@ -1,4 +1,8 @@
+export * from './addCalendarMonths';
 export * from './getDateNow';
 export * from './getMillisecondsBetween';
 export * from './getQpqIsoDateTimeFromDate';
+export * from './getUtcOffsetMinutes';
 export * from './getValidQpqIsoDateTime';
+export * from './getWeekdayFromMonday';
+export * from './isQpqIsoDateTime';

package/lib/commonjs/utils/dateTime/index.js

@@ -14,8 +14,12 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./addCalendarMonths"), exports);
 __exportStar(require("./getDateNow"), exports);
 __exportStar(require("./getMillisecondsBetween"), exports);
 __exportStar(require("./getQpqIsoDateTimeFromDate"), exports);
+__exportStar(require("./getUtcOffsetMinutes"), exports);
 __exportStar(require("./getValidQpqIsoDateTime"), exports);
+__exportStar(require("./getWeekdayFromMonday"), exports);
+__exportStar(require("./isQpqIsoDateTime"), exports);
 //# sourceMappingURL=index.js.map

package/lib/commonjs/utils/dateTime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/dateTime/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,2DAAyC;AACzC,8DAA4C;AAC5C,2DAAyC","sourcesContent":["export * from './getDateNow';\nexport * from './getMillisecondsBetween';\nexport * from './getQpqIsoDateTimeFromDate';\nexport * from './getValidQpqIsoDateTime';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/dateTime/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,+CAA6B;AAC7B,2DAAyC;AACzC,8DAA4C;AAC5C,wDAAsC;AACtC,2DAAyC;AACzC,yDAAuC;AACvC,qDAAmC","sourcesContent":["export * from './addCalendarMonths';\nexport * from './getDateNow';\nexport * from './getMillisecondsBetween';\nexport * from './getQpqIsoDateTimeFromDate';\nexport * from './getUtcOffsetMinutes';\nexport * from './getValidQpqIsoDateTime';\nexport * from './getWeekdayFromMonday';\nexport * from './isQpqIsoDateTime';\n"]}

package/lib/commonjs/utils/dateTime/isQpqIsoDateTime.d.ts

@@ -0,0 +1,3 @@
+import { QpqIsoDateTime } from '../../types/QpqIsoDateTime';
+/** Whether a value is a real instant in exactly the QpqIsoDateTime form (`2026-11-09T05:12:40.118Z`): the guard form of getValidQpqIsoDateTime. */
+export declare const isQpqIsoDateTime: (value: unknown) => value is QpqIsoDateTime;

package/lib/commonjs/utils/dateTime/isQpqIsoDateTime.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isQpqIsoDateTime = void 0;
+const getValidQpqIsoDateTime_1 = require("./getValidQpqIsoDateTime");
+/** Whether a value is a real instant in exactly the QpqIsoDateTime form (`2026-11-09T05:12:40.118Z`): the guard form of getValidQpqIsoDateTime. */
+const isQpqIsoDateTime = (value) => typeof value === 'string' && (0, getValidQpqIsoDateTime_1.getValidQpqIsoDateTime)(value) !== undefined;
+exports.isQpqIsoDateTime = isQpqIsoDateTime;
+//# sourceMappingURL=isQpqIsoDateTime.js.map

package/lib/commonjs/utils/dateTime/isQpqIsoDateTime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isQpqIsoDateTime.js","sourceRoot":"","sources":["../../../../src/utils/dateTime/isQpqIsoDateTime.ts"],"names":[],"mappings":";;;AACA,qEAAkE;AAElE,mJAAmJ;AAC5I,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAA2B,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAA,+CAAsB,EAAC,KAAK,CAAC,KAAK,SAAS,CAAC;AAAzI,QAAA,gBAAgB,oBAAyH","sourcesContent":["import { QpqIsoDateTime } from '../../types/QpqIsoDateTime';\nimport { getValidQpqIsoDateTime } from './getValidQpqIsoDateTime';\n\n/** Whether a value is a real instant in exactly the QpqIsoDateTime form (`2026-11-09T05:12:40.118Z`): the guard form of getValidQpqIsoDateTime. */\nexport const isQpqIsoDateTime = (value: unknown): value is QpqIsoDateTime => typeof value === 'string' && getValidQpqIsoDateTime(value) !== undefined;\n"]}

package/lib/esm/actions/ai/getAiUsageAmountMicroUsd.d.ts

@@ -0,0 +1,9 @@
+import { AiStreamUsage } from './types/AiStreamUsage';
+import { AiTokenRates } from './types/AiTokenRates';
+import { AiCacheTtl } from './AiCacheTtl';
+/**
+ * What a call's tokens come to at `rates`, in millionths of a US dollar, rounded to a whole number
+ * so totals add up exactly. Cache writes are priced at the five minute rate only when every write
+ * lived for five minutes (`cacheTtl` FiveMinutes); otherwise at the hour rate, the dearer one.
+ */
+export declare const getAiUsageAmountMicroUsd: (usage: AiStreamUsage, rates: AiTokenRates, cacheTtl?: AiCacheTtl) => number;

package/lib/esm/actions/ai/getAiUsageAmountMicroUsd.js

@@ -0,0 +1,16 @@
+import { AiCacheTtl } from './AiCacheTtl';
+/**
+ * What a call's tokens come to at `rates`, in millionths of a US dollar, rounded to a whole number
+ * so totals add up exactly. Cache writes are priced at the five minute rate only when every write
+ * lived for five minutes (`cacheTtl` FiveMinutes); otherwise at the hour rate, the dearer one.
+ */
+export const getAiUsageAmountMicroUsd = (usage, rates, cacheTtl) => {
+    const cacheReadTokens = usage.cacheReadInputTokens ?? 0;
+    const cacheWriteTokens = usage.cacheWriteInputTokens ?? 0;
+    // `inputTokens` is the total of the three input kinds, so only the uncached part is priced as input.
+    const noCacheTokens = usage.noCacheInputTokens ?? Math.max(0, (usage.inputTokens ?? 0) - cacheReadTokens - cacheWriteTokens);
+    const cacheWriteRate = cacheTtl === AiCacheTtl.FiveMinutes ? rates.cacheWriteFiveMinutes : (rates.cacheWriteOneHour ?? rates.cacheWriteFiveMinutes);
+    // A rate per million tokens times a token count is already millionths of a dollar.
+    return Math.round(noCacheTokens * rates.input + cacheReadTokens * rates.cacheRead + cacheWriteTokens * cacheWriteRate + (usage.outputTokens ?? 0) * rates.output);
+};
+//# sourceMappingURL=getAiUsageAmountMicroUsd.js.map

package/lib/esm/actions/ai/getAiUsageAmountMicroUsd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAiUsageAmountMicroUsd.js","sourceRoot":"","sources":["../../../../src/actions/ai/getAiUsageAmountMicroUsd.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,KAAoB,EAAE,KAAmB,EAAE,QAAqB,EAAU,EAAE;IACnH,MAAM,eAAe,GAAG,KAAK,CAAC,oBAAoB,IAAI,CAAC,CAAC;IACxD,MAAM,gBAAgB,GAAG,KAAK,CAAC,qBAAqB,IAAI,CAAC,CAAC;IAE1D,qGAAqG;IACrG,MAAM,aAAa,GAAG,KAAK,CAAC,kBAAkB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,eAAe,GAAG,gBAAgB,CAAC,CAAC;IAE7H,MAAM,cAAc,GAAG,QAAQ,KAAK,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAEpJ,mFAAmF;IACnF,OAAO,IAAI,CAAC,KAAK,CACf,aAAa,GAAG,KAAK,CAAC,KAAK,GAAG,eAAe,GAAG,KAAK,CAAC,SAAS,GAAG,gBAAgB,GAAG,cAAc,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAC/I,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import { AiStreamUsage } from './types/AiStreamUsage';\nimport { AiTokenRates } from './types/AiTokenRates';\nimport { AiCacheTtl } from './AiCacheTtl';\n\n/**\n * What a call's tokens come to at `rates`, in millionths of a US dollar, rounded to a whole number\n * so totals add up exactly. Cache writes are priced at the five minute rate only when every write\n * lived for five minutes (`cacheTtl` FiveMinutes); otherwise at the hour rate, the dearer one.\n */\nexport const getAiUsageAmountMicroUsd = (usage: AiStreamUsage, rates: AiTokenRates, cacheTtl?: AiCacheTtl): number => {\n  const cacheReadTokens = usage.cacheReadInputTokens ?? 0;\n  const cacheWriteTokens = usage.cacheWriteInputTokens ?? 0;\n\n  // `inputTokens` is the total of the three input kinds, so only the uncached part is priced as input.\n  const noCacheTokens = usage.noCacheInputTokens ?? Math.max(0, (usage.inputTokens ?? 0) - cacheReadTokens - cacheWriteTokens);\n\n  const cacheWriteRate = cacheTtl === AiCacheTtl.FiveMinutes ? rates.cacheWriteFiveMinutes : (rates.cacheWriteOneHour ?? rates.cacheWriteFiveMinutes);\n\n  // A rate per million tokens times a token count is already millionths of a dollar.\n  return Math.round(\n    noCacheTokens * rates.input + cacheReadTokens * rates.cacheRead + cacheWriteTokens * cacheWriteRate + (usage.outputTokens ?? 0) * rates.output,\n  );\n};\n"]}

package/lib/esm/actions/ai/index.d.ts

@@ -10,5 +10,6 @@ export * from './AiReasoningEffort';
 export * from './askAiGetModelRegions';
 export * from './askAiPrompt';
 export * from './askAiPromptStream';
+export * from './getAiUsageAmountMicroUsd';
 export * from './sumAiStreamUsage';
 export * from './types';

package/lib/esm/actions/ai/index.js

@@ -10,6 +10,7 @@ export * from './AiReasoningEffort';
 export * from './askAiGetModelRegions';
 export * from './askAiPrompt';
 export * from './askAiPromptStream';
+export * from './getAiUsageAmountMicroUsd';
 export * from './sumAiStreamUsage';
 export * from './types';
 //# sourceMappingURL=index.js.map

package/lib/esm/actions/ai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/ai/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC","sourcesContent":["export * from './AiActionType';\nexport * from './AiCacheTtl';\nexport * from './AiDataRegion';\nexport * from './AiJsonSchema';\nexport * from './AiMessage';\nexport * from './AiModel';\nexport * from './AiModelRegionMap';\nexport * from './AiReasoningConfig';\nexport * from './AiReasoningEffort';\nexport * from './askAiGetModelRegions';\nexport * from './askAiPrompt';\nexport * from './askAiPromptStream';\nexport * from './sumAiStreamUsage';\nexport * from './types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/ai/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC","sourcesContent":["export * from './AiActionType';\nexport * from './AiCacheTtl';\nexport * from './AiDataRegion';\nexport * from './AiJsonSchema';\nexport * from './AiMessage';\nexport * from './AiModel';\nexport * from './AiModelRegionMap';\nexport * from './AiReasoningConfig';\nexport * from './AiReasoningEffort';\nexport * from './askAiGetModelRegions';\nexport * from './askAiPrompt';\nexport * from './askAiPromptStream';\nexport * from './getAiUsageAmountMicroUsd';\nexport * from './sumAiStreamUsage';\nexport * from './types';\n"]}

package/lib/esm/actions/ai/sumAiStreamUsage.d.ts

@@ -1,6 +1,6 @@
 import { AiStreamUsage } from './types/AiStreamUsage';
 /**
- * Adds token usages together field by field, for a chat's cost or a turn that spanned several
+ * Adds token usages (and their costs and charges) together field by field, for a chat's cost or a turn that spanned several
  * executions. A field no usage reported stays undefined rather than becoming zero.
  */
 export declare const sumAiStreamUsage: (usages: readonly AiStreamUsage[]) => AiStreamUsage;

package/lib/esm/actions/ai/sumAiStreamUsage.js

@@ -1,6 +1,15 @@
-const USAGE_FIELDS = ['inputTokens', 'outputTokens', 'totalTokens', 'cacheReadInputTokens', 'cacheWriteInputTokens', 'noCacheInputTokens'];
+const USAGE_FIELDS = [
+    'inputTokens',
+    'outputTokens',
+    'totalTokens',
+    'cacheReadInputTokens',
+    'cacheWriteInputTokens',
+    'noCacheInputTokens',
+    'costMicroUsd',
+    'chargeMicroUsd',
+];
 /**
- * Adds token usages together field by field, for a chat's cost or a turn that spanned several
+ * Adds token usages (and their costs and charges) together field by field, for a chat's cost or a turn that spanned several
  * executions. A field no usage reported stays undefined rather than becoming zero.
  */
 export const sumAiStreamUsage = (usages) => USAGE_FIELDS.reduce((sum, field) => {

package/lib/esm/actions/ai/sumAiStreamUsage.js.map

@@ -1 +1 @@
-{"version":3,"file":"sumAiStreamUsage.js","sourceRoot":"","sources":["../../../../src/actions/ai/sumAiStreamUsage.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAG,CAAC,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,oBAAoB,CAAU,CAAC;AAEpJ;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAgC,EAAiB,EAAE,CAClF,YAAY,CAAC,MAAM,CAAgB,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;IAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IAE7G,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AAC9G,CAAC,EAAE,EAAE,CAAC,CAAC","sourcesContent":["import { AiStreamUsage } from './types/AiStreamUsage';\n\nconst USAGE_FIELDS = ['inputTokens', 'outputTokens', 'totalTokens', 'cacheReadInputTokens', 'cacheWriteInputTokens', 'noCacheInputTokens'] as const;\n\n/**\n * Adds token usages together field by field, for a chat's cost or a turn that spanned several\n * executions. A field no usage reported stays undefined rather than becoming zero.\n */\nexport const sumAiStreamUsage = (usages: readonly AiStreamUsage[]): AiStreamUsage =>\n  USAGE_FIELDS.reduce<AiStreamUsage>((sum, field) => {\n    const reported = usages.map((usage) => usage[field]).filter((value): value is number => value !== undefined);\n\n    return reported.length > 0 ? { ...sum, [field]: reported.reduce((total, value) => total + value, 0) } : sum;\n  }, {});\n"]}
+{"version":3,"file":"sumAiStreamUsage.js","sourceRoot":"","sources":["../../../../src/actions/ai/sumAiStreamUsage.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAG;IACnB,aAAa;IACb,cAAc;IACd,aAAa;IACb,sBAAsB;IACtB,uBAAuB;IACvB,oBAAoB;IACpB,cAAc;IACd,gBAAgB;CACR,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAgC,EAAiB,EAAE,CAClF,YAAY,CAAC,MAAM,CAAgB,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;IAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IAE7G,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AAC9G,CAAC,EAAE,EAAE,CAAC,CAAC","sourcesContent":["import { AiStreamUsage } from './types/AiStreamUsage';\n\nconst USAGE_FIELDS = [\n  'inputTokens',\n  'outputTokens',\n  'totalTokens',\n  'cacheReadInputTokens',\n  'cacheWriteInputTokens',\n  'noCacheInputTokens',\n  'costMicroUsd',\n  'chargeMicroUsd',\n] as const;\n\n/**\n * Adds token usages (and their costs and charges) together field by field, for a chat's cost or a turn that spanned several\n * executions. A field no usage reported stays undefined rather than becoming zero.\n */\nexport const sumAiStreamUsage = (usages: readonly AiStreamUsage[]): AiStreamUsage =>\n  USAGE_FIELDS.reduce<AiStreamUsage>((sum, field) => {\n    const reported = usages.map((usage) => usage[field]).filter((value): value is number => value !== undefined);\n\n    return reported.length > 0 ? { ...sum, [field]: reported.reduce((total, value) => total + value, 0) } : sum;\n  }, {});\n"]}

package/lib/esm/actions/ai/types/AiModelTokenRates.d.ts

@@ -0,0 +1,4 @@
+import { AiModel } from '../AiModel';
+import { AiTokenRates } from './AiTokenRates';
+/** Token rates for each model that has them, in US dollars per million tokens. */
+export type AiModelTokenRates = Partial<Record<AiModel, AiTokenRates>>;

package/lib/esm/actions/ai/types/AiModelTokenRates.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AiModelTokenRates.js.map

package/lib/esm/actions/ai/types/AiModelTokenRates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiModelTokenRates.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiModelTokenRates.ts"],"names":[],"mappings":"","sourcesContent":["import { AiModel } from '../AiModel';\nimport { AiTokenRates } from './AiTokenRates';\n\n/** Token rates for each model that has them, in US dollars per million tokens. */\nexport type AiModelTokenRates = Partial<Record<AiModel, AiTokenRates>>;\n"]}

package/lib/esm/actions/ai/types/AiStreamUsage.d.ts

@@ -1,5 +1,6 @@
 /**
- * Token usage reported by the model.
+ * Token usage reported by the model, what it cost when the platform knows its prices, and what it
+ * is charged at when an app bills for it.
  *
  * Each field may be undefined if the underlying provider doesn't report it.
  * `totalTokens` is the sum of input + output (plus any reasoning tokens, when applicable).
@@ -17,4 +18,8 @@ export type AiStreamUsage = {
     cacheWriteInputTokens?: number;
     /** Prompt tokens neither read from nor written to the cache. */
     noCacheInputTokens?: number;
+    /** What the call cost at the platform's list price, in millionths of a US dollar. Set only by a platform that knows its prices. */
+    costMicroUsd?: number;
+    /** What the call is charged at an app's own rates, in millionths of a US dollar. Set by the app that bills for it, never by a platform. */
+    chargeMicroUsd?: number;
 };

package/lib/esm/actions/ai/types/AiStreamUsage.js.map

@@ -1 +1 @@
-{"version":3,"file":"AiStreamUsage.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamUsage.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Token usage reported by the model.\n *\n * Each field may be undefined if the underlying provider doesn't report it.\n * `totalTokens` is the sum of input + output (plus any reasoning tokens, when applicable).\n */\nexport type AiStreamUsage = {\n  /** Prompt tokens consumed. */\n  inputTokens?: number;\n  /** Completion tokens produced. */\n  outputTokens?: number;\n  /** Total tokens, typically `inputTokens + outputTokens` (+ reasoning, when applicable). */\n  totalTokens?: number;\n  /** Prompt tokens served from the prompt cache. */\n  cacheReadInputTokens?: number;\n  /** Prompt tokens written to the prompt cache by this request. */\n  cacheWriteInputTokens?: number;\n  /** Prompt tokens neither read from nor written to the cache. */\n  noCacheInputTokens?: number;\n};\n"]}
+{"version":3,"file":"AiStreamUsage.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamUsage.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Token usage reported by the model, what it cost when the platform knows its prices, and what it\n * is charged at when an app bills for it.\n *\n * Each field may be undefined if the underlying provider doesn't report it.\n * `totalTokens` is the sum of input + output (plus any reasoning tokens, when applicable).\n */\nexport type AiStreamUsage = {\n  /** Prompt tokens consumed. */\n  inputTokens?: number;\n  /** Completion tokens produced. */\n  outputTokens?: number;\n  /** Total tokens, typically `inputTokens + outputTokens` (+ reasoning, when applicable). */\n  totalTokens?: number;\n  /** Prompt tokens served from the prompt cache. */\n  cacheReadInputTokens?: number;\n  /** Prompt tokens written to the prompt cache by this request. */\n  cacheWriteInputTokens?: number;\n  /** Prompt tokens neither read from nor written to the cache. */\n  noCacheInputTokens?: number;\n  /** What the call cost at the platform's list price, in millionths of a US dollar. Set only by a platform that knows its prices. */\n  costMicroUsd?: number;\n  /** What the call is charged at an app's own rates, in millionths of a US dollar. Set by the app that bills for it, never by a platform. */\n  chargeMicroUsd?: number;\n};\n"]}

package/lib/esm/actions/ai/types/AiTokenRates.d.ts

@@ -0,0 +1,14 @@
+/**
+ * What a model's tokens are priced at, in US dollars per million tokens: a platform's list price,
+ * or an app's own rates for what it charges.
+ */
+export type AiTokenRates = {
+    /** Prompt tokens neither read from nor written to the cache. */
+    input: number;
+    output: number;
+    cacheRead: number;
+    /** A cache write that lives for five minutes. */
+    cacheWriteFiveMinutes: number;
+    /** A cache write that lives for an hour. Absent for a model that only caches for five minutes. */
+    cacheWriteOneHour?: number;
+};

package/lib/esm/actions/ai/types/AiTokenRates.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AiTokenRates.js.map

package/lib/esm/actions/ai/types/AiTokenRates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiTokenRates.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiTokenRates.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * What a model's tokens are priced at, in US dollars per million tokens: a platform's list price,\n * or an app's own rates for what it charges.\n */\nexport type AiTokenRates = {\n  /** Prompt tokens neither read from nor written to the cache. */\n  input: number;\n  output: number;\n  cacheRead: number;\n  /** A cache write that lives for five minutes. */\n  cacheWriteFiveMinutes: number;\n  /** A cache write that lives for an hour. Absent for a model that only caches for five minutes. */\n  cacheWriteOneHour?: number;\n};\n"]}

package/lib/esm/actions/ai/types/index.d.ts

@@ -1,3 +1,4 @@
+export * from './AiModelTokenRates';
 export * from './AiStreamAbort';
 export * from './AiStreamCustom';
 export * from './AiStreamError';
@@ -30,3 +31,4 @@ export * from './AiStreamToolInputStart';
 export * from './AiStreamToolOutputDenied';
 export * from './AiStreamToolResult';
 export * from './AiStreamUsage';
+export * from './AiTokenRates';

package/lib/esm/actions/ai/types/index.js

@@ -1,3 +1,4 @@
+export * from './AiModelTokenRates';
 export * from './AiStreamAbort';
 export * from './AiStreamCustom';
 export * from './AiStreamError';
@@ -30,4 +31,5 @@ export * from './AiStreamToolInputStart';
 export * from './AiStreamToolOutputDenied';
 export * from './AiStreamToolResult';
 export * from './AiStreamUsage';
+export * from './AiTokenRates';
 //# sourceMappingURL=index.js.map

package/lib/esm/actions/ai/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC","sourcesContent":["export * from './AiStreamAbort';\nexport * from './AiStreamCustom';\nexport * from './AiStreamError';\nexport * from './AiStreamFile';\nexport * from './AiStreamFilePart';\nexport * from './AiStreamFinish';\nexport * from './AiStreamFinishReason';\nexport * from './AiStreamFinishStep';\nexport * from './AiStreamPart';\nexport * from './AiStreamPartType';\nexport * from './AiStreamRaw';\nexport * from './AiStreamReasoningDelta';\nexport * from './AiStreamReasoningEnd';\nexport * from './AiStreamReasoningFilePart';\nexport * from './AiStreamReasoningStart';\nexport * from './AiStreamSource';\nexport * from './AiStreamSourcePart';\nexport * from './AiStreamStart';\nexport * from './AiStreamStartStep';\nexport * from './AiStreamTextDelta';\nexport * from './AiStreamTextEnd';\nexport * from './AiStreamTextStart';\nexport * from './AiStreamToolApprovalRequest';\nexport * from './AiStreamToolApprovalResponse';\nexport * from './AiStreamToolCall';\nexport * from './AiStreamToolError';\nexport * from './AiStreamToolInputDelta';\nexport * from './AiStreamToolInputEnd';\nexport * from './AiStreamToolInputStart';\nexport * from './AiStreamToolOutputDenied';\nexport * from './AiStreamToolResult';\nexport * from './AiStreamUsage';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC","sourcesContent":["export * from './AiModelTokenRates';\nexport * from './AiStreamAbort';\nexport * from './AiStreamCustom';\nexport * from './AiStreamError';\nexport * from './AiStreamFile';\nexport * from './AiStreamFilePart';\nexport * from './AiStreamFinish';\nexport * from './AiStreamFinishReason';\nexport * from './AiStreamFinishStep';\nexport * from './AiStreamPart';\nexport * from './AiStreamPartType';\nexport * from './AiStreamRaw';\nexport * from './AiStreamReasoningDelta';\nexport * from './AiStreamReasoningEnd';\nexport * from './AiStreamReasoningFilePart';\nexport * from './AiStreamReasoningStart';\nexport * from './AiStreamSource';\nexport * from './AiStreamSourcePart';\nexport * from './AiStreamStart';\nexport * from './AiStreamStartStep';\nexport * from './AiStreamTextDelta';\nexport * from './AiStreamTextEnd';\nexport * from './AiStreamTextStart';\nexport * from './AiStreamToolApprovalRequest';\nexport * from './AiStreamToolApprovalResponse';\nexport * from './AiStreamToolCall';\nexport * from './AiStreamToolError';\nexport * from './AiStreamToolInputDelta';\nexport * from './AiStreamToolInputEnd';\nexport * from './AiStreamToolInputStart';\nexport * from './AiStreamToolOutputDenied';\nexport * from './AiStreamToolResult';\nexport * from './AiStreamUsage';\nexport * from './AiTokenRates';\n"]}

package/lib/esm/types/QpqIsoDateTime.d.ts

@@ -1,9 +1,16 @@
+/** The four-digit year of an ISO 8601 date, such as `2026`. */
 export type TYear = `${number}${number}${number}${number}`;
+/** The two-digit month of an ISO 8601 date, `01` to `12`. */
 export type TMonth = `${number}${number}`;
+/** The two-digit day of the month of an ISO 8601 date, `01` to `31`. */
 export type TDay = `${number}${number}`;
+/** The two-digit hour of an ISO 8601 time on a 24-hour clock, `00` to `23`; also the hours of a UtcOffset. */
 export type THours = `${number}${number}`;
+/** The two-digit minute of an ISO 8601 time, `00` to `59`; also the minutes of a UtcOffset. */
 export type TMinutes = `${number}${number}`;
+/** The two-digit second of an ISO 8601 time, `00` to `59`. */
 export type TSeconds = `${number}${number}`;
+/** The three-digit millisecond of an ISO 8601 time, `000` to `999`. */
 export type TMilliseconds = `${number}${number}${number}`;
 /**
  * Represent a string like `2021-01-08`
@@ -21,3 +28,7 @@ export type TDateISOTime = `${THours}:${TMinutes}:${TSeconds}.${TMilliseconds}`;
  *   "Expression produces a union type that is too complex to represent. ts(2590)
  */
 export type QpqIsoDateTime = `${TDateISODate}T${TDateISOTime}Z`;
+/**
+ * A fixed offset from UTC as `±HH:MM` ('+10:00', '+09:30', '-03:30'). Fixed: it never follows daylight saving.
+ */
+export type UtcOffset = `${'+' | '-'}${THours}:${TMinutes}`;

package/lib/esm/types/QpqIsoDateTime.js

@@ -1,4 +1,8 @@
+/* eslint-disable qpq/one-export-per-file */
 // Template-literal typing for ISO-8601 timestamps
 // (from https://gist.github.com/MrChocolatine/367fb2a35d02f6175cc8ccb3d3a20054)
+//
+// Each `${number}` placeholder accepts any numeric text, so these types catch a missing part, a separator in the wrong
+// place or letters, never an out-of-range value: '99' is a TMonth and '1.5' a THours. Check values at runtime.
 export {};
 //# sourceMappingURL=QpqIsoDateTime.js.map

package/lib/esm/types/QpqIsoDateTime.js.map

@@ -1 +1 @@
-{"version":3,"file":"QpqIsoDateTime.js","sourceRoot":"","sources":["../../../src/types/QpqIsoDateTime.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,gFAAgF","sourcesContent":["// Template-literal typing for ISO-8601 timestamps\n// (from https://gist.github.com/MrChocolatine/367fb2a35d02f6175cc8ccb3d3a20054)\n\nexport type TYear = `${number}${number}${number}${number}`;\nexport type TMonth = `${number}${number}`;\nexport type TDay = `${number}${number}`;\nexport type THours = `${number}${number}`;\nexport type TMinutes = `${number}${number}`;\nexport type TSeconds = `${number}${number}`;\nexport type TMilliseconds = `${number}${number}${number}`;\n\n/**\n * Represent a string like `2021-01-08`\n */\nexport type TDateISODate = `${TYear}-${TMonth}-${TDay}`;\n\n/**\n * Represent a string like `14:42:34.678`\n */\nexport type TDateISOTime = `${THours}:${TMinutes}:${TSeconds}.${TMilliseconds}`;\n\n/**\n * Represent a string like `2021-01-08T14:42:34.678Z` (format: ISO 8601).\n *\n * It is not possible to type more precisely (list every possible values for months, hours etc) as\n * it would result in a warning from TypeScript:\n *   \"Expression produces a union type that is too complex to represent. ts(2590)\n */\nexport type QpqIsoDateTime = `${TDateISODate}T${TDateISOTime}Z`;\n"]}
+{"version":3,"file":"QpqIsoDateTime.js","sourceRoot":"","sources":["../../../src/types/QpqIsoDateTime.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,kDAAkD;AAClD,gFAAgF;AAChF,EAAE;AACF,uHAAuH;AACvH,+GAA+G","sourcesContent":["/* eslint-disable qpq/one-export-per-file */\n// Template-literal typing for ISO-8601 timestamps\n// (from https://gist.github.com/MrChocolatine/367fb2a35d02f6175cc8ccb3d3a20054)\n//\n// Each `${number}` placeholder accepts any numeric text, so these types catch a missing part, a separator in the wrong\n// place or letters, never an out-of-range value: '99' is a TMonth and '1.5' a THours. Check values at runtime.\n\n/** The four-digit year of an ISO 8601 date, such as `2026`. */\nexport type TYear = `${number}${number}${number}${number}`;\n\n/** The two-digit month of an ISO 8601 date, `01` to `12`. */\nexport type TMonth = `${number}${number}`;\n\n/** The two-digit day of the month of an ISO 8601 date, `01` to `31`. */\nexport type TDay = `${number}${number}`;\n\n/** The two-digit hour of an ISO 8601 time on a 24-hour clock, `00` to `23`; also the hours of a UtcOffset. */\nexport type THours = `${number}${number}`;\n\n/** The two-digit minute of an ISO 8601 time, `00` to `59`; also the minutes of a UtcOffset. */\nexport type TMinutes = `${number}${number}`;\n\n/** The two-digit second of an ISO 8601 time, `00` to `59`. */\nexport type TSeconds = `${number}${number}`;\n\n/** The three-digit millisecond of an ISO 8601 time, `000` to `999`. */\nexport type TMilliseconds = `${number}${number}${number}`;\n\n/**\n * Represent a string like `2021-01-08`\n */\nexport type TDateISODate = `${TYear}-${TMonth}-${TDay}`;\n\n/**\n * Represent a string like `14:42:34.678`\n */\nexport type TDateISOTime = `${THours}:${TMinutes}:${TSeconds}.${TMilliseconds}`;\n\n/**\n * Represent a string like `2021-01-08T14:42:34.678Z` (format: ISO 8601).\n *\n * It is not possible to type more precisely (list every possible values for months, hours etc) as\n * it would result in a warning from TypeScript:\n *   \"Expression produces a union type that is too complex to represent. ts(2590)\n */\nexport type QpqIsoDateTime = `${TDateISODate}T${TDateISOTime}Z`;\n\n/**\n * A fixed offset from UTC as `±HH:MM` ('+10:00', '+09:30', '-03:30'). Fixed: it never follows daylight saving.\n */\nexport type UtcOffset = `${'+' | '-'}${THours}:${TMinutes}`;\n"]}

package/lib/esm/utils/dateTime/addCalendarMonths.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The calendar day (`YYYY-MM-DD`) some whole months after `day` (negative for before), the day of the month kept where the
+ * target month has it and clamped to its last day where not: 31 March less a month is 28 or 29 February. Unlike
+ * addMonthsToTDateIso, which lets a short month overflow into the next (31 March less a month is 3 March).
+ */
+export declare const addCalendarMonths: (day: string, months: number) => string;

package/lib/esm/utils/dateTime/addCalendarMonths.js

@@ -0,0 +1,16 @@
+/**
+ * The calendar day (`YYYY-MM-DD`) some whole months after `day` (negative for before), the day of the month kept where the
+ * target month has it and clamped to its last day where not: 31 March less a month is 28 or 29 February. Unlike
+ * addMonthsToTDateIso, which lets a short month overflow into the next (31 March less a month is 3 March).
+ */
+export const addCalendarMonths = (day, months) => {
+    const [year = 0, month = 1, date = 1] = day.split('-').map(Number);
+    const index = year * 12 + (month - 1) + months;
+    const targetYear = Math.floor(index / 12);
+    const targetMonth = index - targetYear * 12 + 1;
+    // Day 0 of the month after is the last day of this one.
+    const lastDate = new Date(Date.UTC(targetYear, targetMonth, 0)).getUTCDate();
+    const pad = (value) => String(value).padStart(2, '0');
+    return `${String(targetYear).padStart(4, '0')}-${pad(targetMonth)}-${pad(Math.min(date, lastDate))}`;
+};
+//# sourceMappingURL=addCalendarMonths.js.map

package/lib/esm/utils/dateTime/addCalendarMonths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addCalendarMonths.js","sourceRoot":"","sources":["../../../../src/utils/dateTime/addCalendarMonths.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAAW,EAAE,MAAc,EAAU,EAAE;IACvE,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAE,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC;IAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,KAAK,GAAG,UAAU,GAAG,EAAE,GAAG,CAAC,CAAC;IAChD,wDAAwD;IACxD,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;IAC7E,MAAM,GAAG,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAEtE,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC;AACvG,CAAC,CAAC","sourcesContent":["/**\n * The calendar day (`YYYY-MM-DD`) some whole months after `day` (negative for before), the day of the month kept where the\n * target month has it and clamped to its last day where not: 31 March less a month is 28 or 29 February. Unlike\n * addMonthsToTDateIso, which lets a short month overflow into the next (31 March less a month is 3 March).\n */\nexport const addCalendarMonths = (day: string, months: number): string => {\n  const [year = 0, month = 1, date = 1] = day.split('-').map(Number);\n  const index = year * 12 + (month - 1) + months;\n  const targetYear = Math.floor(index / 12);\n  const targetMonth = index - targetYear * 12 + 1;\n  // Day 0 of the month after is the last day of this one.\n  const lastDate = new Date(Date.UTC(targetYear, targetMonth, 0)).getUTCDate();\n  const pad = (value: number): string => String(value).padStart(2, '0');\n\n  return `${String(targetYear).padStart(4, '0')}-${pad(targetMonth)}-${pad(Math.min(date, lastDate))}`;\n};\n"]}

package/lib/esm/utils/dateTime/getUtcOffsetMinutes.d.ts

@@ -0,0 +1,7 @@
+import { Nullable } from '../../types/Nullable';
+import { UtcOffset } from '../../types/QpqIsoDateTime';
+/**
+ * The minutes an offset adds to UTC ('+09:30' is 570), or null when it is not a real one. The UtcOffset type only checks
+ * the shape (`'+99:00'` compiles), so the range and the quarter hours are checked here.
+ */
+export declare const getUtcOffsetMinutes: (utcOffset: UtcOffset) => Nullable<number>;

package/lib/esm/utils/dateTime/getUtcOffsetMinutes.js

@@ -0,0 +1,19 @@
+// Every offset in use lies from -12:00 to +14:00, in whole quarter hours (Nepal is +05:45).
+const MIN_OFFSET_MINUTES = -12 * 60;
+const MAX_OFFSET_MINUTES = 14 * 60;
+const OFFSET_PATTERN = /^([+-])(\d{2}):(\d{2})$/;
+/**
+ * The minutes an offset adds to UTC ('+09:30' is 570), or null when it is not a real one. The UtcOffset type only checks
+ * the shape (`'+99:00'` compiles), so the range and the quarter hours are checked here.
+ */
+export const getUtcOffsetMinutes = (utcOffset) => {
+    const match = OFFSET_PATTERN.exec(utcOffset);
+    if (!match) {
+        return null;
+    }
+    const [, sign, hours = '', minutes = ''] = match;
+    const total = (Number(hours) * 60 + Number(minutes)) * (sign === '-' ? -1 : 1);
+    const isQuarterHour = Number(minutes) % 15 === 0 && Number(minutes) < 60;
+    return isQuarterHour && total >= MIN_OFFSET_MINUTES && total <= MAX_OFFSET_MINUTES ? total : null;
+};
+//# sourceMappingURL=getUtcOffsetMinutes.js.map

package/lib/esm/utils/dateTime/getUtcOffsetMinutes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getUtcOffsetMinutes.js","sourceRoot":"","sources":["../../../../src/utils/dateTime/getUtcOffsetMinutes.ts"],"names":[],"mappings":"AAGA,4FAA4F;AAC5F,MAAM,kBAAkB,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC;AACpC,MAAM,kBAAkB,GAAG,EAAE,GAAG,EAAE,CAAC;AACnC,MAAM,cAAc,GAAG,yBAAyB,CAAC;AAEjD;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAAoB,EAAoB,EAAE;IAC5E,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAE7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,EAAE,EAAE,OAAO,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC;IACjD,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/E,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAEzE,OAAO,aAAa,IAAI,KAAK,IAAI,kBAAkB,IAAI,KAAK,IAAI,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACpG,CAAC,CAAC","sourcesContent":["import { Nullable } from '../../types/Nullable';\nimport { UtcOffset } from '../../types/QpqIsoDateTime';\n\n// Every offset in use lies from -12:00 to +14:00, in whole quarter hours (Nepal is +05:45).\nconst MIN_OFFSET_MINUTES = -12 * 60;\nconst MAX_OFFSET_MINUTES = 14 * 60;\nconst OFFSET_PATTERN = /^([+-])(\\d{2}):(\\d{2})$/;\n\n/**\n * The minutes an offset adds to UTC ('+09:30' is 570), or null when it is not a real one. The UtcOffset type only checks\n * the shape (`'+99:00'` compiles), so the range and the quarter hours are checked here.\n */\nexport const getUtcOffsetMinutes = (utcOffset: UtcOffset): Nullable<number> => {\n  const match = OFFSET_PATTERN.exec(utcOffset);\n\n  if (!match) {\n    return null;\n  }\n\n  const [, sign, hours = '', minutes = ''] = match;\n  const total = (Number(hours) * 60 + Number(minutes)) * (sign === '-' ? -1 : 1);\n  const isQuarterHour = Number(minutes) % 15 === 0 && Number(minutes) < 60;\n\n  return isQuarterHour && total >= MIN_OFFSET_MINUTES && total <= MAX_OFFSET_MINUTES ? total : null;\n};\n"]}

package/lib/esm/utils/dateTime/getWeekdayFromMonday.d.ts

@@ -0,0 +1,2 @@
+/** The weekday of a calendar day (`YYYY-MM-DD`), 0 for Monday to 6 for Sunday. A civil date's weekday needs no zone. */
+export declare const getWeekdayFromMonday: (day: string) => number;

package/lib/esm/utils/dateTime/getWeekdayFromMonday.js

@@ -0,0 +1,3 @@
+/** The weekday of a calendar day (`YYYY-MM-DD`), 0 for Monday to 6 for Sunday. A civil date's weekday needs no zone. */
+export const getWeekdayFromMonday = (day) => (new Date(`${day}T00:00:00.000Z`).getUTCDay() + 6) % 7;
+//# sourceMappingURL=getWeekdayFromMonday.js.map

package/lib/esm/utils/dateTime/getWeekdayFromMonday.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWeekdayFromMonday.js","sourceRoot":"","sources":["../../../../src/utils/dateTime/getWeekdayFromMonday.ts"],"names":[],"mappings":"AAAA,wHAAwH;AACxH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,GAAG,gBAAgB,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC","sourcesContent":["/** The weekday of a calendar day (`YYYY-MM-DD`), 0 for Monday to 6 for Sunday. A civil date's weekday needs no zone. */\nexport const getWeekdayFromMonday = (day: string): number => (new Date(`${day}T00:00:00.000Z`).getUTCDay() + 6) % 7;\n"]}

package/lib/esm/utils/dateTime/index.d.ts

@@ -1,4 +1,8 @@
+export * from './addCalendarMonths';
 export * from './getDateNow';
 export * from './getMillisecondsBetween';
 export * from './getQpqIsoDateTimeFromDate';
+export * from './getUtcOffsetMinutes';
 export * from './getValidQpqIsoDateTime';
+export * from './getWeekdayFromMonday';
+export * from './isQpqIsoDateTime';

package/lib/esm/utils/dateTime/index.js

@@ -1,5 +1,9 @@
+export * from './addCalendarMonths';
 export * from './getDateNow';
 export * from './getMillisecondsBetween';
 export * from './getQpqIsoDateTimeFromDate';
+export * from './getUtcOffsetMinutes';
 export * from './getValidQpqIsoDateTime';
+export * from './getWeekdayFromMonday';
+export * from './isQpqIsoDateTime';
 //# sourceMappingURL=index.js.map

package/lib/esm/utils/dateTime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/dateTime/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC","sourcesContent":["export * from './getDateNow';\nexport * from './getMillisecondsBetween';\nexport * from './getQpqIsoDateTimeFromDate';\nexport * from './getValidQpqIsoDateTime';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/dateTime/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC","sourcesContent":["export * from './addCalendarMonths';\nexport * from './getDateNow';\nexport * from './getMillisecondsBetween';\nexport * from './getQpqIsoDateTimeFromDate';\nexport * from './getUtcOffsetMinutes';\nexport * from './getValidQpqIsoDateTime';\nexport * from './getWeekdayFromMonday';\nexport * from './isQpqIsoDateTime';\n"]}

package/lib/esm/utils/dateTime/isQpqIsoDateTime.d.ts

@@ -0,0 +1,3 @@
+import { QpqIsoDateTime } from '../../types/QpqIsoDateTime';
+/** Whether a value is a real instant in exactly the QpqIsoDateTime form (`2026-11-09T05:12:40.118Z`): the guard form of getValidQpqIsoDateTime. */
+export declare const isQpqIsoDateTime: (value: unknown) => value is QpqIsoDateTime;

package/lib/esm/utils/dateTime/isQpqIsoDateTime.js

@@ -0,0 +1,4 @@
+import { getValidQpqIsoDateTime } from './getValidQpqIsoDateTime';
+/** Whether a value is a real instant in exactly the QpqIsoDateTime form (`2026-11-09T05:12:40.118Z`): the guard form of getValidQpqIsoDateTime. */
+export const isQpqIsoDateTime = (value) => typeof value === 'string' && getValidQpqIsoDateTime(value) !== undefined;
+//# sourceMappingURL=isQpqIsoDateTime.js.map

package/lib/esm/utils/dateTime/isQpqIsoDateTime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isQpqIsoDateTime.js","sourceRoot":"","sources":["../../../../src/utils/dateTime/isQpqIsoDateTime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,mJAAmJ;AACnJ,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAA2B,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,sBAAsB,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC","sourcesContent":["import { QpqIsoDateTime } from '../../types/QpqIsoDateTime';\nimport { getValidQpqIsoDateTime } from './getValidQpqIsoDateTime';\n\n/** Whether a value is a real instant in exactly the QpqIsoDateTime form (`2026-11-09T05:12:40.118Z`): the guard form of getValidQpqIsoDateTime. */\nexport const isQpqIsoDateTime = (value: unknown): value is QpqIsoDateTime => typeof value === 'string' && getValidQpqIsoDateTime(value) !== undefined;\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qpqjs/core",
-  "version": "0.6.3",
+  "version": "0.7.0",
   "description": "Actions, stories and the runtime at the heart of quidproquo.",
   "main": "./lib/commonjs/index.js",
   "module": "./lib/esm/index.js",
@@ -45,8 +45,8 @@
   },
   "homepage": "https://github.com/qpqjs/quidproquo#readme",
   "devDependencies": {
-    "@qpqjs/testing": "0.6.3",
-    "@qpqjs/tsconfig": "0.6.3",
+    "@qpqjs/testing": "0.7.0",
+    "@qpqjs/tsconfig": "0.7.0",
     "@types/node": "^24.2.1",
     "typescript": "^5.8.2"
   },