@frontmcp/sdk 0.2.3 → 0.3.0

package/src/store/store.helpers.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useStore = useStore;
+exports.setMany = setMany;
+exports.getMany = getMany;
+const store_registry_1 = require("./store.registry");
+const store_utils_1 = require("./store.utils");
+function useStore(scope, storeName) {
+    const registry = (0, store_registry_1.getRegistryForScope)(scope.id);
+    const driver = registry.ensure(storeName);
+    return function forPrefix(prefix) {
+        return {
+            scope,
+            prefix,
+            storeName,
+            async get(key) {
+                const raw = await driver.get((0, store_utils_1.buildDataKey)(scope, prefix, String(key)));
+                return store_utils_1.Json.decode(raw);
+            },
+            async set(key, value, opts) {
+                await driver.set((0, store_utils_1.buildDataKey)(scope, prefix, String(key)), store_utils_1.Json.encode(value), opts);
+            },
+            async del(key) {
+                await driver.del((0, store_utils_1.buildDataKey)(scope, prefix, String(key)));
+            },
+            async exists(key) {
+                return driver.exists((0, store_utils_1.buildDataKey)(scope, prefix, String(key)));
+            },
+            async incr(key) {
+                return driver.incr((0, store_utils_1.buildDataKey)(scope, prefix, String(key)));
+            },
+            async decr(key) {
+                return driver.decr((0, store_utils_1.buildDataKey)(scope, prefix, String(key)));
+            },
+            async expire(key, ttlSeconds) {
+                await driver.expire((0, store_utils_1.buildDataKey)(scope, prefix, String(key)), ttlSeconds);
+            },
+            async ttl(key) {
+                return driver.ttl((0, store_utils_1.buildDataKey)(scope, prefix, String(key)));
+            },
+            async publish(channel, message) {
+                return driver.publish((0, store_utils_1.buildChannel)(scope, prefix, channel), message);
+            },
+            async subscribe(channel, handler) {
+                const ch = (0, store_utils_1.buildChannel)(scope, prefix, channel);
+                return driver.subscribe(ch, handler);
+            },
+        };
+    };
+}
+// Batch helpers bound to a store name
+async function setMany(scope, storeName, prefix, entries) {
+    const { ensure } = (0, store_registry_1.getRegistryForScope)(scope.id);
+    const driver = ensure(storeName);
+    await driver.mset(entries.map((e) => ({
+        key: (0, store_utils_1.buildDataKey)(scope, prefix, String(e.key)),
+        value: store_utils_1.Json.encode(e.value),
+        opts: e.opts,
+    })));
+}
+async function getMany(scope, storeName, prefix, keys) {
+    const driver = (0, store_registry_1.getRegistryForScope)(scope.id).ensure(storeName);
+    const fullKeys = keys.map((k) => (0, store_utils_1.buildDataKey)(scope, prefix, String(k)));
+    const res = await driver.mget(fullKeys);
+    return res.map((r) => store_utils_1.Json.decode(r));
+}
+//# sourceMappingURL=store.helpers.js.map

package/src/store/store.helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.helpers.js","sourceRoot":"","sources":["../../../src/store/store.helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AllPrefixes, KeysFor, PrefixStore, SetOptions, ValueFor } from './store.types';\nimport { getRegistryForScope } from './store.registry';\nimport { buildChannel, buildDataKey, Json } from './store.utils';\nimport { Scope } from '../scope/scope.instance';\n\nexport function useStore(scope: Scope, storeName: string) {\n  const registry = getRegistryForScope(scope.id);\n  const driver = registry.ensure(storeName);\n\n  return function forPrefix<P extends AllPrefixes>(prefix: P): PrefixStore<P> {\n    return {\n      scope,\n      prefix,\n      storeName,\n\n      async get<K extends KeysFor<P>>(key: K) {\n        const raw = await driver.get(buildDataKey(scope, prefix, String(key)));\n        return Json.decode<ValueFor<P, K>>(raw);\n      },\n      async set<K extends KeysFor<P>>(key: K, value: ValueFor<P, K>, opts?: SetOptions) {\n        await driver.set(buildDataKey(scope, prefix, String(key)), Json.encode(value), opts);\n      },\n      async del<K extends KeysFor<P>>(key: K) {\n        await driver.del(buildDataKey(scope, prefix, String(key)));\n      },\n      async exists<K extends KeysFor<P>>(key: K) {\n        return driver.exists(buildDataKey(scope, prefix, String(key)));\n      },\n      async incr<K extends KeysFor<P>>(key: K) {\n        return driver.incr(buildDataKey(scope, prefix, String(key)));\n      },\n      async decr<K extends KeysFor<P>>(key: K) {\n        return driver.decr(buildDataKey(scope, prefix, String(key)));\n      },\n      async expire<K extends KeysFor<P>>(key: K, ttlSeconds: number) {\n        await driver.expire(buildDataKey(scope, prefix, String(key)), ttlSeconds);\n      },\n      async ttl<K extends KeysFor<P>>(key: K) {\n        return driver.ttl(buildDataKey(scope, prefix, String(key)));\n      },\n      async publish(channel: string, message: string) {\n        return driver.publish(buildChannel(scope, prefix, channel), message);\n      },\n      async subscribe(channel: string, handler: (message: string) => void) {\n        const ch = buildChannel(scope, prefix, channel);\n        return driver.subscribe(ch, handler);\n      },\n    } satisfies PrefixStore<P>;\n  };\n}\n\n// Batch helpers bound to a store name\nexport async function setMany<P extends AllPrefixes, K extends KeysFor<P>>(\n  scope: Scope,\n  storeName: string,\n  prefix: P,\n  entries: Array<{ key: K; value: ValueFor<P, K>; opts?: SetOptions }>,\n): Promise<void> {\n  const { ensure } = getRegistryForScope(scope.id);\n  const driver = ensure(storeName);\n  await driver.mset(\n    entries.map((e) => ({\n      key: buildDataKey(scope, prefix, String(e.key)),\n      value: Json.encode(e.value),\n      opts: e.opts,\n    })),\n  );\n}\n\nexport async function getMany<P extends AllPrefixes, K extends KeysFor<P>, V = ValueFor<P, K>>(\n  scope: Scope,\n  storeName: string,\n  prefix: P,\n  keys: K[],\n): Promise<Array<V | null>> {\n  const driver = getRegistryForScope(scope.id).ensure(storeName);\n  const fullKeys = keys.map((k) => buildDataKey(scope, prefix, String(k)));\n  const res = await driver.mget(fullKeys);\n  return res.map((r) => Json.decode<V>(r));\n}\n"]}

package/src/store/store.registry.d.ts

@@ -0,0 +1,13 @@
+import type { StoreDriver, StoreRegistryInterface } from './store.types';
+import { Scope } from '../scope';
+export declare class StoreRegistry implements StoreRegistryInterface {
+    private readonly map;
+    register(name: string, driver: StoreDriver): void;
+    get(name: string): StoreDriver | undefined;
+    ensure(name: string): StoreDriver;
+    has(name: string): boolean;
+    list(): string[];
+}
+export type StoreRegistryLocator = (scopeId: Scope['id']) => StoreRegistryInterface;
+export declare function configureStoreRegistryLocator(l: StoreRegistryLocator): void;
+export declare function getRegistryForScope(scopeId: Scope['id']): StoreRegistryInterface;

package/src/store/store.registry.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StoreRegistry = void 0;
+exports.configureStoreRegistryLocator = configureStoreRegistryLocator;
+exports.getRegistryForScope = getRegistryForScope;
+class StoreRegistry {
+    map = new Map();
+    register(name, driver) {
+        this.map.set(name, driver);
+    }
+    get(name) {
+        return this.map.get(name);
+    }
+    ensure(name) {
+        const d = this.map.get(name);
+        if (!d)
+            throw new Error(`No store driver named "${name}"`);
+        return d;
+    }
+    has(name) {
+        return this.map.has(name);
+    }
+    list() {
+        return Array.from(this.map.keys());
+    }
+}
+exports.StoreRegistry = StoreRegistry;
+let locator = null;
+function configureStoreRegistryLocator(l) {
+    locator = l;
+}
+function getRegistryForScope(scopeId) {
+    if (!locator)
+        throw new Error('StoreRegistry locator not configured');
+    return locator(scopeId);
+}
+//# sourceMappingURL=store.registry.js.map

package/src/store/store.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.registry.js","sourceRoot":"","sources":["../../../src/store/store.registry.ts"],"names":[],"mappings":";;;AA2BA,sEAEC;AACD,kDAGC;AA9BD,MAAa,aAAa;IACP,GAAG,GAAG,IAAI,GAAG,EAAuB,CAAC;IACtD,QAAQ,CAAC,IAAY,EAAE,MAAmB;QACxC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;IACD,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,MAAM,CAAC,IAAY;QACjB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,GAAG,CAAC,CAAC;QAC3D,OAAO,CAAC,CAAC;IACX,CAAC;IACD,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;CACF;AAnBD,sCAmBC;AAGD,IAAI,OAAO,GAAgC,IAAI,CAAC;AAEhD,SAAgB,6BAA6B,CAAC,CAAuB;IACnE,OAAO,GAAG,CAAC,CAAC;AACd,CAAC;AACD,SAAgB,mBAAmB,CAAC,OAAoB;IACtD,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACtE,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;AAC1B,CAAC","sourcesContent":["import type { StoreDriver, StoreRegistryInterface } from './store.types';\nimport { Scope } from '../scope';\n\nexport class StoreRegistry implements StoreRegistryInterface {\n  private readonly map = new Map<string, StoreDriver>();\n  register(name: string, driver: StoreDriver): void {\n    this.map.set(name, driver);\n  }\n  get(name: string): StoreDriver | undefined {\n    return this.map.get(name);\n  }\n  ensure(name: string): StoreDriver {\n    const d = this.map.get(name);\n    if (!d) throw new Error(`No store driver named \"${name}\"`);\n    return d;\n  }\n  has(name: string): boolean {\n    return this.map.has(name);\n  }\n  list(): string[] {\n    return Array.from(this.map.keys());\n  }\n}\n\nexport type StoreRegistryLocator = (scopeId: Scope['id']) => StoreRegistryInterface;\nlet locator: StoreRegistryLocator | null = null;\n\nexport function configureStoreRegistryLocator(l: StoreRegistryLocator) {\n  locator = l;\n}\nexport function getRegistryForScope(scopeId: Scope['id']): StoreRegistryInterface {\n  if (!locator) throw new Error('StoreRegistry locator not configured');\n  return locator(scopeId);\n}\n"]}

package/src/store/store.tokens.d.ts

@@ -0,0 +1,3 @@
+export declare const STORE_REGISTRY_LOCATOR_TOKEN: unique symbol;
+export declare const STORE_SCOPE_RESOLVER_TOKEN: unique symbol;
+export declare const STORE_DRIVER_TOKEN: unique symbol;

package/src/store/store.tokens.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STORE_DRIVER_TOKEN = exports.STORE_SCOPE_RESOLVER_TOKEN = exports.STORE_REGISTRY_LOCATOR_TOKEN = void 0;
+exports.STORE_REGISTRY_LOCATOR_TOKEN = Symbol.for('mcp.store.registry_locator');
+exports.STORE_SCOPE_RESOLVER_TOKEN = Symbol.for('mcp.store.scope_resolver');
+exports.STORE_DRIVER_TOKEN = Symbol.for('mcp.store.driver');
+//# sourceMappingURL=store.tokens.js.map

package/src/store/store.tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.tokens.js","sourceRoot":"","sources":["../../../src/store/store.tokens.ts"],"names":[],"mappings":";;;AAAa,QAAA,4BAA4B,GAAG,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;AACxE,QAAA,0BAA0B,GAAG,MAAM,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AACpE,QAAA,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC","sourcesContent":["export const STORE_REGISTRY_LOCATOR_TOKEN = Symbol.for('mcp.store.registry_locator');\nexport const STORE_SCOPE_RESOLVER_TOKEN = Symbol.for('mcp.store.scope_resolver');\nexport const STORE_DRIVER_TOKEN = Symbol.for('mcp.store.driver');\n"]}

package/src/store/store.types.d.ts

@@ -0,0 +1,64 @@
+import { Scope } from '../scope/scope.instance';
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | JsonArray;
+export interface JsonObject {
+    [k: string]: JsonValue;
+}
+export type JsonArray = Array<JsonValue>;
+export interface SetOptions {
+    ttlSeconds?: number;
+}
+export interface StoreDriver {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, opts?: SetOptions): Promise<void>;
+    del(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    mget(keys: string[]): Promise<(string | null)[]>;
+    mset(entries: Array<{
+        key: string;
+        value: string;
+        opts?: SetOptions;
+    }>): Promise<void>;
+    incr(key: string): Promise<number>;
+    decr(key: string): Promise<number>;
+    expire(key: string, ttlSeconds: number): Promise<void>;
+    ttl(key: string): Promise<number | null>;
+    publish(channel: string, message: string): Promise<number>;
+    subscribe(channel: string, handler: (message: string) => void): Promise<() => Promise<void>>;
+}
+export interface StoreRegistryInterface {
+    register(name: string, driver: StoreDriver): void;
+    get(name: string): StoreDriver | undefined;
+    ensure(name: string): StoreDriver;
+    has(name: string): boolean;
+    list(): string[];
+}
+export interface PrefixStore<P extends AllPrefixes = string> {
+    readonly scope: Scope;
+    readonly prefix: P;
+    readonly storeName: string;
+    get<K extends KeysFor<P>>(key: K): Promise<ValueFor<P, K> | null>;
+    set<K extends KeysFor<P>>(key: K, value: ValueFor<P, K>, opts?: SetOptions): Promise<void>;
+    del<K extends KeysFor<P>>(key: K): Promise<void>;
+    exists<K extends KeysFor<P>>(key: K): Promise<boolean>;
+    incr<K extends KeysFor<P>>(key: K): Promise<number>;
+    decr<K extends KeysFor<P>>(key: K): Promise<number>;
+    expire<K extends KeysFor<P>>(key: K, ttlSeconds: number): Promise<void>;
+    ttl<K extends KeysFor<P>>(key: K): Promise<number | null>;
+    publish(channel: string, message: string): Promise<number>;
+    subscribe(channel: string, handler: (message: string) => void): Promise<() => Promise<void>>;
+}
+declare global {
+    export interface McpKVNamespaces {
+        [scope: string]: {
+            [storeName: string]: {
+                [key: string]: unknown;
+            };
+        };
+    }
+}
+export type AllPrefixes = keyof McpKVNamespaces extends never ? string : Extract<keyof McpKVNamespaces, string>;
+export type KeysFor<P> = P extends keyof McpKVNamespaces ? Extract<keyof McpKVNamespaces[P], string> : string;
+export type ValueFor<P, K> = P extends keyof McpKVNamespaces ? K extends keyof McpKVNamespaces[P] ? McpKVNamespaces[P][K] : unknown : unknown;

package/src/store/store.types.js

@@ -0,0 +1,11 @@
+"use strict";
+// ──────────────────────────────────────────────────────────────────────────────
+// File: store/store.types.ts
+// Purpose: Shared & extendable types for the storage factory
+// Model: Each *scope* owns its own StoreRegistry (no global map in the lib).
+// Host app provides a registry locator (scope -> registry) via configuration.
+// API: useStore(scope, storeName) => (prefix) => PrefixedStore
+// Extendability via declaration merging: `interface McpKVNamespaces {}`
+// ──────────────────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=store.types.js.map

package/src/store/store.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.types.js","sourceRoot":"","sources":["../../../src/store/store.types.ts"],"names":[],"mappings":";AAAA,iFAAiF;AACjF,6BAA6B;AAC7B,6DAA6D;AAC7D,6EAA6E;AAC7E,8EAA8E;AAC9E,+DAA+D;AAC/D,wEAAwE;AACxE,iFAAiF","sourcesContent":["// ──────────────────────────────────────────────────────────────────────────────\n// File: store/store.types.ts\n// Purpose: Shared & extendable types for the storage factory\n// Model: Each *scope* owns its own StoreRegistry (no global map in the lib).\n// Host app provides a registry locator (scope -> registry) via configuration.\n// API: useStore(scope, storeName) => (prefix) => PrefixedStore\n// Extendability via declaration merging: `interface McpKVNamespaces {}`\n// ──────────────────────────────────────────────────────────────────────────────\n\nimport { Scope } from '../scope/scope.instance';\n\nexport type JsonPrimitive = string | number | boolean | null;\nexport type JsonValue = JsonPrimitive | JsonObject | JsonArray;\n\nexport interface JsonObject {\n  [k: string]: JsonValue;\n}\n\nexport type JsonArray = Array<JsonValue>;\n\n\nexport interface SetOptions {\n  ttlSeconds?: number;\n}\n\nexport interface StoreDriver {\n  connect(): Promise<void>;\n\n  disconnect(): Promise<void>;\n\n  get(key: string): Promise<string | null>;\n\n  set(key: string, value: string, opts?: SetOptions): Promise<void>;\n\n  del(key: string): Promise<void>;\n\n  exists(key: string): Promise<boolean>;\n\n  mget(keys: string[]): Promise<(string | null)[]>;\n\n  mset(entries: Array<{ key: string; value: string; opts?: SetOptions }>): Promise<void>;\n\n  incr(key: string): Promise<number>;\n\n  decr(key: string): Promise<number>;\n\n  expire(key: string, ttlSeconds: number): Promise<void>;\n\n  ttl(key: string): Promise<number | null>;\n\n  publish(channel: string, message: string): Promise<number>;\n\n  subscribe(channel: string, handler: (message: string) => void): Promise<() => Promise<void>>;\n}\n\n// A per-scope registry holds multiple named drivers (memory/redis/etc.)\nexport interface StoreRegistryInterface {\n  register(name: string, driver: StoreDriver): void;\n\n  get(name: string): StoreDriver | undefined;\n\n  ensure(name: string): StoreDriver;\n\n  has(name: string): boolean;\n\n  list(): string[];\n}\n\n// Typed store interface returned by useStore(scope, name)(prefix)\nexport interface PrefixStore<P extends AllPrefixes = string> {\n  readonly scope: Scope;\n  readonly prefix: P;\n  readonly storeName: string;\n\n  get<K extends KeysFor<P>>(key: K): Promise<ValueFor<P, K> | null>;\n\n  set<K extends KeysFor<P>>(key: K, value: ValueFor<P, K>, opts?: SetOptions): Promise<void>;\n\n  del<K extends KeysFor<P>>(key: K): Promise<void>;\n\n  exists<K extends KeysFor<P>>(key: K): Promise<boolean>;\n\n  incr<K extends KeysFor<P>>(key: K): Promise<number>;\n\n  decr<K extends KeysFor<P>>(key: K): Promise<number>;\n\n  expire<K extends KeysFor<P>>(key: K, ttlSeconds: number): Promise<void>;\n\n  ttl<K extends KeysFor<P>>(key: K): Promise<number | null>;\n\n  publish(channel: string, message: string): Promise<number>;\n\n  subscribe(channel: string, handler: (message: string) => void): Promise<() => Promise<void>>;\n}\n\ndeclare global {\n  // Extendable typings via declaration merging\n  export interface McpKVNamespaces {\n    [scope: string]: {\n      [storeName: string]: {\n        [key: string]: unknown;\n      };\n    };\n  }\n}\n\nexport type AllPrefixes = keyof McpKVNamespaces extends never ? string : Extract<keyof McpKVNamespaces, string>;\n\nexport type KeysFor<P> = P extends keyof McpKVNamespaces ? Extract<keyof McpKVNamespaces[P], string> : string;\n\nexport type ValueFor<P, K> = P extends keyof McpKVNamespaces\n  ? K extends keyof McpKVNamespaces[P]\n    ? McpKVNamespaces[P][K]\n    : unknown\n  : unknown;\n"]}

package/src/store/store.utils.d.ts

@@ -0,0 +1,8 @@
+import { Scope } from '../scope/scope.instance';
+export declare function makeScopeSegment(scope: Scope): string;
+export declare function buildDataKey(scope: Scope, prefix: string, key: string): string;
+export declare function buildChannel(scope: Scope, prefix: string, channel: string): string;
+export declare const Json: {
+    encode<T>(value: T): string;
+    decode<T>(str: string | null): T | null;
+};

package/src/store/store.utils.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Json = void 0;
+exports.makeScopeSegment = makeScopeSegment;
+exports.buildDataKey = buildDataKey;
+exports.buildChannel = buildChannel;
+function makeScopeSegment(scope) { return String(scope); }
+function buildDataKey(scope, prefix, key) {
+    return `${makeScopeSegment(scope)}:${prefix}${key}`;
+}
+function buildChannel(scope, prefix, channel) {
+    return `${makeScopeSegment(scope)}:${prefix}__ch__:${channel}`;
+}
+exports.Json = {
+    encode(value) { return JSON.stringify(value); },
+    decode(str) { return str == null ? null : JSON.parse(str); },
+};
+//# sourceMappingURL=store.utils.js.map

package/src/store/store.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.utils.js","sourceRoot":"","sources":["../../../src/store/store.utils.ts"],"names":[],"mappings":";;;AAEA,4CAAgF;AAEhF,oCAEC;AAED,oCAEC;AARD,SAAgB,gBAAgB,CAAC,KAAY,IAAY,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEhF,SAAgB,YAAY,CAAC,KAAY,EAAE,MAAc,EAAE,GAAW;IACpE,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;AACtD,CAAC;AAED,SAAgB,YAAY,CAAC,KAAY,EAAE,MAAc,EAAE,OAAe;IACxE,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,MAAM,UAAU,OAAO,EAAE,CAAC;AACjE,CAAC;AAEY,QAAA,IAAI,GAAG;IAClB,MAAM,CAAI,KAAQ,IAAY,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAI,GAAkB,IAAc,OAAO,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAO,CAAC,CAAC,CAAC;CAChG,CAAC","sourcesContent":["import { Scope } from '../scope/scope.instance';\n\nexport function makeScopeSegment(scope: Scope): string { return String(scope); }\n\nexport function buildDataKey(scope: Scope, prefix: string, key: string): string {\n  return `${makeScopeSegment(scope)}:${prefix}${key}`;\n}\n\nexport function buildChannel(scope: Scope, prefix: string, channel: string): string {\n  return `${makeScopeSegment(scope)}:${prefix}__ch__:${channel}`;\n}\n\nexport const Json = {\n  encode<T>(value: T): string { return JSON.stringify(value); },\n  decode<T>(str: string | null): T | null { return str == null ? null : (JSON.parse(str) as T); },\n};\n"]}