@narrative.io/jsonforms-provider-protocols 1.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Narrative I/O
+
+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 whom the Software is
+furnished 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,200 @@
+# JSONForms Provider Protocols
+
+[![npm version](https://img.shields.io/npm/v/@narrative.io/jsonforms-provider-protocols.svg)](https://www.npmjs.com/package/@narrative.io/jsonforms-provider-protocols)
+[![CI](https://github.com/narrative-io/jsonforms-provider-protocols/workflows/CI/badge.svg)](https://github.com/narrative-io/jsonforms-provider-protocols/actions/workflows/ci.yml)
+[![Release](https://github.com/narrative-io/jsonforms-provider-protocols/workflows/Release%20Please/badge.svg)](https://github.com/narrative-io/jsonforms-provider-protocols/actions/workflows/release-please.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/)
+[![Vue 3](https://img.shields.io/badge/Vue-3-4FC08D.svg)](https://vuejs.org/)
+[![JSONForms](https://img.shields.io/badge/JSONForms-3.6+-ff6900.svg)](https://jsonforms.io/)
+
+A Vue 3 library that adds dynamic data provider capabilities to [JSONForms](https://jsonforms.io/), enabling form fields to fetch and display data from various sources like REST APIs, databases, and custom protocols.
+
+## ✨ Features
+
+- 🔌 **Protocol-based Architecture**: Extensible system for different data sources
+- 🚀 **Vue 3 Integration**: Seamless integration with JSONForms Vue renderers
+- 💾 **Built-in Caching**: TTL-based caching with configurable expiration
+- 🔄 **Dynamic Data Loading**: Support for mount, focus, and query-based loading
+- 🎯 **Template Support**: Dynamic URL and parameter templating
+- 📦 **TypeScript Support**: Full TypeScript definitions included
+- 🔐 **Authentication**: Flexible authentication mechanism support
+
+## 📦 Installation
+
+```bash
+# Using bun (recommended)
+bun add @narrative.io/jsonforms-provider-protocols
+
+# Using npm  
+npm install @narrative.io/jsonforms-provider-protocols
+
+# Peer dependencies
+bun add @jsonforms/vue @jsonforms/core vue
+```
+
+## 🚀 Quick Start
+
+### 1. Register the Plugin
+
+```typescript
+import { createApp } from 'vue'
+import ProviderProtocols, { RestApiProtocol } from '@narrative.io/jsonforms-provider-protocols'
+
+const app = createApp(App)
+
+app.use(ProviderProtocols, {
+  protocols: [RestApiProtocol()]
+})
+```
+
+### 2. Configure Your Form
+
+```json
+{
+  "type": "Control",
+  "scope": "#/properties/country",
+  "options": {
+    "provider": {
+      "ref": "countries",
+      "protocol": "rest_api", 
+      "config": {
+        "url": "https://api.example.com/countries",
+        "items": "$.data[*]",
+        "map": {
+          "label": "$.name",
+          "value": "$.code"
+        }
+      }
+    }
+  }
+}
+```
+
+### 3. Use in Vue
+
+```vue
+<script setup lang="ts">
+import { JsonForms } from '@jsonforms/vue'
+import { providerRenderers } from '@narrative.io/jsonforms-provider-protocols/vue'
+import { markRaw, ref } from 'vue'
+
+const data = ref({ country: null })
+const handleChange = (event) => data.value = event.data
+</script>
+
+<template>
+  <JsonForms
+    :data="data"
+    :schema="schema"
+    :uischema="uischema"
+    :renderers="markRaw(providerRenderers)"
+    @change="handleChange"
+  />
+</template>
+```
+
+## 📖 Documentation
+
+### Getting Started
+- [Installation & Setup](./docs/getting-started.md)
+- [Basic Examples](./docs/examples/simple-dropdown.md)
+
+### Core Concepts  
+- [Protocols](./docs/protocols.md) - How to fetch and transform data
+- [Authentication](./docs/authentication.md) - Configure and use authentication
+- [Vue Components](./docs/components.md) - Available components and composables
+- [API Reference](./docs/api/README.md) - Complete API documentation
+
+### Examples
+- [Simple Dropdown](./docs/examples/simple-dropdown.md)
+- [Cascading Dropdowns](./docs/examples/cascading-dropdowns.md) 
+- [Autocomplete Search](./docs/examples/autocomplete-search.md)
+- [Custom Protocols](./docs/examples/custom-protocol.md)
+- [Custom Renderers](./docs/examples/custom-renderer.md)
+- [More Examples](./docs/examples/README.md)
+
+### Help & Troubleshooting
+- [Troubleshooting Guide](./docs/troubleshooting.md)
+- [GitHub Issues](https://github.com/narrative-io/jsonforms-provider-protocols/issues)
+
+## 🔧 Key Concepts
+
+### Protocols
+Define how data is fetched and transformed:
+
+```typescript
+const CustomProtocol: Protocol = {
+  protocol: 'my-api',
+  async resolve(config, context) {
+    const response = await fetch(config.url)
+    const data = await response.json()
+    
+    return {
+      items: data.map(item => ({
+        label: item.name,
+        value: item.id
+      })),
+      ttl: 300
+    }
+  }
+}
+```
+
+### Template Variables
+Create dynamic URLs using form data:
+
+```json
+{
+  "url": "https://api.example.com/countries/{{data.country}}/states",
+  "query": { "search": "{{ui.query}}" }
+}
+```
+
+### Load Strategies
+Control when data is fetched:
+
+- `mount` - Load when component mounts (default)
+- `onFocus` - Load when field receives focus  
+- `query` - Load when user types (autocomplete)
+
+### Composables
+Use providers directly in your components:
+
+```vue
+<script setup>
+import { useProvider } from '@narrative.io/jsonforms-provider-protocols/vue'
+
+const { items, loading, error, reload } = useProvider(binding, context)
+</script>
+```
+
+## 🛠 Development
+
+```bash
+# Install dependencies
+bun install
+
+# Run tests
+bun test
+
+# Build library  
+bun run build
+
+# Type checking
+bunx vue-tsc --noEmit
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Please read our [Contributing Guide](./CONTRIBUTING.md) and check out the [issue tracker](https://github.com/narrative-io/jsonforms-provider-protocols/issues).
+
+## 📄 License
+
+MIT - see [LICENSE](./LICENSE) file for details.
+
+## 🆘 Support
+
+- [Documentation](./docs/)
+- [GitHub Issues](https://github.com/narrative-io/jsonforms-provider-protocols/issues)
+- [Troubleshooting Guide](./docs/troubleshooting.md)

package/dist/_virtual/_plugin-vue_export-helper.js

@@ -0,0 +1,11 @@
+const _export_sfc = (sfc, props) => {
+  const target = sfc.__vccOpts || sfc;
+  for (const [key, val] of props) {
+    target[key] = val;
+  }
+  return target;
+};
+export {
+  _export_sfc as default
+};
+//# sourceMappingURL=_plugin-vue_export-helper.js.map

package/dist/_virtual/_plugin-vue_export-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_plugin-vue_export-helper.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;"}

package/dist/core/cache.d.ts

@@ -0,0 +1,8 @@
+export declare class TTLCache<T> {
+    private m;
+    get(k: string): T | undefined;
+    set(k: string, v: T, ttlSec?: number): void;
+    del(k: string): void;
+}
+export declare const cache: TTLCache<unknown>;
+//# sourceMappingURL=cache.d.ts.map

package/dist/core/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/core/cache.ts"],"names":[],"mappings":"AACA,qBAAa,QAAQ,CAAC,CAAC;IACrB,OAAO,CAAC,CAAC,CAA+B;IACxC,GAAG,CAAC,CAAC,EAAE,MAAM;IASb,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,SAAI;IAM/B,GAAG,CAAC,CAAC,EAAE,MAAM;CAGd;AACD,eAAO,MAAM,KAAK,mBAA0B,CAAC"}

package/dist/core/cache.js

@@ -0,0 +1,27 @@
+class TTLCache {
+  m = /* @__PURE__ */ new Map();
+  get(k) {
+    const e = this.m.get(k);
+    if (!e) return void 0;
+    if (e.expiresAt !== 0 && Date.now() > e.expiresAt) {
+      this.m.delete(k);
+      return void 0;
+    }
+    return e.value;
+  }
+  set(k, v, ttlSec = 0) {
+    this.m.set(k, {
+      value: v,
+      expiresAt: ttlSec ? Date.now() + ttlSec * 1e3 : 0
+    });
+  }
+  del(k) {
+    this.m.delete(k);
+  }
+}
+const cache = new TTLCache();
+export {
+  TTLCache,
+  cache
+};
+//# sourceMappingURL=cache.js.map

package/dist/core/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sources":["../../src/core/cache.ts"],"sourcesContent":["type Entry<T> = { value: T; expiresAt: number };\nexport class TTLCache<T> {\n  private m = new Map<string, Entry<T>>();\n  get(k: string) {\n    const e = this.m.get(k);\n    if (!e) return undefined;\n    if (e.expiresAt !== 0 && Date.now() > e.expiresAt) {\n      this.m.delete(k);\n      return undefined;\n    }\n    return e.value;\n  }\n  set(k: string, v: T, ttlSec = 0) {\n    this.m.set(k, {\n      value: v,\n      expiresAt: ttlSec ? Date.now() + ttlSec * 1000 : 0,\n    });\n  }\n  del(k: string) {\n    this.m.delete(k);\n  }\n}\nexport const cache = new TTLCache<unknown>();\n"],"names":[],"mappings":"AACO,MAAM,SAAY;AAAA,EACf,wBAAQ,IAAA;AAAA,EAChB,IAAI,GAAW;AACb,UAAM,IAAI,KAAK,EAAE,IAAI,CAAC;AACtB,QAAI,CAAC,EAAG,QAAO;AACf,QAAI,EAAE,cAAc,KAAK,KAAK,IAAA,IAAQ,EAAE,WAAW;AACjD,WAAK,EAAE,OAAO,CAAC;AACf,aAAO;AAAA,IACT;AACA,WAAO,EAAE;AAAA,EACX;AAAA,EACA,IAAI,GAAW,GAAM,SAAS,GAAG;AAC/B,SAAK,EAAE,IAAI,GAAG;AAAA,MACZ,OAAO;AAAA,MACP,WAAW,SAAS,KAAK,IAAA,IAAQ,SAAS,MAAO;AAAA,IAAA,CAClD;AAAA,EACH;AAAA,EACA,IAAI,GAAW;AACb,SAAK,EAAE,OAAO,CAAC;AAAA,EACjB;AACF;AACO,MAAM,QAAQ,IAAI,SAAA;"}

package/dist/core/jsonpath.d.ts

@@ -0,0 +1,2 @@
+export declare function jp(obj: unknown, path: string): unknown[];
+//# sourceMappingURL=jsonpath.d.ts.map

package/dist/core/jsonpath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonpath.d.ts","sourceRoot":"","sources":["../../src/core/jsonpath.ts"],"names":[],"mappings":"AAAA,wBAAgB,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAwCxD"}

package/dist/core/jsonpath.js

@@ -0,0 +1,40 @@
+function jp(obj, path) {
+  if (path === "$") return [obj];
+  if (path === "") return [obj];
+  if (!path || typeof path !== "string") return [];
+  if (path.startsWith("$[*]")) {
+    if (!Array.isArray(obj)) return [];
+    const remainingPath = path.slice(4);
+    if (!remainingPath) return obj;
+    if (remainingPath.startsWith(".")) {
+      const subPath = remainingPath.slice(1);
+      const results = [];
+      for (const item of obj) {
+        results.push(...jp(item, subPath));
+      }
+      return results;
+    }
+    return [];
+  }
+  const parts = path.replace(/^\$\./, "").split(".");
+  let current = [obj];
+  for (const part of parts) {
+    const next = [];
+    const m = part.match(/^(\w+)(\[\*\])?$/);
+    if (!m) return [];
+    const key = m[1];
+    if (!key) return [];
+    const star = !!m[2];
+    for (const c of current) {
+      const v = c?.[key];
+      if (star && Array.isArray(v)) next.push(...v);
+      else if (!star && v !== void 0) next.push(v);
+    }
+    current = next;
+  }
+  return current;
+}
+export {
+  jp
+};
+//# sourceMappingURL=jsonpath.js.map

package/dist/core/jsonpath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonpath.js","sources":["../../src/core/jsonpath.ts"],"sourcesContent":["export function jp(obj: unknown, path: string): unknown[] {\n  // naive: support \"$.a.b[*].c\" & \"$.items[*]\"\n  if (path === \"$\") return [obj];\n  if (path === \"\") return [obj]; // Empty string should behave like \"$\"\n  if (!path || typeof path !== \"string\") return [];\n\n  // Handle array at root with $[*]\n  if (path.startsWith(\"$[*]\")) {\n    if (!Array.isArray(obj)) return [];\n    const remainingPath = path.slice(4); // Remove \"$[*]\"\n    if (!remainingPath) return obj;\n    if (remainingPath.startsWith(\".\")) {\n      // Continue with remaining path for each array element\n      const subPath = remainingPath.slice(1);\n      const results: unknown[] = [];\n      for (const item of obj) {\n        results.push(...jp(item, subPath));\n      }\n      return results;\n    }\n    return [];\n  }\n\n  const parts = path.replace(/^\\$\\./, \"\").split(\".\");\n  let current: unknown[] = [obj];\n  for (const part of parts) {\n    const next: unknown[] = [];\n    const m = part.match(/^(\\w+)(\\[\\*\\])?$/);\n    if (!m) return [];\n    const key = m[1];\n    if (!key) return [];\n    const star = !!m[2];\n    for (const c of current) {\n      const v = (c as Record<string, unknown>)?.[key];\n      if (star && Array.isArray(v)) next.push(...v);\n      else if (!star && v !== undefined) next.push(v);\n    }\n    current = next;\n  }\n  return current;\n}\n"],"names":[],"mappings":"AAAO,SAAS,GAAG,KAAc,MAAyB;AAExD,MAAI,SAAS,IAAK,QAAO,CAAC,GAAG;AAC7B,MAAI,SAAS,GAAI,QAAO,CAAC,GAAG;AAC5B,MAAI,CAAC,QAAQ,OAAO,SAAS,iBAAiB,CAAA;AAG9C,MAAI,KAAK,WAAW,MAAM,GAAG;AAC3B,QAAI,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAA;AAChC,UAAM,gBAAgB,KAAK,MAAM,CAAC;AAClC,QAAI,CAAC,cAAe,QAAO;AAC3B,QAAI,cAAc,WAAW,GAAG,GAAG;AAEjC,YAAM,UAAU,cAAc,MAAM,CAAC;AACrC,YAAM,UAAqB,CAAA;AAC3B,iBAAW,QAAQ,KAAK;AACtB,gBAAQ,KAAK,GAAG,GAAG,MAAM,OAAO,CAAC;AAAA,MACnC;AACA,aAAO;AAAA,IACT;AACA,WAAO,CAAA;AAAA,EACT;AAEA,QAAM,QAAQ,KAAK,QAAQ,SAAS,EAAE,EAAE,MAAM,GAAG;AACjD,MAAI,UAAqB,CAAC,GAAG;AAC7B,aAAW,QAAQ,OAAO;AACxB,UAAM,OAAkB,CAAA;AACxB,UAAM,IAAI,KAAK,MAAM,kBAAkB;AACvC,QAAI,CAAC,EAAG,QAAO,CAAA;AACf,UAAM,MAAM,EAAE,CAAC;AACf,QAAI,CAAC,IAAK,QAAO,CAAA;AACjB,UAAM,OAAO,CAAC,CAAC,EAAE,CAAC;AAClB,eAAW,KAAK,SAAS;AACvB,YAAM,IAAK,IAAgC,GAAG;AAC9C,UAAI,QAAQ,MAAM,QAAQ,CAAC,EAAG,MAAK,KAAK,GAAG,CAAC;AAAA,eACnC,CAAC,QAAQ,MAAM,OAAW,MAAK,KAAK,CAAC;AAAA,IAChD;AACA,cAAU;AAAA,EACZ;AACA,SAAO;AACT;"}

package/dist/core/registry.d.ts

@@ -0,0 +1,8 @@
+import type { Protocol } from "./types";
+export declare class ProtocolRegistry {
+    private drivers;
+    register(p: Protocol): void;
+    get(name: string): Protocol;
+}
+export declare const registry: ProtocolRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAA+B;IAC9C,QAAQ,CAAC,CAAC,EAAE,QAAQ;IAGpB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;CAK5B;AAED,eAAO,MAAM,QAAQ,kBAAyB,CAAC"}

package/dist/core/registry.js

@@ -0,0 +1,17 @@
+class ProtocolRegistry {
+  drivers = /* @__PURE__ */ new Map();
+  register(p) {
+    this.drivers.set(p.protocol, p);
+  }
+  get(name) {
+    const p = this.drivers.get(name);
+    if (!p) throw new Error(`Protocol '${name}' not registered`);
+    return p;
+  }
+}
+const registry = new ProtocolRegistry();
+export {
+  ProtocolRegistry,
+  registry
+};
+//# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sources":["../../src/core/registry.ts"],"sourcesContent":["import type { Protocol } from \"./types\";\n\nexport class ProtocolRegistry {\n  private drivers = new Map<string, Protocol>();\n  register(p: Protocol) {\n    this.drivers.set(p.protocol, p);\n  }\n  get(name: string): Protocol {\n    const p = this.drivers.get(name);\n    if (!p) throw new Error(`Protocol '${name}' not registered`);\n    return p;\n  }\n}\n\nexport const registry = new ProtocolRegistry();\n"],"names":[],"mappings":"AAEO,MAAM,iBAAiB;AAAA,EACpB,8BAAc,IAAA;AAAA,EACtB,SAAS,GAAa;AACpB,SAAK,QAAQ,IAAI,EAAE,UAAU,CAAC;AAAA,EAChC;AAAA,EACA,IAAI,MAAwB;AAC1B,UAAM,IAAI,KAAK,QAAQ,IAAI,IAAI;AAC/B,QAAI,CAAC,EAAG,OAAM,IAAI,MAAM,aAAa,IAAI,kBAAkB;AAC3D,WAAO;AAAA,EACT;AACF;AAEO,MAAM,WAAW,IAAI,iBAAA;"}

package/dist/core/templating.d.ts

@@ -0,0 +1,3 @@
+export declare function renderTpl(str: string, ctx: unknown): string;
+export declare function renderObj<T = unknown>(obj: unknown, ctx: unknown): T;
+//# sourceMappingURL=templating.d.ts.map

package/dist/core/templating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templating.d.ts","sourceRoot":"","sources":["../../src/core/templating.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAY3D;AACD,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC,CAapE"}

package/dist/core/templating.js

@@ -0,0 +1,32 @@
+function renderTpl(str, ctx) {
+  return str.replace(/\{\{\s*([^}]+)\s*\}\}/g, (_, path) => {
+    const trimmedPath = path.trim();
+    return String(
+      trimmedPath.split(".").reduce((a, k) => {
+        if (a && typeof a === "object" && k in a) {
+          return a[k];
+        }
+        return void 0;
+      }, ctx) ?? ""
+    );
+  });
+}
+function renderObj(obj, ctx) {
+  if (!obj || typeof obj !== "object") return obj;
+  const out = Array.isArray(obj) ? [] : {};
+  for (const [k, v] of Object.entries(obj)) {
+    if (typeof v === "string") {
+      out[k] = renderTpl(v, ctx);
+    } else if (v && typeof v === "object") {
+      out[k] = renderObj(v, ctx);
+    } else {
+      out[k] = v;
+    }
+  }
+  return out;
+}
+export {
+  renderObj,
+  renderTpl
+};
+//# sourceMappingURL=templating.js.map

package/dist/core/templating.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templating.js","sources":["../../src/core/templating.ts"],"sourcesContent":["export function renderTpl(str: string, ctx: unknown): string {\n  return str.replace(/\\{\\{\\s*([^}]+)\\s*\\}\\}/g, (_, path) => {\n    const trimmedPath = path.trim();\n    return String(\n      trimmedPath.split(\".\").reduce((a: unknown, k: string) => {\n        if (a && typeof a === \"object\" && k in a) {\n          return (a as Record<string, unknown>)[k];\n        }\n        return undefined;\n      }, ctx) ?? \"\",\n    );\n  });\n}\nexport function renderObj<T = unknown>(obj: unknown, ctx: unknown): T {\n  if (!obj || typeof obj !== \"object\") return obj as T;\n  const out: Record<string, unknown> | unknown[] = Array.isArray(obj) ? [] : {};\n  for (const [k, v] of Object.entries(obj)) {\n    if (typeof v === \"string\") {\n      (out as Record<string, unknown>)[k] = renderTpl(v, ctx);\n    } else if (v && typeof v === \"object\") {\n      (out as Record<string, unknown>)[k] = renderObj(v, ctx);\n    } else {\n      (out as Record<string, unknown>)[k] = v;\n    }\n  }\n  return out as T;\n}\n"],"names":[],"mappings":"AAAO,SAAS,UAAU,KAAa,KAAsB;AAC3D,SAAO,IAAI,QAAQ,0BAA0B,CAAC,GAAG,SAAS;AACxD,UAAM,cAAc,KAAK,KAAA;AACzB,WAAO;AAAA,MACL,YAAY,MAAM,GAAG,EAAE,OAAO,CAAC,GAAY,MAAc;AACvD,YAAI,KAAK,OAAO,MAAM,YAAY,KAAK,GAAG;AACxC,iBAAQ,EAA8B,CAAC;AAAA,QACzC;AACA,eAAO;AAAA,MACT,GAAG,GAAG,KAAK;AAAA,IAAA;AAAA,EAEf,CAAC;AACH;AACO,SAAS,UAAuB,KAAc,KAAiB;AACpE,MAAI,CAAC,OAAO,OAAO,QAAQ,SAAU,QAAO;AAC5C,QAAM,MAA2C,MAAM,QAAQ,GAAG,IAAI,CAAA,IAAK,CAAA;AAC3E,aAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,GAAG,GAAG;AACxC,QAAI,OAAO,MAAM,UAAU;AACxB,UAAgC,CAAC,IAAI,UAAU,GAAG,GAAG;AAAA,IACxD,WAAW,KAAK,OAAO,MAAM,UAAU;AACpC,UAAgC,CAAC,IAAI,UAAU,GAAG,GAAG;AAAA,IACxD,OAAO;AACJ,UAAgC,CAAC,IAAI;AAAA,IACxC;AAAA,EACF;AACA,SAAO;AACT;"}

package/dist/core/types.d.ts

@@ -0,0 +1,44 @@
+export type ProviderItem = {
+    label: string;
+    value: unknown;
+    meta?: Record<string, unknown>;
+};
+export type ProviderOutput = {
+    items: ProviderItem[];
+    ttl?: number;
+    etag?: string;
+};
+export type ProviderContext = {
+    data: unknown;
+    path: string;
+    signal: AbortSignal;
+    ui?: {
+        query?: string;
+    };
+    auth?: Record<string, unknown>;
+};
+export interface Protocol<Cfg = unknown> {
+    protocol: string;
+    resolve(cfg: Cfg, ctx: ProviderContext): Promise<ProviderOutput>;
+}
+export interface ProviderBinding {
+    ref: string;
+    protocol: string;
+    config?: unknown;
+    auth?: AuthConfig;
+    cacheTTL?: number;
+    load?: "mount" | "onFocus" | "query";
+}
+export type Mapping = {
+    label: string;
+    value: string;
+    meta?: Record<string, string>;
+};
+export interface AuthConfig {
+    use?: string;
+    apiKey?: string | (() => string);
+    bearer?: string | (() => string);
+    token?: string | (() => string);
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AACF,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,EAAE,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,WAAW,QAAQ,CAAC,GAAG,GAAG,OAAO;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;CACtC;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import type { App } from "vue";
+import type { Protocol, AuthConfig } from "./core/types";
+export { cache } from "./core/cache";
+export * from "./core/jsonpath";
+export { registry } from "./core/registry";
+export * from "./core/templating";
+export * from "./core/types";
+export { RestApiProtocol } from "./protocols/rest_api";
+export * as vue from "./vue";
+export interface ProviderConfig {
+    protocols?: Protocol[];
+    auth?: AuthConfig;
+}
+declare const _default: {
+    install(app: App, opts?: ProviderConfig): void;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAG/B,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAElC,cAAc,cAAc,CAAC;AAG7B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAE7B,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;;iBAGc,GAAG,SAAS,cAAc;;AADzC,wBAYE"}

package/dist/index.js

@@ -0,0 +1,30 @@
+import { cache } from "./core/cache.js";
+import { registry } from "./core/registry.js";
+import { jp } from "./core/jsonpath.js";
+import { renderObj, renderTpl } from "./core/templating.js";
+import { RestApiProtocol } from "./protocols/rest_api.js";
+import * as vue_index from "./vue/index.js";
+const index = {
+  install(app, opts) {
+    const reg = registry;
+    if (opts?.protocols) {
+      for (const p of opts.protocols) {
+        reg.register(p);
+      }
+    }
+    app.provide("providerRegistry", reg);
+    app.provide("providerCache", cache);
+    app.provide("providerAuth", opts?.auth ?? {});
+  }
+};
+export {
+  RestApiProtocol,
+  cache,
+  index as default,
+  jp,
+  registry,
+  renderObj,
+  renderTpl,
+  vue_index as vue
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["import type { App } from \"vue\";\nimport { cache as globalCache } from \"./core/cache\";\nimport { registry as globalRegistry } from \"./core/registry\";\nimport type { Protocol, AuthConfig } from \"./core/types\";\n\nexport { cache } from \"./core/cache\";\nexport * from \"./core/jsonpath\";\nexport { registry } from \"./core/registry\";\nexport * from \"./core/templating\";\n// Core exports\nexport * from \"./core/types\";\n\n// Protocol exports\nexport { RestApiProtocol } from \"./protocols/rest_api\";\n\n// Vue exports\nexport * as vue from \"./vue\";\n\nexport interface ProviderConfig {\n  protocols?: Protocol[];\n  auth?: AuthConfig;\n}\n\nexport default {\n  install(app: App, opts?: ProviderConfig) {\n    const reg = globalRegistry;\n    if (opts?.protocols) {\n      for (const p of opts.protocols) {\n        reg.register(p);\n      }\n    }\n    app.provide(\"providerRegistry\", reg);\n    app.provide(\"providerCache\", globalCache);\n    app.provide(\"providerAuth\", opts?.auth ?? {});\n  },\n};\n"],"names":["globalRegistry","globalCache"],"mappings":";;;;;;AAuBA,MAAA,QAAe;AAAA,EACb,QAAQ,KAAU,MAAuB;AACvC,UAAM,MAAMA;AACZ,QAAI,MAAM,WAAW;AACnB,iBAAW,KAAK,KAAK,WAAW;AAC9B,YAAI,SAAS,CAAC;AAAA,MAChB;AAAA,IACF;AACA,QAAI,QAAQ,oBAAoB,GAAG;AACnC,QAAI,QAAQ,iBAAiBC,KAAW;AACxC,QAAI,QAAQ,gBAAgB,MAAM,QAAQ,CAAA,CAAE;AAAA,EAC9C;AACF;"}

package/dist/jsonforms-provider-protocols.css

@@ -0,0 +1,4 @@
+
+.provider-select select[data-v-1ad3fce8] {
+  min-width: 16rem;
+}

package/dist/protocols/rest_api.d.ts

@@ -0,0 +1,22 @@
+import type { Protocol, AuthConfig } from "../core/types";
+export type RestApiCfg = {
+    url: string;
+    method?: "GET" | "POST";
+    headers?: Record<string, string>;
+    query?: Record<string, unknown>;
+    body?: unknown;
+    items: string;
+    map: {
+        label: string;
+        value: string;
+        meta?: Record<string, string>;
+    };
+    paginate?: {
+        cursorPath: string;
+        param: string;
+        maxPages?: number;
+    };
+    auth?: AuthConfig;
+};
+export declare const RestApiProtocol: () => Protocol<RestApiCfg>;
+//# sourceMappingURL=rest_api.d.ts.map

package/dist/protocols/rest_api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest_api.d.ts","sourceRoot":"","sources":["../../src/protocols/rest_api.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,QAAQ,EAGR,UAAU,EACX,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IACrE,QAAQ,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB,CAAC;AA0DF,eAAO,MAAM,eAAe,QAAO,QAAQ,CAAC,UAAU,CA0DpD,CAAC"}

package/dist/protocols/rest_api.js

@@ -0,0 +1,92 @@
+import { jp } from "../core/jsonpath.js";
+import { renderTpl, renderObj } from "../core/templating.js";
+function buildAuthHeaders(auth, globalAuth) {
+  const headers = {};
+  if (!auth) return headers;
+  if (auth.use && globalAuth?.[auth.use]) {
+    const globalValue = globalAuth[auth.use];
+    const value = typeof globalValue === "function" ? globalValue() : globalValue;
+    if (auth.use === "apiKey") {
+      headers["X-API-Key"] = String(value);
+    } else if (auth.use === "bearer") {
+      headers["Authorization"] = `Bearer ${value}`;
+    } else if (auth.use === "token") {
+      headers["Authorization"] = `Token ${value}`;
+    }
+    return headers;
+  }
+  if (auth.apiKey) {
+    const value = typeof auth.apiKey === "function" ? auth.apiKey() : auth.apiKey;
+    headers["X-API-Key"] = String(value);
+  }
+  if (auth.bearer) {
+    const value = typeof auth.bearer === "function" ? auth.bearer() : auth.bearer;
+    headers["Authorization"] = `Bearer ${value}`;
+  }
+  if (auth.token) {
+    const value = typeof auth.token === "function" ? auth.token() : auth.token;
+    headers["Authorization"] = `Token ${value}`;
+  }
+  for (const [key, value] of Object.entries(auth)) {
+    if (!["use", "apiKey", "bearer", "token"].includes(key) && value !== void 0) {
+      const authValue = typeof value === "function" ? value() : value;
+      headers[key] = String(authValue);
+    }
+  }
+  return headers;
+}
+const RestApiProtocol = () => ({
+  protocol: "rest_api",
+  async resolve(cfg, ctx) {
+    const ac = ctx.signal;
+    const out = [];
+    let cursor = null;
+    let page = 0;
+    do {
+      const url = new URL(renderTpl(cfg.url, { data: ctx.data, ui: ctx.ui }));
+      const q = renderObj(cfg.query ?? {}, {
+        data: ctx.data,
+        ui: ctx.ui
+      });
+      for (const [k, v] of Object.entries(q))
+        if (v !== void 0 && v !== "") url.searchParams.set(k, String(v));
+      if (cursor && cfg.paginate)
+        url.searchParams.set(cfg.paginate.param, String(cursor));
+      const baseHeaders = renderObj(cfg.headers ?? {}, {
+        data: ctx.data
+      });
+      const authHeaders = buildAuthHeaders(cfg.auth, ctx.auth);
+      const headers = { ...baseHeaders, ...authHeaders };
+      const method = cfg.method ?? "GET";
+      const requestInit = {
+        method,
+        headers,
+        signal: ac
+      };
+      if (method !== "GET" && cfg.body) {
+        requestInit.body = JSON.stringify(
+          renderObj(cfg.body, { data: ctx.data })
+        );
+      }
+      const res = await fetch(url.toString(), requestInit);
+      if (!res.ok) throw new Error(`REST ${res.status}`);
+      const json = await res.json();
+      const items = jp(json, cfg.items);
+      for (const it of items) {
+        const label = jp(it, cfg.map.label)[0];
+        const value = jp(it, cfg.map.value)[0];
+        const meta = cfg.map.meta ? Object.fromEntries(
+          Object.entries(cfg.map.meta).map(([k, p]) => [k, jp(it, p)[0]])
+        ) : void 0;
+        out.push({ label: String(label ?? ""), value, meta });
+      }
+      cursor = cfg.paginate ? jp(json, cfg.paginate.cursorPath)[0] : null;
+      page += 1;
+    } while (cfg.paginate && cursor && page < (cfg.paginate.maxPages ?? 5));
+    return { items: out, ttl: 300 };
+  }
+});
+export {
+  RestApiProtocol
+};
+//# sourceMappingURL=rest_api.js.map