@camstack/types 1.2.362 → 1.2.364

package/dist/capabilities/backup.cap.d.ts

@@ -619,6 +619,20 @@ export declare const backupCapability: {
             lastError: z.ZodOptional<z.ZodString>;
             nextRunAt: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * The database files that exist on this hub right now (the owner's open
+         * files), so the selection UI can offer all of them and mark a file that
+         * is not created yet. `answered: false` = the owner did not answer, which
+         * is not the same as "none exist".
+         */
+        readonly listAvailableDatabases: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
+            answered: z.ZodBoolean;
+            databases: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+                events: "events";
+                history: "history";
+                settings: "settings";
+            }>>>;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
         /**
          * Create or replace a schedule. An empty / absent `id` mints a new
          * one; a present `id` replaces in place. `cron` is validated

package/dist/capabilities/calendar-source.cap.d.ts

@@ -24,6 +24,18 @@ export declare const CalendarInfoSchema: z.ZodObject<{
     enabled: z.ZodBoolean;
 }, z.core.$strip>;
 export type CalendarInfo = z.infer<typeof CalendarInfoSchema>;
+/**
+ * Time contract of {@link CalendarEvent}.
+ *
+ * - Timed event: `startMs` / `endMs` are real instants; `endMs` is exclusive.
+ * - All-day event (`allDay: true`): the event is a run of calendar DATES, not
+ *   instants. `startMs` is UTC midnight of the first date and `endMs` is UTC
+ *   midnight of the day AFTER the last date (RFC 5545 exclusive DTEND), so a
+ *   one-day event spans exactly 24 h. Every provider produces that and no
+ *   consumer may read the instants in a local timezone: use
+ *   {@link calendarEventLocalSpan}. Reading UTC midnight as local time put an
+ *   all-day event on the following day for any viewer ahead of UTC.
+ */
 export declare const CalendarEventSchema: z.ZodObject<{
     id: z.ZodString;
     calendarId: z.ZodString;
@@ -74,3 +86,17 @@ export declare const calendarSourceCapability: {
     };
 };
 export type ICalendarSourceProvider = InferProvider<typeof calendarSourceCapability>;
+/** A half-open `[startMs, endMs)` interval of local instants. */
+export interface CalendarLocalSpan {
+    readonly startMs: number;
+    readonly endMs: number;
+}
+/**
+ * The interval an event occupies on the viewer's local clock, end exclusive.
+ * A timed event is returned as is; an all-day event's UTC dates are re-read as
+ * local calendar dates (local midnight to local midnight, DST-safe). A
+ * degenerate all-day end (`<=` start) is widened to one day.
+ */
+export declare function calendarEventLocalSpan(ev: Pick<CalendarEvent, 'startMs' | 'endMs' | 'allDay'>): CalendarLocalSpan;
+/** Does the event touch the local calendar day starting at `dayStartMs`? */
+export declare function calendarEventOnLocalDay(ev: Pick<CalendarEvent, 'startMs' | 'endMs' | 'allDay'>, dayStartMs: number): boolean;