ink-framework-lightos 0.1.0-alpha.12 → 0.1.0-alpha.13

package/ink-native.json

@@ -9,6 +9,12 @@
     ],
     "src/push.ts": [
       "light-sdk-push"
+    ],
+    "src/push-hooks.ts": [
+      "light-sdk-push"
+    ],
+    "src/push-delivery.ts": [
+      "light-sdk-push"
     ]
   }
 }

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "ink-framework-lightos",
-  "version": "0.1.0-alpha.12",
+  "version": "0.1.0-alpha.13",
   "exports": {
     ".": "./src/index.ts",
     "./ringtone": "./src/ringtone.ts",
-    "./push": "./src/push.ts"
+    "./push": "./src/push.ts",
+    "./push/delivery": "./src/push-delivery.ts"
   },
   "peerDependencies": {
-    "ink": "npm:ink-framework@0.1.0-alpha.12",
+    "ink": "npm:ink-framework@0.1.0-alpha.13",
     "react": "19.2.8"
   },
   "license": "MIT",
@@ -19,6 +20,7 @@
   "files": [
     "src",
     "*.json",
-    "*.ts"
+    "*.ts",
+    "*.md"
   ]
 }

package/src/push-delivery.ts

@@ -0,0 +1,44 @@
+import { callNative, NativeError } from "ink/native";
+
+export interface PushMessage {
+  id: string;
+  groupKey: string;
+  title: string;
+  body: string;
+  route: string;
+  receivedAt: number;
+}
+export function fields(value: unknown) {
+  if (typeof value !== "object" || value === null) throw new NativeError("protocol", "Invalid push state");
+  return {
+    text(name: string) {
+      const field: unknown = Reflect.get(value, name);
+      if (typeof field !== "string") throw new NativeError("protocol", `Invalid push ${name}`);
+      return field;
+    },
+    time(name: string) {
+      const field: unknown = Reflect.get(value, name);
+      if (typeof field !== "number" || !Number.isSafeInteger(field) || field < 0) throw new NativeError("protocol", `Invalid push ${name}`);
+      return field;
+    },
+  };
+}
+export function decodeMessage(value: unknown): PushMessage {
+  const item = fields(value);
+  return { id: item.text("id"), groupKey: item.text("groupKey"), title: item.text("title"), body: item.text("body"), route: item.text("route"), receivedAt: item.time("receivedAtMs") };
+}
+export interface PushDelivery { messages: readonly PushMessage[]; cancelled: readonly string[] }
+export function decodePushDelivery(value: unknown): PushDelivery {
+  if (typeof value !== "object" || value === null || !("messages" in value) || !Array.isArray(value.messages)
+    || !("cancelled" in value) || !Array.isArray(value.cancelled)) throw new TypeError("Invalid push delivery");
+  return {
+    messages: value.messages.map(decodeMessage),
+    cancelled: value.cancelled.map((key: unknown) => {
+      if (typeof key !== "string") throw new TypeError("Invalid cancelled push group");
+      return key;
+    }),
+  };
+}
+export async function setPushTask(task: { id: string } | null): Promise<void> {
+  await callNative("background", "set-push-task", { task: task?.id ?? null });
+}

package/src/push-hooks.ts

@@ -0,0 +1,82 @@
+import { fields, decodeMessage, type PushMessage } from "./push-delivery";
+import { useEffect, useMemo, useRef, useState } from "ink/internal/react";
+import { NativeError } from "ink/native";
+import { attachNativeController } from "ink/native/controller";
+
+export interface PushState {
+  status: "idle" | "registering" | "synchronising" | "ready" | "error";
+  endpoint: string;
+  registeredAt: number;
+  openedKey: string;
+  messages: readonly PushMessage[];
+  error: Error | null;
+}
+export interface PushRegistration {
+  url: string;
+  bearerToken?: string;
+  encryptionKey?: string;
+  fetchOnWake?: boolean;
+}
+export interface PushOptions {
+  foregroundGroup?: string | null;
+}
+const initial: PushState = { status: "idle", endpoint: "", registeredAt: 0, openedKey: "", messages: [], error: null };
+function decode(value: unknown): PushState {
+  const field = fields(value);
+  const status = field.text("status");
+  if (status !== "idle" && status !== "registering" && status !== "synchronising" && status !== "ready" && status !== "error") throw new NativeError("protocol", "Invalid push status");
+  if (typeof value !== "object" || value === null || !("messages" in value) || !Array.isArray(value.messages)) throw new NativeError("protocol", "Invalid push messages");
+  let error: Error | null = null;
+  if (status === "error") {
+    if (!("error" in value) || typeof value.error !== "object" || value.error === null) throw new NativeError("protocol", "Invalid push error");
+    const detail = fields(value.error);
+    error = new NativeError(detail.text("kind"), detail.text("message"), "retryable" in value.error && value.error.retryable === true);
+  }
+  return { status, endpoint: field.text("endpoint"), registeredAt: field.time("registeredAtMs"), openedKey: field.text("openedKey"), error,
+    messages: value.messages.map(decodeMessage) };
+}
+
+export function usePush({ foregroundGroup = null }: PushOptions = {}) {
+  const [state, setState] = useState(initial);
+  const [ready, setReady] = useState(false);
+  const controller = useRef<ReturnType<typeof attachNativeController> | null>(null);
+  useEffect(() => {
+    setState(initial);
+    setReady(false);
+    const fail = (error: unknown) => setState({ ...initial, status: "error", error: error instanceof Error ? error : new Error(String(error)) });
+    const attachment = attachNativeController("notifications", { kind: "light-push" }, value => {
+      try { setState(decode(value)); } catch (error) { fail(error); }
+    });
+    controller.current = attachment;
+    void attachment.ready.then(() => {
+      if (controller.current === attachment) setReady(true);
+    }, error => { if (controller.current === attachment) fail(error); });
+    return () => {
+      controller.current = null;
+      void attachment.dispose().catch(error => console.error("Could not release push inbox", error));
+    };
+  }, []);
+  useEffect(() => {
+    const attachment = controller.current;
+    if (!attachment) return;
+    let active = true;
+    void attachment.call("foreground", { groupKey: foregroundGroup }).catch(error => {
+      if (active) setState(current => ({ ...current, status: "error", error: error instanceof Error ? error : new Error(String(error)) }));
+    });
+    return () => { active = false; };
+  }, [foregroundGroup]);
+  const commands = useMemo(() => {
+    const call = async (operation: string, payload: unknown = {}) => {
+      if (!controller.current) throw new NativeError("unavailable", "Push inbox is not attached");
+      await controller.current.call(operation, payload);
+    };
+    return {
+      register: (options: PushRegistration) => call("register", options),
+      retry: () => call("retry"), unregister: () => call("unregister"),
+      dismiss: (groupKey: string) => call("dismiss", { groupKey }), clear: () => call("clear"),
+      notifyForeground: (groupKey: string) => call("foreground-message", { groupKey }),
+    };
+  }, []);
+  return { state, ready, ...commands };
+}
+

package/src/push.ts

@@ -1,123 +1,2 @@
-import { useEffect, useMemo, useRef, useState } from "react";
-import { callNative, NativeError } from "ink/native";
-import { attachNativeController } from "ink/native/controller";
-
-export interface PushMessage {
-  id: string;
-  groupKey: string;
-  title: string;
-  body: string;
-  route: string;
-  receivedAt: number;
-}
-export interface PushState {
-  status: "idle" | "registering" | "synchronising" | "ready" | "error";
-  endpoint: string;
-  registeredAt: number;
-  openedKey: string;
-  messages: readonly PushMessage[];
-  error: Error | null;
-}
-export interface PushRegistration {
-  url: string;
-  bearerToken?: string;
-  encryptionKey?: string;
-  fetchOnWake?: boolean;
-}
-export interface PushOptions {
-  foregroundGroup?: string | null;
-}
-const initial: PushState = { status: "idle", endpoint: "", registeredAt: 0, openedKey: "", messages: [], error: null };
-function fields(value: unknown) {
-  if (typeof value !== "object" || value === null) throw new NativeError("protocol", "Invalid push state");
-  return {
-    text(name: string) {
-      const field: unknown = Reflect.get(value, name);
-      if (typeof field !== "string") throw new NativeError("protocol", `Invalid push ${name}`);
-      return field;
-    },
-    time(name: string) {
-      const field: unknown = Reflect.get(value, name);
-      if (typeof field !== "number" || !Number.isSafeInteger(field) || field < 0) throw new NativeError("protocol", `Invalid push ${name}`);
-      return field;
-    },
-  };
-}
-function decodeMessage(value: unknown): PushMessage {
-  const item = fields(value);
-  return { id: item.text("id"), groupKey: item.text("groupKey"), title: item.text("title"), body: item.text("body"), route: item.text("route"), receivedAt: item.time("receivedAtMs") };
-}
-function decode(value: unknown): PushState {
-  const field = fields(value);
-  const status = field.text("status");
-  if (status !== "idle" && status !== "registering" && status !== "synchronising" && status !== "ready" && status !== "error") throw new NativeError("protocol", "Invalid push status");
-  if (typeof value !== "object" || value === null || !("messages" in value) || !Array.isArray(value.messages)) throw new NativeError("protocol", "Invalid push messages");
-  let error: Error | null = null;
-  if (status === "error") {
-    if (!("error" in value) || typeof value.error !== "object" || value.error === null) throw new NativeError("protocol", "Invalid push error");
-    const detail = fields(value.error);
-    error = new NativeError(detail.text("kind"), detail.text("message"), "retryable" in value.error && value.error.retryable === true);
-  }
-  return { status, endpoint: field.text("endpoint"), registeredAt: field.time("registeredAtMs"), openedKey: field.text("openedKey"), error,
-    messages: value.messages.map(decodeMessage) };
-}
-
-export function usePush({ foregroundGroup = null }: PushOptions = {}) {
-  const [state, setState] = useState(initial);
-  const [ready, setReady] = useState(false);
-  const controller = useRef<ReturnType<typeof attachNativeController> | null>(null);
-  useEffect(() => {
-    setState(initial);
-    setReady(false);
-    const fail = (error: unknown) => setState({ ...initial, status: "error", error: error instanceof Error ? error : new Error(String(error)) });
-    const attachment = attachNativeController("notifications", { kind: "light-push" }, value => {
-      try { setState(decode(value)); } catch (error) { fail(error); }
-    });
-    controller.current = attachment;
-    void attachment.ready.then(() => {
-      if (controller.current === attachment) setReady(true);
-    }, error => { if (controller.current === attachment) fail(error); });
-    return () => {
-      controller.current = null;
-      void attachment.dispose().catch(error => console.error("Could not release push inbox", error));
-    };
-  }, []);
-  useEffect(() => {
-    const attachment = controller.current;
-    if (!attachment) return;
-    let active = true;
-    void attachment.call("foreground", { groupKey: foregroundGroup }).catch(error => {
-      if (active) setState(current => ({ ...current, status: "error", error: error instanceof Error ? error : new Error(String(error)) }));
-    });
-    return () => { active = false; };
-  }, [foregroundGroup]);
-  const commands = useMemo(() => {
-    const call = async (operation: string, payload: unknown = {}) => {
-      if (!controller.current) throw new NativeError("unavailable", "Push inbox is not attached");
-      await controller.current.call(operation, payload);
-    };
-    return {
-      register: (options: PushRegistration) => call("register", options),
-      retry: () => call("retry"), unregister: () => call("unregister"),
-      dismiss: (groupKey: string) => call("dismiss", { groupKey }), clear: () => call("clear"),
-      notifyForeground: (groupKey: string) => call("foreground-message", { groupKey }),
-    };
-  }, []);
-  return { state, ready, ...commands };
-}
-
-export interface PushDelivery { messages: readonly PushMessage[]; cancelled: readonly string[] }
-export function decodePushDelivery(value: unknown): PushDelivery {
-  if (typeof value !== "object" || value === null || !("messages" in value) || !Array.isArray(value.messages)
-    || !("cancelled" in value) || !Array.isArray(value.cancelled)) throw new TypeError("Invalid push delivery");
-  return {
-    messages: value.messages.map(decodeMessage),
-    cancelled: value.cancelled.map((key: unknown) => {
-      if (typeof key !== "string") throw new TypeError("Invalid cancelled push group");
-      return key;
-    }),
-  };
-}
-export async function setPushTask(task: { id: string } | null): Promise<void> {
-  await callNative("background", "set-push-task", { task: task?.id ?? null });
-}
+export { usePush, type PushState, type PushRegistration, type PushOptions } from "./push-hooks";
+export { decodePushDelivery, setPushTask, type PushDelivery, type PushMessage } from "./push-delivery";