@powerhousedao/shared 6.2.2-dev.10 → 6.2.2-dev.11

package/dist/clis/constants.d.mts

@@ -1,52 +1,5 @@
 import { z } from "zod";
 
-//#region document-model/schemas.d.ts
-declare const ManifestSchema: z.ZodObject<{
-  name: z.ZodString;
-  description: z.ZodOptional<z.ZodString>;
-  category: z.ZodOptional<z.ZodString>;
-  image: z.ZodOptional<z.ZodString>;
-  publisher: z.ZodOptional<z.ZodObject<{
-    name: z.ZodOptional<z.ZodString>;
-    url: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>>;
-  documentModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    id: z.ZodString;
-    name: z.ZodString;
-    documentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  }, z.core.$strip>>>;
-  apps: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    id: z.ZodString;
-    name: z.ZodString;
-    documentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  }, z.core.$strip>>>;
-  editors: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    id: z.ZodString;
-    name: z.ZodString;
-    documentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  }, z.core.$strip>>>;
-  processors: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    id: z.ZodString;
-    name: z.ZodString;
-    documentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  }, z.core.$strip>>>;
-  subgraphs: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    id: z.ZodString;
-    name: z.ZodString;
-    documentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  }, z.core.$strip>>>;
-  config: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    name: z.ZodString;
-    type: z.ZodUnion<readonly [z.ZodLiteral<"var">, z.ZodLiteral<"secret">]>;
-    description: z.ZodOptional<z.ZodString>;
-    required: z.ZodOptional<z.ZodBoolean>;
-    default: z.ZodOptional<z.ZodBoolean>;
-  }, z.core.$strip>>>;
-}, z.core.$strip>;
-//#endregion
-//#region document-model/types.d.ts
-type Manifest = z.infer<typeof ManifestSchema>;
-//#endregion
 //#region clis/types.d.ts
 type DrivePreserveStrategies = typeof DRIVES_PRESERVE_STRATEGIES;
 type DrivePreserveStrategy = DrivePreserveStrategies[number];
@@ -108,6 +61,95 @@ type PHConnectInstance = {
   namespace: string | null;
   reactorWorker: boolean;
 };
+/**
+ * A URL-matching pattern for a service-worker runtime-caching rule, in
+ * JSON-serialisable form. A plain string is handed to Workbox verbatim (exact
+ * URL or same-origin path match). `{ source, flags }` is reconstructed into a
+ * `RegExp` at build time — use it for prefix/suffix/origin matches (e.g.
+ * `{ source: "^https://api\\.acme\\.io/" }`). Function-valued patterns aren't
+ * expressible here; regex covers the realistic package cases.
+ */
+type PHConnectPwaUrlPattern = string | {
+  source: string;
+  flags?: string;
+};
+type PHConnectPwaCacheStrategy = "CacheFirst" | "CacheOnly" | "NetworkFirst" | "NetworkOnly" | "StaleWhileRevalidate";
+/** Serialisable subset of a Workbox `RuntimeCaching` rule. */
+type PHConnectPwaRuntimeCaching = {
+  urlPattern: PHConnectPwaUrlPattern;
+  handler: PHConnectPwaCacheStrategy;
+  method?: "GET" | "POST" | "PUT" | "DELETE" | "HEAD" | "PATCH";
+  options?: {
+    cacheName?: string;
+    /** Seconds a NetworkFirst rule waits for the network before falling back
+     * to the cache. */
+    networkTimeoutSeconds?: number;
+    expiration?: {
+      maxEntries?: number;
+      maxAgeSeconds?: number;
+    };
+    cacheableResponse?: {
+      statuses?: number[];
+      headers?: Record<string, string>;
+    };
+  };
+};
+type PHConnectPwaIcon = {
+  src: string;
+  sizes?: string;
+  type?: string;
+  purpose?: string;
+};
+/**
+ * A File Handling API entry a package or project contributes: the OS-level
+ * file types the installed Connect PWA offers to open. There is deliberately
+ * no `action` field — consuming launched files requires runtime code that
+ * lives in Connect itself, so every handler (built-in or contributed) opens
+ * at Connect's app root, injected at build time.
+ */
+type PHConnectPwaFileHandler = {
+  /** MIME type → file extensions (each must start with "."). */accept: Record<string, string[]>; /** OS-level file-type icons. */
+  icons?: PHConnectPwaIcon[];
+  launch_type?: "single-client" | "multiple-clients";
+};
+/** Web-app-manifest fields a package or project may override. */
+type PHConnectPwaManifest = {
+  name?: string;
+  short_name?: string;
+  description?: string;
+  theme_color?: string;
+  background_color?: string;
+  display?: "fullscreen" | "standalone" | "minimal-ui" | "browser";
+  start_url?: string;
+  scope?: string;
+  icons?: PHConnectPwaIcon[]; /** Extra file associations, appended after Connect's built-in `.phd`/`.phdm` handler. */
+  file_handlers?: PHConnectPwaFileHandler[]; /** How the OS launches the app for handled files/links. */
+  launch_handler?: {
+    client_mode: "auto" | "focus-existing" | "navigate-existing" | "navigate-new";
+  };
+  /** App-store-style categories. NOT authored under `connect.pwa` — derived at
+   * build/runtime from the `category` field of every contributing
+   * `powerhouse.manifest.json` (project + packages), unioned across them. */
+  categories?: string[];
+};
+/**
+ * PWA / service-worker overrides contributed by a package or the project.
+ * Layered on top of Connect's hardcoded PWA defaults at build time. Scalar
+ * fields deep-merge (later layer wins); every array member — the manifest
+ * arrays (`icons`, `file_handlers`, and the derived `categories`) plus the
+ * top-level `globPatterns`, `globIgnores`, `runtimeCaching` and
+ * `navigateFallbackDenylist` — is additive (concatenated/unioned);
+ * `maximumFileSizeToCacheInBytes` takes the max across contributors.
+ * Precedence: defaults < package fragments < project config.
+ */
+type PHConnectPwa = {
+  manifest?: PHConnectPwaManifest; /** Extra Workbox precache globs, unioned with the built-in patterns. */
+  globPatterns?: string[]; /** Extra Workbox precache ignore globs, unioned with the built-in list. */
+  globIgnores?: string[]; /** Raise the precache file-size ceiling; the max across contributors wins. */
+  maximumFileSizeToCacheInBytes?: number; /** Additional runtime-caching rules, appended after the built-in rules. */
+  runtimeCaching?: PHConnectPwaRuntimeCaching[]; /** Extra SPA-fallback denylist patterns, unioned with the built-in list. */
+  navigateFallbackDenylist?: PHConnectPwaUrlPattern[];
+};
 type PHConnectRuntimeConfig = {
   branding?: PHConnectBranding;
   app?: PHConnectApp;
@@ -116,6 +158,7 @@ type PHConnectRuntimeConfig = {
   renown?: PHConnectRenown;
   sentry?: PHConnectSentry;
   instance?: PHConnectInstance;
+  pwa?: PHConnectPwa;
 };
 type PowerhouseConfig = {
   logLevel: LogLevel;
@@ -164,6 +207,54 @@ type PowerhouseConfig = {
   connect?: PHConnectRuntimeConfig;
 };
 //#endregion
+//#region document-model/schemas.d.ts
+declare const ManifestSchema: z.ZodObject<{
+  name: z.ZodString;
+  description: z.ZodOptional<z.ZodString>;
+  category: z.ZodOptional<z.ZodString>;
+  image: z.ZodOptional<z.ZodString>;
+  publisher: z.ZodOptional<z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  documentModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    documentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>>;
+  apps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    documentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>>;
+  editors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    documentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>>;
+  processors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    documentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>>;
+  subgraphs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    documentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>>;
+  config: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodUnion<readonly [z.ZodLiteral<"var">, z.ZodLiteral<"secret">]>;
+    description: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strip>>>;
+  pwa: z.ZodOptional<z.ZodType<PHConnectPwa, unknown, z.core.$ZodTypeInternals<PHConnectPwa, unknown>>>;
+}, z.core.$strip>;
+//#endregion
+//#region document-model/types.d.ts
+type Manifest = z.infer<typeof ManifestSchema>;
+//#endregion
 //#region clis/constants.d.ts
 declare const SERVICE_ACTIONS: readonly ["start", "stop", "status", "setup", "restart"];
 declare const SECONDS_IN_DAY: number;

package/dist/clis/constants.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.mts","names":[],"sources":["../../document-model/schemas.ts","../../document-model/types.ts","../../clis/types.ts","../../clis/constants.ts"],"mappings":"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"}
+{"version":3,"file":"constants.d.mts","names":[],"sources":["../../clis/types.ts","../../document-model/schemas.ts","../../document-model/types.ts","../../clis/constants.ts"],"mappings":"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"}