@superpanel-sdk/runtime 0.2.3 → 0.5.0

package/dist/core/page/time-format.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Times as people read them, in a time zone (25 §11). The page's sandbox has no `Intl` (a date's
+ * `toLocaleString` ignores the zone there), so a page formats through the platform (`ctx.time.format`),
+ * which runs this; a function, on the Worker, calls it as it is (`ctx.time.format`).
+ */
+/** How much of the time to show: `'datetime'` (default) "Tue, Nov 3, 3:00 PM EST", `'date'` "Tue, Nov 3, 2026", `'time'` "3:00 PM EST". */
+export type TimeStyle = 'datetime' | 'date' | 'time';
+export type FormatTimeOptions = {
+    timeZone: string;
+    style?: TimeStyle;
+};
+/** `at` (ISO 8601, or epoch ms) in `timeZone`, in US English. Throws on a time or zone it cannot read. */
+export declare function formatTime(at: string | number, options: FormatTimeOptions): string;
+/**
+ * The calendar day (`YYYY-MM-DD`) at `at` in `timeZone`: `ctx.time.day` (25 §11), to compare days or
+ * key a rule by date. Throws on a time or zone it cannot read.
+ */
+export declare function dayIn(at: string | number | Date, timeZone: string): string;
+//# sourceMappingURL=time-format.d.ts.map

package/dist/core/page/time-format.js

@@ -0,0 +1,41 @@
+/**
+ * Times as people read them, in a time zone (25 §11). The page's sandbox has no `Intl` (a date's
+ * `toLocaleString` ignores the zone there), so a page formats through the platform (`ctx.time.format`),
+ * which runs this; a function, on the Worker, calls it as it is (`ctx.time.format`).
+ */
+const STYLES = {
+    datetime: { weekday: 'short', month: 'short', day: 'numeric', hour: 'numeric', minute: '2-digit', timeZoneName: 'short' },
+    date: { weekday: 'short', month: 'short', day: 'numeric', year: 'numeric' },
+    time: { hour: 'numeric', minute: '2-digit', timeZoneName: 'short' },
+};
+/** `at` (ISO 8601, or epoch ms) in `timeZone`, in US English. Throws on a time or zone it cannot read. */
+export function formatTime(at, options) {
+    const date = new Date(at);
+    if (Number.isNaN(date.getTime()))
+        throw new Error(`time.format: ${String(at)} is not a time`);
+    const style = options.style ?? 'datetime';
+    if (!(style in STYLES))
+        throw new Error(`time.format: style is 'datetime', 'date' or 'time'`);
+    try {
+        return new Intl.DateTimeFormat('en-US', { ...STYLES[style], timeZone: options.timeZone }).format(date);
+    }
+    catch {
+        throw new Error(`time.format: ${options.timeZone} is not a time zone`);
+    }
+}
+/**
+ * The calendar day (`YYYY-MM-DD`) at `at` in `timeZone`: `ctx.time.day` (25 §11), to compare days or
+ * key a rule by date. Throws on a time or zone it cannot read.
+ */
+export function dayIn(at, timeZone) {
+    const date = new Date(at);
+    if (Number.isNaN(date.getTime()))
+        throw new Error(`time.day: ${String(at)} is not a time`);
+    try {
+        return new Intl.DateTimeFormat('en-CA', { timeZone, year: 'numeric', month: '2-digit', day: '2-digit' }).format(date);
+    }
+    catch {
+        throw new Error(`time.day: ${timeZone} is not a time zone`);
+    }
+}
+//# sourceMappingURL=time-format.js.map

package/dist/core/page/timeline.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The case's timeline (20 §3, 21 §11.6): everything that happened on one instance, merged and in time
+ * order — messages, calls, the AI's runs and what they did, field changes, scheduled contacts, the
+ * Orchestrator. One shape for every source, so a page, the web and a prompt read it the same way.
+ */
+export type TimelineKind = 'message' | 'call' | 'run' | 'action' | 'write' | 'scheduled' | 'orchestrator';
+export declare const TIMELINE_KINDS: readonly TimelineKind[];
+export type TimelineEntry = {
+    /** The source row's id. */
+    id: string;
+    kind: TimelineKind;
+    /** ISO time it happened (a message's time, a call's start, a run's start, a write). */
+    at: string;
+    channel: 'call' | 'sms' | 'email' | 'event' | null;
+    direction?: 'inbound' | 'outbound';
+    contactId: string | null;
+    /** One line: what happened, as a person would read it. */
+    text: string;
+    /** A message's body. */
+    body?: string;
+    subject?: string | null;
+    status?: string;
+    /** The text or email run it belongs to (a message it answered, an action it ran). */
+    runId?: string | null;
+    /** Where this entry is in the order: pass it as `before` for what comes before it (the next page). */
+    cursor: string;
+};
+/**
+ * What a timeline read may narrow to. `before`: an entry's `cursor` — the entries after it in the order
+ * (older, or as old and further along), so equal times are never skipped or read twice; or an ISO time.
+ */
+export type TimelineWhere = {
+    kinds?: TimelineKind[];
+    channel?: 'call' | 'sms' | 'email';
+    contactId?: string;
+    before?: string;
+    /** Default 50, at most 200. */
+    limit?: number;
+};
+//# sourceMappingURL=timeline.d.ts.map

package/dist/core/page/timeline.js

@@ -0,0 +1,2 @@
+export const TIMELINE_KINDS = ['message', 'call', 'run', 'action', 'write', 'scheduled', 'orchestrator'];
+//# sourceMappingURL=timeline.js.map