@rep-protocol/svelte 0.1.1

package/LICENSE

@@ -0,0 +1,9 @@
+Specification documents (spec/, schema/) are licensed under:
+Creative Commons Attribution 4.0 International (CC BY 4.0)
+https://creativecommons.org/licenses/by/4.0/
+
+Reference implementations and tooling are licensed under:
+Apache License, Version 2.0
+https://www.apache.org/licenses/LICENSE-2.0
+
+Copyright 2026 Ruach Tech

package/README.md

@@ -0,0 +1,93 @@
+# @rep-protocol/svelte
+
+Svelte stores for the [Runtime Environment Protocol](https://github.com/ruachtech/rep).
+
+Provides `repStore()` and `repSecureStore()` which wrap the REP SDK into Svelte-native readable stores. Subscribes to hot-reload updates automatically; the SSE connection is closed when all subscribers unsubscribe.
+
+## Install
+
+```bash
+npm install @rep-protocol/svelte @rep-protocol/sdk
+```
+
+## Usage
+
+```svelte
+<script lang="ts">
+  import { repStore, repSecureStore } from '@rep-protocol/svelte';
+
+  // PUBLIC tier — synchronous initial value, updates on hot reload.
+  const apiUrl = repStore('API_URL', 'http://localhost:3000');
+  const flags = repStore('FEATURE_FLAGS', '');
+
+  // SENSITIVE tier — starts as null, resolves after session key fetch.
+  const analyticsKey = repSecureStore('ANALYTICS_KEY');
+</script>
+
+<p>API: {$apiUrl}</p>
+<p>Analytics: {$analyticsKey ?? 'loading…'}</p>
+```
+
+## API
+
+### `repStore(key, defaultValue?)`
+
+Reads a **PUBLIC** tier variable as a Svelte `Readable<string | undefined>`.
+
+```typescript
+const value: Readable<string | undefined> = repStore('API_URL');
+const value: Readable<string | undefined> = repStore('API_URL', 'fallback');
+```
+
+- Synchronous initial value — set immediately from the REP payload.
+- Returns `defaultValue` (or `undefined`) if the variable is not present.
+- Automatically updates when the variable changes via hot reload.
+- **Lazy:** the SSE subscription is established only when there is at least one subscriber. The connection is closed when all subscribers unsubscribe.
+
+### `repSecureStore(key)`
+
+Reads a **SENSITIVE** tier variable as a Svelte `Readable<string | null>`.
+
+```typescript
+const value: Readable<string | null> = repSecureStore('ANALYTICS_KEY');
+```
+
+- Starts as `null`.
+- Resolves to the decrypted value once the session key fetch completes.
+- The decrypted value is cached by the SDK for the page lifetime.
+- Errors are swallowed silently (the SDK logs them); the store stays `null`.
+
+## Hot Reload
+
+`repStore` subscribes to the REP gateway's SSE stream lazily (on first `subscribe()` call). The store updates automatically when config changes. The SSE connection is closed when there are no remaining subscribers.
+
+`repSecureStore` does not support hot reload — changes to sensitive variables require a page reload.
+
+## Requirements
+
+- Svelte ≥ 4 or Svelte 5
+- `@rep-protocol/sdk` as a peer dependency
+
+## Development Mode
+
+Without the REP gateway, `repStore()` returns a store with value `undefined`. Use `defaultValue` for local development:
+
+```typescript
+const apiUrl = repStore('API_URL', 'http://localhost:3000');
+```
+
+Or inject a mock payload in your `index.html`:
+
+```html
+<script id="__rep__" type="application/json">
+{"public":{"API_URL":"http://localhost:3000"},"_meta":{"version":"0.1.0","injected_at":"2026-01-01T00:00:00Z","integrity":"hmac-sha256:dev","ttl":0}}
+</script>
+```
+
+## Specification
+
+Implements [REP-RFC-0001 §5.5 — Framework Adapters](https://github.com/ruachtech/rep/blob/main/spec/REP-RFC-0001.md).
+
+## License
+
+Apache 2.0

package/dist/index.d.mts

@@ -0,0 +1,43 @@
+import { Readable } from 'svelte/store';
+
+/**
+ * @rep-protocol/svelte — Svelte stores for the Runtime Environment Protocol.
+ *
+ * Provides `repStore()` and `repSecureStore()` which wrap the SDK into
+ * Svelte-native readable stores. Subscribers receive hot-reload updates
+ * automatically; the SSE connection is closed when all subscribers unsub.
+ *
+ * @see https://github.com/ruachtech/rep — REP-RFC-0001 §5.5
+ * @license Apache-2.0
+ * @version 0.1.0
+ */
+
+/**
+ * A readable store for a PUBLIC tier variable. Synchronous initial value.
+ *
+ * The store updates whenever the variable changes via hot reload.
+ * The underlying SSE connection is cleaned up when all subscribers unsubscribe.
+ *
+ * @param key          Variable name (without `REP_PUBLIC_` prefix).
+ * @param defaultValue Fallback value if the variable is not present.
+ *
+ * @example
+ *   const apiUrl = repStore('API_URL', 'https://api.example.com');
+ *   $: console.log($apiUrl);
+ */
+declare function repStore(key: string, defaultValue?: string): Readable<string | undefined>;
+/**
+ * A readable store for a SENSITIVE tier variable. Starts as `null`, resolves async.
+ *
+ * Fetches the session key on first subscription and decrypts the value.
+ * The decrypted value is cached by the SDK for the page lifetime.
+ *
+ * @param key Variable name (without `REP_SENSITIVE_` prefix).
+ *
+ * @example
+ *   const analyticsKey = repSecureStore('ANALYTICS_KEY');
+ *   $: console.log($analyticsKey); // null initially, then the decrypted value
+ */
+declare function repSecureStore(key: string): Readable<string | null>;
+
+export { repSecureStore, repStore };

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+import { Readable } from 'svelte/store';
+
+/**
+ * @rep-protocol/svelte — Svelte stores for the Runtime Environment Protocol.
+ *
+ * Provides `repStore()` and `repSecureStore()` which wrap the SDK into
+ * Svelte-native readable stores. Subscribers receive hot-reload updates
+ * automatically; the SSE connection is closed when all subscribers unsub.
+ *
+ * @see https://github.com/ruachtech/rep — REP-RFC-0001 §5.5
+ * @license Apache-2.0
+ * @version 0.1.0
+ */
+
+/**
+ * A readable store for a PUBLIC tier variable. Synchronous initial value.
+ *
+ * The store updates whenever the variable changes via hot reload.
+ * The underlying SSE connection is cleaned up when all subscribers unsubscribe.
+ *
+ * @param key          Variable name (without `REP_PUBLIC_` prefix).
+ * @param defaultValue Fallback value if the variable is not present.
+ *
+ * @example
+ *   const apiUrl = repStore('API_URL', 'https://api.example.com');
+ *   $: console.log($apiUrl);
+ */
+declare function repStore(key: string, defaultValue?: string): Readable<string | undefined>;
+/**
+ * A readable store for a SENSITIVE tier variable. Starts as `null`, resolves async.
+ *
+ * Fetches the session key on first subscription and decrypts the value.
+ * The decrypted value is cached by the SDK for the page lifetime.
+ *
+ * @param key Variable name (without `REP_SENSITIVE_` prefix).
+ *
+ * @example
+ *   const analyticsKey = repSecureStore('ANALYTICS_KEY');
+ *   $: console.log($analyticsKey); // null initially, then the decrypted value
+ */
+declare function repSecureStore(key: string): Readable<string | null>;
+
+export { repSecureStore, repStore };

package/dist/index.js

@@ -0,0 +1,60 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  repSecureStore: () => repSecureStore,
+  repStore: () => repStore
+});
+module.exports = __toCommonJS(index_exports);
+var import_store = require("svelte/store");
+var import_sdk = require("@rep-protocol/sdk");
+function repStore(key, defaultValue) {
+  return (0, import_store.readable)((0, import_sdk.get)(key, defaultValue), (set) => {
+    const unsubscribe = (0, import_sdk.onChange)(key, (newValue) => {
+      set(newValue !== "" ? newValue : defaultValue);
+    });
+    return unsubscribe;
+  });
+}
+function repSecureStore(key) {
+  return (0, import_store.readable)(null, (set) => {
+    (0, import_sdk.getSecure)(key).then((v) => set(v)).catch(() => {
+    });
+    return () => {
+    };
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  repSecureStore,
+  repStore
+});
+/**
+ * @rep-protocol/svelte — Svelte stores for the Runtime Environment Protocol.
+ *
+ * Provides `repStore()` and `repSecureStore()` which wrap the SDK into
+ * Svelte-native readable stores. Subscribers receive hot-reload updates
+ * automatically; the SSE connection is closed when all subscribers unsub.
+ *
+ * @see https://github.com/ruachtech/rep — REP-RFC-0001 §5.5
+ * @license Apache-2.0
+ * @version 0.1.0
+ */

package/dist/index.mjs

@@ -0,0 +1,34 @@
+// src/index.ts
+import { readable } from "svelte/store";
+import { get, getSecure, onChange } from "@rep-protocol/sdk";
+function repStore(key, defaultValue) {
+  return readable(get(key, defaultValue), (set) => {
+    const unsubscribe = onChange(key, (newValue) => {
+      set(newValue !== "" ? newValue : defaultValue);
+    });
+    return unsubscribe;
+  });
+}
+function repSecureStore(key) {
+  return readable(null, (set) => {
+    getSecure(key).then((v) => set(v)).catch(() => {
+    });
+    return () => {
+    };
+  });
+}
+export {
+  repSecureStore,
+  repStore
+};
+/**
+ * @rep-protocol/svelte — Svelte stores for the Runtime Environment Protocol.
+ *
+ * Provides `repStore()` and `repSecureStore()` which wrap the SDK into
+ * Svelte-native readable stores. Subscribers receive hot-reload updates
+ * automatically; the SSE connection is closed when all subscribers unsub.
+ *
+ * @see https://github.com/ruachtech/rep — REP-RFC-0001 §5.5
+ * @license Apache-2.0
+ * @version 0.1.0
+ */

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@rep-protocol/svelte",
+  "version": "0.1.1",
+  "description": "Svelte adapter for the Runtime Environment Protocol (REP).",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "svelte": "^4.0.0 || ^5.0.0",
+    "@rep-protocol/sdk": "0.1.2"
+  },
+  "devDependencies": {
+    "svelte": "^4.2.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "test": "vitest run"
+  }
+}