@reset-framework/sdk 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jan Kordoš
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,16 @@
+# SDK
+
+`@reset-framework/sdk` is the browser-side JavaScript package for Reset applications.
+
+Responsibilities:
+
+- expose a stable `invoke()` API for app frontends
+- hide the raw `window.reset` bridge envelope
+- provide runtime availability checks for local browser development
+- centralize the shared browser helpers used by templates and demo apps
+
+Package layout:
+
+- `src/index.js`: public entrypoint
+- `src/client.js`: runtime bridge helpers
+- `src/errors.js`: SDK-specific error types

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@reset-framework/sdk",
+  "version": "0.2.0",
+  "type": "module",
+  "description": "Browser-side SDK for Reset Framework applications.",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "types": "./src/index.d.ts",
+  "exports": {
+    ".": "./src/index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/src/client.js

@@ -0,0 +1,53 @@
+import { ResetRuntimeUnavailableError } from "./errors.js"
+
+function getDefaultWindowTarget() {
+  if (typeof window === "undefined") {
+    return undefined
+  }
+
+  return window
+}
+
+export function isResetRuntimeAvailable(target = getDefaultWindowTarget()) {
+  return Boolean(
+    target &&
+      target.reset &&
+      typeof target.reset.invoke === "function"
+  )
+}
+
+export function getResetRuntime(target = getDefaultWindowTarget()) {
+  if (!isResetRuntimeAvailable(target)) {
+    throw new ResetRuntimeUnavailableError()
+  }
+
+  return target.reset
+}
+
+export async function invokeRaw(command, payload = {}, target = getDefaultWindowTarget()) {
+  return getResetRuntime(target).invoke(command, payload)
+}
+
+export async function invoke(command, payload = {}, target = getDefaultWindowTarget()) {
+  const response = await invokeRaw(command, payload, target)
+
+  if (!response.ok) {
+    throw new Error(response.error)
+  }
+
+  return response.result
+}
+
+export function createResetClient(target = getDefaultWindowTarget()) {
+  return {
+    isAvailable() {
+      return isResetRuntimeAvailable(target)
+    },
+    invoke(command, payload = {}) {
+      return invoke(command, payload, target)
+    },
+    invokeRaw(command, payload = {}) {
+      return invokeRaw(command, payload, target)
+    }
+  }
+}

package/src/errors.js

@@ -0,0 +1,6 @@
+export class ResetRuntimeUnavailableError extends Error {
+  constructor(message = "reset runtime is not available") {
+    super(message)
+    this.name = "ResetRuntimeUnavailableError"
+  }
+}

package/src/index.d.ts

@@ -0,0 +1,61 @@
+export type ResetInvokeSuccess<T = unknown> = {
+  ok: true;
+  result: T;
+};
+
+export type ResetInvokeError = {
+  ok: false;
+  error: string;
+};
+
+export type ResetInvokeResponse<T = unknown> =
+  | ResetInvokeSuccess<T>
+  | ResetInvokeError;
+
+export interface ResetRuntime {
+  invoke<T = unknown>(
+    command: string,
+    payload?: unknown
+  ): Promise<ResetInvokeResponse<T>>;
+}
+
+export interface ResetRuntimeWindow {
+  reset?: ResetRuntime;
+}
+
+declare global {
+  interface Window extends ResetRuntimeWindow {}
+}
+
+export class ResetRuntimeUnavailableError extends Error {
+  constructor(message?: string);
+}
+
+export function isResetRuntimeAvailable(
+  target?: ResetRuntimeWindow
+): boolean;
+
+export function getResetRuntime(
+  target?: ResetRuntimeWindow
+): ResetRuntime;
+
+export function invokeRaw<T = unknown>(
+  command: string,
+  payload?: unknown,
+  target?: ResetRuntimeWindow
+): Promise<ResetInvokeResponse<T>>;
+
+export function invoke<T = unknown>(
+  command: string,
+  payload?: unknown,
+  target?: ResetRuntimeWindow
+): Promise<T>;
+
+export function createResetClient(target?: ResetRuntimeWindow): {
+  isAvailable(): boolean;
+  invoke<T = unknown>(command: string, payload?: unknown): Promise<T>;
+  invokeRaw<T = unknown>(
+    command: string,
+    payload?: unknown
+  ): Promise<ResetInvokeResponse<T>>;
+};

package/src/index.js

@@ -0,0 +1,9 @@
+export {
+  createResetClient,
+  getResetRuntime,
+  invoke,
+  invokeRaw,
+  isResetRuntimeAvailable
+} from "./client.js"
+
+export { ResetRuntimeUnavailableError } from "./errors.js"