ezship 0.1.12 → 0.1.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/commands.d.mts CHANGED
@@ -15,6 +15,10 @@ import type {
15
15
  ScheduleRun,
16
16
  AppLink,
17
17
  SupportRequest,
18
+ EmailFilter,
19
+ EmailStatus,
20
+ EmailInfo,
21
+ EmailRow,
18
22
  Integration,
19
23
  IntegrationCall,
20
24
  IntegrationInput,
@@ -37,6 +41,7 @@ import type {
37
41
  DeployResult,
38
42
  FormatResult,
39
43
  FunctionResult,
44
+ GlobalSinceDeploy,
40
45
  RenderRequest,
41
46
  RenderRow,
42
47
  InstanceInfo,
@@ -136,6 +141,9 @@ export interface Workspace {
136
141
  }): Promise<SupportRequest>;
137
142
  listSupportRequests(): Promise<SupportRequest[]>;
138
143
  supportRequest(id: string): Promise<SupportRequest>;
144
+ /** Emails server code sent (docs/adr/0149), newest first; a Limited Builder sees only their Sites'. */
145
+ listEmails(filter?: EmailFilter): Promise<EmailRow[]>;
146
+ emailInfo(id: string): Promise<EmailInfo>;
139
147
  /** Integrations (docs/adr/0092): every Builder lists; Admins set, preview and remove. */
140
148
  listIntegrations(): Promise<Integration[]>;
141
149
  setIntegration(name: string, input: IntegrationInput): Promise<Integration>;
@@ -353,6 +361,15 @@ export function parseSchedules(
353
361
  source: string,
354
362
  files: Record<string, string>,
355
363
  ): { entries: ScheduleEntry[]; errors: string[] };
364
+ /** The deployed page's settings (ADR 0148): `page.json` in a Site and in the Global Workspace, the Site's winning. */
365
+ export const PAGE_FILE: "page.json";
366
+ export const PAGE_ICON_MAX: 16000;
367
+ /** The browser icon of a page whose Site and Global Workspace set none. */
368
+ export const DEFAULT_PAGE_ICON: string;
369
+ /** The settings of a page.json, and every problem with it; page is empty when there is any. */
370
+ export function parsePage(source: string): { page: { icon?: string }; errors: string[] };
371
+ /** The SVG a Site's page shows as its browser icon: the Site's page.json, else the Global one, else the default. */
372
+ export function pageIcon(files: Record<string, string>, global: Record<string, string>): string;
356
373
  /** Listeners (docs/adr/0092): `listeners/<name>.ts`, named in `listeners.json`, received under LISTENER_BASE_PATH. */
357
374
  export const LISTENERS_DIR: "listeners/";
358
375
  export function listenerName(path: string): string | null;
@@ -391,7 +408,7 @@ export const CONSTANTS_FILE: "constants.ts";
391
408
  export const STYLE_FILE: "style.css";
392
409
  export const TYPES_FILE: "db/types.d.ts";
393
410
  export const DEFAULT_GLOBAL_FILES: Readonly<Record<string, string>>;
394
- /** The theme and seven components a new Instance's Global Workspace starts with (Version 0). */
411
+ /** The theme, Shell and components a new Instance's Global Workspace starts with (Version 0). */
395
412
  export const STARTER_GLOBAL_FILES: Readonly<Record<string, string>>;
396
413
  export const BUILD_ENTRY: "index.html";
397
414
  export const BUILD_CONFIG_MARKER: "<!--ez:config-->";
@@ -530,6 +547,18 @@ export const APP_LINK_TTL_MS: number;
530
547
  export const SUPPORT_SUBJECT_MAX: number;
531
548
  export const SUPPORT_BODY_MAX: number;
532
549
  export const SUPPORT_REQUESTS_PER_DAY: number;
550
+ /** Email limits (docs/adr/0149). */
551
+ export const EMAIL_LIMITS: Readonly<{
552
+ perInvocation: number;
553
+ subject: number;
554
+ body: number;
555
+ buttonLabel: number;
556
+ buttonHref: number;
557
+ perDay: number;
558
+ perMinute: number;
559
+ attempts: number;
560
+ }>;
561
+ export const EMAIL_STATUSES: readonly EmailStatus[];
533
562
  /** Integrations (docs/adr/0092): names, kinds, credential types, limits and the origin and name checks. */
534
563
  export const INTEGRATION_NAME_RE: RegExp;
535
564
  export const INTEGRATION_KINDS: readonly ["http"];
@@ -602,6 +631,21 @@ export const AUTH_PATH: string;
602
631
 
603
632
  export function hashContent(s: string): string;
604
633
  export function localChanges(files: Record<string, string>, pulled: Pulled | null): Changes;
634
+ /**
635
+ * Whether a change to this Global Workspace file reaches a deployed Site only at its next Preview or Deploy
636
+ * (docs/adr/0096): false for the Live-only files (session.ts, schedules.json, jobs/) and the files no app is
637
+ * built from (CONTEXT.md, docs/, the generated db/types.d.ts).
638
+ */
639
+ export function pinnedGlobalPath(path: string): boolean;
640
+ /**
641
+ * What the Site's next deploy brings in from the Global Workspace (`site` is its remoteStatus, `global` the
642
+ * Global Workspace): null when the Site has no recorded deploy or the Host does not say which Global Version
643
+ * it built in.
644
+ */
645
+ export function globalSinceDeploy(
646
+ site: WorkspaceInfo,
647
+ global: Workspace,
648
+ ): Promise<GlobalSinceDeploy | null>;
605
649
  export function countChanges(c: Changes): number;
606
650
  export function ago(at: number | null | undefined): string;
607
651