@dereekb/dbx-components-mcp 13.40.0 → 13.42.0

package/generated/dereekb-date.semantic-types.mcp.generated.json

@@ -72,6 +72,136 @@
       ],
       "notes": "The week in the year. Starts from 1."
     },
+    {
+      "name": "ICalendarComponentName",
+      "package": "@dereekb/date",
+      "module": "src/lib/icalendar/icalendar",
+      "kind": "semantic-type",
+      "definition": "SuggestedString<'VCALENDAR' | 'VEVENT' | 'VALARM' | 'VTIMEZONE' | 'STANDARD' | 'DAYLIGHT'>",
+      "baseType": "other",
+      "topics": [
+        "string",
+        "dereekb-date:icalendar"
+      ],
+      "notes": "The name of an iCalendar component. I.E. VCALENDAR, VEVENT, VALARM, VTIMEZONE, STANDARD, DAYLIGHT.\n\nhttps://datatracker.ietf.org/doc/html/rfc5545#section-3.6"
+    },
+    {
+      "name": "ICalendarPropertyName",
+      "package": "@dereekb/date",
+      "module": "src/lib/icalendar/icalendar",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "string",
+        "dereekb-date:icalendar"
+      ],
+      "notes": "The name of an iCalendar property. I.E. DTSTART, SUMMARY, X-WR-CALNAME.\n\nhttps://datatracker.ietf.org/doc/html/rfc5545#section-3.7"
+    },
+    {
+      "name": "ICalendarParameterName",
+      "package": "@dereekb/date",
+      "module": "src/lib/icalendar/icalendar",
+      "kind": "semantic-type",
+      "definition": "SuggestedString<'TZID' | 'VALUE' | 'CN' | 'ROLE' | 'PARTSTAT' | 'RSVP' | 'RELATED'>",
+      "baseType": "other",
+      "topics": [
+        "string",
+        "dereekb-date:icalendar"
+      ],
+      "notes": "The name of an iCalendar property parameter. I.E. TZID, VALUE, CN.\n\nhttps://datatracker.ietf.org/doc/html/rfc5545#section-3.2"
+    },
+    {
+      "name": "ICalendarParameterValue",
+      "package": "@dereekb/date",
+      "module": "src/lib/icalendar/icalendar",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "string",
+        "dereekb-date:icalendar"
+      ],
+      "notes": "An already-encoded iCalendar property parameter value."
+    },
+    {
+      "name": "ICalendarValue",
+      "package": "@dereekb/date",
+      "module": "src/lib/icalendar/icalendar",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "string",
+        "dereekb-date:icalendar"
+      ],
+      "notes": "An already-encoded iCalendar property value. Escaping (where the value type calls for it) has already been applied."
+    },
+    {
+      "name": "ICalendarTextValue",
+      "package": "@dereekb/date",
+      "module": "src/lib/icalendar/icalendar",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "string",
+        "dereekb-date:icalendar"
+      ],
+      "notes": "An escaped iCalendar TEXT value.\n\nhttps://datatracker.ietf.org/doc/html/rfc5545#section-3.3.11"
+    },
+    {
+      "name": "ICalendarIcsString",
+      "package": "@dereekb/date",
+      "module": "src/lib/icalendar/icalendar",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "string",
+        "dereekb-date:icalendar"
+      ],
+      "notes": "A complete iCalendar (RFC 5545) document, folded and CRLF-terminated."
+    },
+    {
+      "name": "ICalendarUid",
+      "package": "@dereekb/date",
+      "module": "src/lib/icalendar/icalendar",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "string",
+        "dereekb-date:icalendar"
+      ],
+      "notes": "A globally-unique, stable identifier for an event.\n\nhttps://datatracker.ietf.org/doc/html/rfc5545#section-3.8.4.7\n\nStability across publishes is what lets a subscribing client correlate an update or a deletion with the\nevent it already has. A UID that changes between publishes produces a duplicate event instead of an update."
+    },
+    {
+      "name": "ICalendarProductId",
+      "package": "@dereekb/date",
+      "module": "src/lib/icalendar/icalendar",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "string",
+        "dereekb-date:icalendar"
+      ],
+      "notes": "The PRODID of the product that generated the calendar.\n\nhttps://datatracker.ietf.org/doc/html/rfc5545#section-3.7.3"
+    },
+    {
+      "name": "ICalendarCalAddress",
+      "package": "@dereekb/date",
+      "module": "src/lib/icalendar/icalendar",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "string",
+        "dereekb-date:icalendar"
+      ],
+      "notes": "A CAL-ADDRESS URI value. I.E. \"mailto:person@example.com\".\n\nhttps://datatracker.ietf.org/doc/html/rfc5545#section-3.3.3"
+    },
     {
       "name": "RRuleLineString",
       "package": "@dereekb/date",

package/generated/dereekb-firebase.semantic-types.mcp.generated.json

@@ -131,6 +131,20 @@
       ],
       "notes": "Storage bucket identifier for Firebase Cloud Storage.\n\nShould contain no slashes — just the bucket name (e.g., `\"my-app.appspot.com\"`)."
     },
+    {
+      "name": "StoragePublicUrlApiEndpoint",
+      "package": "@dereekb/firebase",
+      "module": "src/lib/common/storage/storage.url",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "url",
+        "string",
+        "dereekb-firebase:storage"
+      ],
+      "notes": "Origin (protocol and host, with no trailing slash) that serves GCS-native public object urls."
+    },
     {
       "name": "StorageDownloadUrl",
       "package": "@dereekb/firebase",
@@ -214,6 +228,48 @@
       ],
       "notes": "Example:\n'data:text/plain;base64,5b6p5Y+344GX44G+44GX44Gf77yB44GK44KB44Gn44Go44GG77yB'"
     },
+    {
+      "name": "CalendarEventId",
+      "package": "@dereekb/firebase",
+      "module": "src/lib/model/calendar/calendar.id",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "identifier",
+        "string",
+        "dereekb-firebase:calendar"
+      ],
+      "notes": "Identifier for a single event embedded in a Calendar. Unique within its own calendar only."
+    },
+    {
+      "name": "CalendarOccurrenceKey",
+      "package": "@dereekb/firebase",
+      "module": "src/lib/model/calendar/calendar.id",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "identifier",
+        "string",
+        "dereekb-firebase:calendar"
+      ],
+      "notes": "Identifier for a single expanded OCCURRENCE of a calendar event.\n\nA one-off event's occurrence key is its {@link CalendarEventId}. A recurring event's occurrence key is\nits id plus the occurrence's unix seconds, which is what keeps a published VEVENT's UID stable across\nrepublishes of the same series."
+    },
+    {
+      "name": "CalendarType",
+      "package": "@dereekb/firebase",
+      "module": "src/lib/model/calendar/calendar.id",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "identifier",
+        "string",
+        "dereekb-firebase:calendar"
+      ],
+      "notes": "Arbitrary string describing the kind of calendar a document is, driving its retention policy and its ICS\nemission config through the app's {@link CalendarTypeConfig} registry.\n\nOpen by design, exactly like {@link StorageFilePurpose}: a downstream app registers its own types without\na library change."
+    },
     {
       "name": "NotificationTemplateType",
       "package": "@dereekb/firebase",

package/generated/dereekb-firebase.utils.mcp.generated.json

@@ -263,6 +263,136 @@
         "firebase-auth-oob-code-data-pair-delimiter"
       ]
     },
+    {
+      "slug": "is-nth-hour-of-day",
+      "name": "isNthHourOfDay",
+      "kind": "function",
+      "category": "date",
+      "module": "@dereekb/firebase",
+      "subpath": "model/system/system.scheduler",
+      "signature": "isNthHourOfDay(everyNHours: Hours, date?: Maybe<Date>): boolean",
+      "description": "Whether the date's hour-of-day is an Nth hour, in the ambient timezone.\n\nThis is a modulo against the hour-of-day, NOT an interval since some epoch — so at hour 12 it is\ntrue for N = 1, 2, 3, 4, 6, and 12, and false for N = 5. Only divisors of 24 divide the day\nevenly; a non-divisor (5, 7, 9, …) will still fire, just with a short window across midnight.\n\nAn `everyNHours` of zero or less has no meaningful Nth hour and returns false rather than\ndividing by zero.",
+      "params": [
+        {
+          "name": "everyNHours",
+          "type": "Hours",
+          "description": "- Run every Nth hour of the day.",
+          "optional": false
+        },
+        {
+          "name": "date",
+          "type": "Maybe<Date>",
+          "description": "- Moment to test; defaults to now.",
+          "optional": true
+        }
+      ],
+      "returns": "True when the date's hour-of-day is an Nth hour.",
+      "tags": [
+        "schedule",
+        "hour",
+        "throttle",
+        "cron",
+        "gate",
+        "modulo",
+        "date",
+        "is",
+        "nth",
+        "of",
+        "day",
+        "isnthhourofday"
+      ],
+      "example": "isNthHourOfDay(3, new Date('2024-01-01T12:30:00')); // true (12 % 3 === 0)\nisNthHourOfDay(5, new Date('2024-01-01T12:30:00')); // false (12 % 5 === 2)",
+      "relatedSlugs": [
+        "has-run-in-current-hour"
+      ]
+    },
+    {
+      "slug": "has-run-in-current-hour",
+      "name": "hasRunInCurrentHour",
+      "kind": "function",
+      "category": "date",
+      "module": "@dereekb/firebase",
+      "subpath": "model/system/system.scheduler",
+      "signature": "hasRunInCurrentHour(lastRunAt: Maybe<Date>, now?: Maybe<Date>): boolean",
+      "description": "Whether the last run falls inside the same hour as now.\n\nThis is a same-hour-bucket compare, not an elapsed-time compare: a run at 12:59 and a `now` of\n13:01 are two minutes apart but in different hours, so this returns false. That is what makes the\ngate track the hourly cron rather than drift with it.\n\nA null `lastRunAt` means nothing has run, so it returns false.",
+      "params": [
+        {
+          "name": "lastRunAt",
+          "type": "Maybe<Date>",
+          "description": "- Moment the work last ran.",
+          "optional": false
+        },
+        {
+          "name": "now",
+          "type": "Maybe<Date>",
+          "description": "- Moment to compare against; defaults to now.",
+          "optional": true
+        }
+      ],
+      "returns": "True when both moments fall in the same hour.",
+      "tags": [
+        "schedule",
+        "hour",
+        "throttle",
+        "cron",
+        "gate",
+        "window",
+        "date",
+        "has",
+        "run",
+        "in",
+        "current",
+        "hasrunincurrenthour"
+      ],
+      "example": "hasRunInCurrentHour(new Date('2024-01-01T12:05:00'), new Date('2024-01-01T12:55:00')); // true\nhasRunInCurrentHour(new Date('2024-01-01T12:59:00'), new Date('2024-01-01T13:01:00')); // false",
+      "relatedSlugs": [
+        "is-nth-hour-of-day",
+        "round-down-to-hour"
+      ]
+    },
+    {
+      "slug": "nth-hour-of-day-index",
+      "name": "nthHourOfDayIndex",
+      "kind": "function",
+      "category": "date",
+      "module": "@dereekb/firebase",
+      "subpath": "model/system/system.scheduler",
+      "signature": "nthHourOfDayIndex(everyNHours: Hours, date?: Maybe<Date>): Maybe<number>",
+      "description": "The zero-based index of the date's hour within the day's every-N-hours schedule, or null when the\nhour is not an Nth hour.\n\nAt hour 12 with N=3 the day's matching hours are 0, 3, 6, 9, 12 — so the index is 4. Use it to\nrotate work across a day's windows (\"do the expensive pass only on index 0\") without each caller\nre-deriving the arithmetic from the hour-of-day.\n\nReturns null rather than a number for a non-matching hour, so a falsy check cannot confuse\n\"index 0\" — the first window of the day — with \"no window\".",
+      "params": [
+        {
+          "name": "everyNHours",
+          "type": "Hours",
+          "description": "- Run every Nth hour of the day.",
+          "optional": false
+        },
+        {
+          "name": "date",
+          "type": "Maybe<Date>",
+          "description": "- Moment to test; defaults to now.",
+          "optional": true
+        }
+      ],
+      "returns": "The zero-based window index, or null when the hour is not an Nth hour.",
+      "tags": [
+        "schedule",
+        "hour",
+        "throttle",
+        "cron",
+        "gate",
+        "index",
+        "window",
+        "date",
+        "nth",
+        "of",
+        "day",
+        "nthhourofdayindex"
+      ],
+      "example": "nthHourOfDayIndex(3, new Date('2024-01-01T12:30:00')); // 4 (0, 3, 6, 9, 12)\nnthHourOfDayIndex(3, new Date('2024-01-01T13:30:00')); // null (13 % 3 !== 0)",
+      "relatedSlugs": [
+        "is-nth-hour-of-day"
+      ]
+    },
     {
       "slug": "new-documents",
       "name": "newDocuments",

package/generated/dereekb-util.semantic-types.mcp.generated.json

@@ -489,6 +489,19 @@
       ],
       "notes": "The minute of the day.\n\nNumber from 0-1439."
     },
+    {
+      "name": "UtcOffsetString",
+      "package": "@dereekb/util",
+      "module": "src/lib/date/offset",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "timezone",
+        "string"
+      ],
+      "notes": "A UTC offset rendered in the ISO 8601 basic format, as a sign followed by two-digit hours and minutes.\n\nExamples:\n- -0600\n- +0530\n- +0000"
+    },
     {
       "name": "EncryptedString",
       "package": "@dereekb/util",
@@ -1340,6 +1353,19 @@
       ],
       "notes": "A website's domain and path combined, without the BaseWebsiteUrl\n\nExamples:\n- dereekb.com\n- components.dereekb.com/\n- components.dereekb.com/doc/home"
     },
+    {
+      "name": "UriScheme",
+      "package": "@dereekb/util",
+      "module": "src/lib/string/url",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "url",
+        "string"
+      ],
+      "notes": "A URI scheme, without the trailing colon.\n\nExamples:\n- https\n- mailto\n- tel"
+    },
     {
       "name": "CityString",
       "package": "@dereekb/util",

package/generated/dereekb-util.utils.mcp.generated.json

@@ -3817,6 +3817,32 @@
         "seconds-in-minute"
       ]
     },
+    {
+      "slug": "minutes-in-year",
+      "name": "MINUTES_IN_YEAR",
+      "kind": "const",
+      "category": "date",
+      "module": "@dereekb/util",
+      "subpath": "date/date",
+      "signature": "const MINUTES_IN_YEAR: Minutes",
+      "description": "Number of minutes in a year (ignoring leap years).",
+      "params": [],
+      "returns": "Minutes",
+      "tags": [
+        "date",
+        "minute",
+        "year",
+        "duration",
+        "constant",
+        "minutes",
+        "in",
+        "minutes_in_year"
+      ],
+      "relatedSlugs": [
+        "minutes-in-day",
+        "days-in-year"
+      ]
+    },
     {
       "slug": "seconds-in-hour",
       "name": "SECONDS_IN_HOUR",
@@ -4712,6 +4738,38 @@
         "check-atleast-one-not-expired"
       ]
     },
+    {
+      "slug": "utc-offset-string",
+      "name": "utcOffsetString",
+      "kind": "function",
+      "category": "date",
+      "module": "@dereekb/util",
+      "subpath": "date/offset",
+      "signature": "utcOffsetString(minutes: Minutes): UtcOffsetString",
+      "description": "Formats a UTC offset in minutes as a {@link UtcOffsetString}. I.E. \"-0600\", \"+0530\".\n\nThis is the ISO 8601 basic-format offset, which is also the format RFC 5545 3.3.14 defines for a UTC-OFFSET\nvalue. A zero offset renders as \"+0000\".",
+      "params": [
+        {
+          "name": "minutes",
+          "type": "Minutes",
+          "description": "- The offset from UTC in minutes. Negative is west of UTC.",
+          "optional": false
+        }
+      ],
+      "returns": "The UTC offset string.",
+      "tags": [
+        "date",
+        "timezone",
+        "utc",
+        "offset",
+        "string",
+        "format",
+        "utcoffsetstring"
+      ],
+      "relatedSlugs": [
+        "utc-timezone-string",
+        "has-same-timezone"
+      ]
+    },
     {
       "slug": "make-timer",
       "name": "makeTimer",
@@ -11851,6 +11909,73 @@
         "flatten-whitespace"
       ]
     },
+    {
+      "slug": "normalize-line-breaks",
+      "name": "normalizeLineBreaks",
+      "kind": "function",
+      "category": "string",
+      "module": "@dereekb/util",
+      "subpath": "string/string",
+      "signature": "normalizeLineBreaks(input: string): string",
+      "description": "Normalizes every CRLF and bare CR line break in the input to a single LF.\n\nUseful ahead of any per-character transform, which would otherwise treat a single CRLF as two line breaks.",
+      "params": [
+        {
+          "name": "input",
+          "type": "string",
+          "description": "- String to normalize.",
+          "optional": false
+        }
+      ],
+      "returns": "The string with all line breaks rendered as LF.",
+      "tags": [
+        "string",
+        "whitespace",
+        "newline",
+        "line-break",
+        "normalize",
+        "crlf",
+        "line",
+        "breaks",
+        "normalizelinebreaks"
+      ],
+      "relatedSlugs": [
+        "simplify-whitespace",
+        "flatten-whitespace"
+      ]
+    },
+    {
+      "slug": "is-not-blank-string",
+      "name": "isNotBlankString",
+      "kind": "function",
+      "category": "string",
+      "module": "@dereekb/util",
+      "subpath": "string/string",
+      "signature": "isNotBlankString(input: Maybe<string>): input is string",
+      "description": "Returns true if the input is a string with at least one non-whitespace character.\n\nUseful for deciding whether an optional string value is worth emitting.",
+      "params": [
+        {
+          "name": "input",
+          "type": "Maybe<string>",
+          "description": "- The value to test.",
+          "optional": false
+        }
+      ],
+      "returns": "Whether the value is a non-blank string.",
+      "tags": [
+        "string",
+        "whitespace",
+        "blank",
+        "empty",
+        "predicate",
+        "type-guard",
+        "is",
+        "not",
+        "isnotblankstring"
+      ],
+      "relatedSlugs": [
+        "flatten-whitespace"
+      ]
+    },
     {
       "slug": "string-trim-function",
       "name": "stringTrimFunction",
@@ -12179,6 +12304,71 @@
         "fix-extra-query-parameters"
       ]
     },
+    {
+      "slug": "has-uri-scheme",
+      "name": "hasUriScheme",
+      "kind": "function",
+      "category": "string",
+      "module": "@dereekb/util",
+      "subpath": "string/url",
+      "signature": "hasUriScheme(input: string): boolean",
+      "description": "Returns true if the input carries a URI scheme prefix.\n\nExamples where it will return true:\n- mailto:hello@dereekb.com\n- tel:+15550100\n- https://dereekb.com",
+      "params": [
+        {
+          "name": "input",
+          "type": "string",
+          "description": "- The string to check.",
+          "optional": false
+        }
+      ],
+      "returns": "Whether the input starts with a URI scheme.",
+      "tags": [
+        "string",
+        "url",
+        "uri",
+        "scheme",
+        "protocol",
+        "predicate",
+        "has",
+        "hasurischeme"
+      ],
+      "relatedSlugs": [
+        "read-uri-scheme",
+        "read-website-protocol"
+      ]
+    },
+    {
+      "slug": "read-uri-scheme",
+      "name": "readUriScheme",
+      "kind": "function",
+      "category": "string",
+      "module": "@dereekb/util",
+      "subpath": "string/url",
+      "signature": "readUriScheme(input: string): Maybe<UriScheme>",
+      "description": "Reads the URI scheme from the input string, if one exists. Does not include the trailing colon.",
+      "params": [
+        {
+          "name": "input",
+          "type": "string",
+          "description": "- The URI string to extract the scheme from.",
+          "optional": false
+        }
+      ],
+      "returns": "The scheme (e.g. `\"mailto\"`), or `undefined` if the input carries no scheme.",
+      "tags": [
+        "string",
+        "url",
+        "uri",
+        "scheme",
+        "protocol",
+        "read",
+        "readurischeme"
+      ],
+      "relatedSlugs": [
+        "has-uri-scheme",
+        "read-website-protocol"
+      ]
+    },
     {
       "slug": "expand-flatten-tree-function",
       "name": "expandFlattenTreeFunction",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/dbx-components-mcp",
-  "version": "13.40.0",
+  "version": "13.42.0",
   "type": "module",
   "bin": {
     "dbx-components-mcp": "dbx-components-mcp.js"
@@ -11,7 +11,7 @@
     "ts-morph": "^21.0.0"
   },
   "peerDependencies": {
-    "@dereekb/dbx-cli": "13.40.0",
-    "@dereekb/util": "13.40.0"
+    "@dereekb/dbx-cli": "13.42.0",
+    "@dereekb/util": "13.42.0"
   }
 }