@xyo-network/xl1-protocol-lib 1.29.3 → 1.29.4

package/dist/neutral/providers/DataLake/Client.d.ts

@@ -0,0 +1,56 @@
+import type { Hash } from '@xylabs/sdk-js';
+import type { Schema } from '@xyo-network/sdk-js';
+import type { DataLakeData } from './Provider.ts';
+/** Capability the dApp is asking for when calling `requestAccess`. */
+export type DataLakeCapability = 'viewer' | 'runner' | {
+    read?: boolean;
+    write?: boolean;
+};
+/** Options the dApp passes when requesting access to a data lake. */
+export interface DataLakeRequestAccessOptions {
+    capability: DataLakeCapability;
+    /** Optional schema filter — the wallet's picker only shows lakes whose policy is compatible. */
+    schemas?: Schema[];
+}
+/**
+ * A data lake the user has approved for this origin.
+ *
+ * The wallet redacts the lake's friendly name, endpoint, and internal id; the
+ * page only ever sees the opaque `id` (a fresh-per-grant UUID minted by the
+ * wallet) plus the public policy declared on the lake itself.
+ */
+export interface ApprovedDataLake {
+    allowedSchemas?: Schema[];
+    capabilities: ('viewer' | 'runner')[];
+    disallowedSchemas?: Schema[];
+    /** Per-origin opaque handle. Pass to `get` / `insert`. Uncorrelated across origins. */
+    id: string;
+}
+/**
+ * Page-side surface for wallet-mediated data lake access. Injected onto
+ * `globalThis.xyo.dataLakes` by the wallet's content-script. Every call is
+ * proxied through the wallet's service worker, which performs the per-origin
+ * permission check and the actual network I/O — the page never sees the
+ * lake's endpoint or access token.
+ */
+export interface DataLakesClient {
+    /** Fetch payloads by hash from the lake bound to `id`. Missing hashes are skipped silently. */
+    get: (id: string, hashes: Hash[]) => Promise<DataLakeData[]>;
+    /** Write payloads to the lake bound to `id`. Requires the grant to include the `runner` capability. */
+    insert: (id: string, payloads: DataLakeData[]) => Promise<DataLakeData[]>;
+    /** Approved lakes for this origin. Returns an empty list before any grant exists. */
+    list: () => Promise<ApprovedDataLake[]>;
+    /**
+     * Trigger the wallet's lake-picker popup. Resolves with the per-origin
+     * opaque `id` of the chosen lake once the user approves. Rejected if the
+     * user denies or no lakes match the requested capability + schemas.
+     *
+     * A combined `{ read: true, write: true }` request issues a single picker;
+     * the user picks one lake and both viewer and runner grants share the same
+     * `id`.
+     */
+    requestAccess: (options: DataLakeRequestAccessOptions) => Promise<{
+        id: string;
+    }>;
+}
+//# sourceMappingURL=Client.d.ts.map

package/dist/neutral/providers/DataLake/Client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../../../../src/providers/DataLake/Client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAEjD,sEAAsE;AACtE,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAE1F,qEAAqE;AACrE,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,kBAAkB,CAAA;IAC9B,gGAAgG;IAChG,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,YAAY,EAAE,CAAC,QAAQ,GAAG,QAAQ,CAAC,EAAE,CAAA;IACrC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,uFAAuF;IACvF,EAAE,EAAE,MAAM,CAAA;CACX;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,+FAA+F;IAC/F,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IAE5D,uGAAuG;IACvG,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IAEzE,qFAAqF;IACrF,IAAI,EAAE,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAA;IACvC;;;;;;;;OAQG;IACH,aAAa,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAElF"}

package/dist/neutral/providers/DataLake/index.d.ts

@@ -1,3 +1,4 @@
+export * from './Client.ts';
 export * from './Provider.ts';
 export * from './Runner.ts';
 export * from './Viewer.ts';

package/dist/neutral/providers/DataLake/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/providers/DataLake/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/providers/DataLake/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/dist/neutral/providers/XyoClient.d.ts

@@ -1,5 +1,6 @@
 import type { GatewayName } from '@xyo-network/xl1-protocol-model';
 import type { XyoPermissions } from '../permissions/index.ts';
+import type { DataLakesClient } from './DataLake/index.ts';
 import type { XyoGateway } from './XyoGateway.ts';
 import type { XyoGatewayRunner } from './XyoGatewayRunner.ts';
 /** @deprecated */
@@ -13,6 +14,7 @@ export interface XyoRpcGatewayConfig extends XyoGatewayConfig {
 }
 /** XyoClient interface. */
 export interface XyoClient {
+    dataLakes?: DataLakesClient;
     gateways: Readonly<Partial<Record<GatewayName, XyoGatewayRunner>>>;
     permissions: XyoPermissions;
     /** @deprecated */

package/dist/neutral/providers/XyoClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"XyoClient.d.ts","sourceRoot":"","sources":["../../../src/providers/XyoClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAElE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,kBAAkB;AAClB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAA;CAClB;AAED,kBAAkB;AAElB,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,2BAA2B;AAC3B,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;IAClE,WAAW,EAAE,cAAc,CAAA;IAE3B,kBAAkB;IAElB,UAAU,CAAC,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACvG,kBAAkB;IAClB,aAAa,CAAC,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACjD"}
+{"version":3,"file":"XyoClient.d.ts","sourceRoot":"","sources":["../../../src/providers/XyoClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAElE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,kBAAkB;AAClB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAA;CAClB;AAED,kBAAkB;AAElB,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,2BAA2B;AAC3B,MAAM,WAAW,SAAS;IACxB,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;IAClE,WAAW,EAAE,cAAc,CAAA;IAE3B,kBAAkB;IAElB,UAAU,CAAC,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACvG,kBAAkB;IAClB,aAAa,CAAC,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACjD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyo-network/xl1-protocol-lib",
-  "version": "1.29.3",
+  "version": "1.29.4",
   "description": "XYO Layer One Protocol",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -34,7 +34,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@xyo-network/xl1-protocol-model": "~1.29.3"
+    "@xyo-network/xl1-protocol-model": "~1.29.4"
   },
   "devDependencies": {
     "@bitauth/libauth": "~3.0.0",