@kubun/client 0.7.0 → 0.8.0

package/lib/client.d.ts

@@ -1,46 +1,50 @@
-import { Client, type RequestCall, type StreamCall } from '@enkaku/client';
+import { Client, type RequestCall } from '@enkaku/client';
+import { type Runtime } from '@enkaku/runtime';
 import type { Identity, SigningIdentity } from '@enkaku/token';
 import { type Logger } from '@kubun/logger';
-import type { BeginTransactionParams, BeginTransactionResult, ClientTransport, DeployGraphParams, DeployGraphResult, ExecuteGraphParams, ExecuteGraphResult, ListGraphResult, LoadGraphParams, LoadGraphResult, Protocol, TransactionParams, TransactionResult } from '@kubun/protocol';
-import { type GetRandomValues } from './graphql.js';
+import type { BeginTransactionParams, BeginTransactionResult, ClientTransport, DeployGraphParams, DeployGraphResult, ExecuteGraphParams, ExecuteGraphResult, GraphQLSource, GraphQLSourceParams, ListGraphResult, LoadGraphParams, LoadGraphResult, Protocol, TransactionParams, TransactionResult } from '@kubun/protocol';
 export type MutateGraphParams = ExecuteGraphParams & {
     attachments?: Record<string, string>;
     transactionID?: string;
 };
+export type GraphSubscription<Data extends Record<string, unknown> = Record<string, unknown>> = RequestCall<AsyncGenerator<ExecuteGraphResult<Data>>>;
 export type KubunClientType = {
     deployGraph: (params: DeployGraphParams) => RequestCall<DeployGraphResult>;
     listGraphs: () => RequestCall<ListGraphResult>;
     loadGraph: (params: LoadGraphParams) => RequestCall<LoadGraphResult>;
     queryGraph: <Data extends Record<string, unknown> = Record<string, unknown>>(params: ExecuteGraphParams, signal?: AbortSignal) => RequestCall<ExecuteGraphResult<Data>>;
-    subscribeToGraph<Data extends Record<string, unknown> = Record<string, unknown>>(params: ExecuteGraphParams, signal?: AbortSignal): StreamCall<ExecuteGraphResult<Data>, ExecuteGraphResult<Data>>;
+    subscribeToGraph<Data extends Record<string, unknown> = Record<string, unknown>>(params: ExecuteGraphParams, signal?: AbortSignal): GraphSubscription<Data>;
     mutateGraph: <Data extends Record<string, unknown> = Record<string, unknown>>(params: MutateGraphParams, signal?: AbortSignal) => RequestCall<ExecuteGraphResult<Data>>;
     beginTransaction: (params: BeginTransactionParams) => RequestCall<BeginTransactionResult>;
     commitTransaction: (params: TransactionParams) => RequestCall<TransactionResult>;
     rollbackTransaction: (params: TransactionParams) => RequestCall<TransactionResult>;
 };
 export type ReadClientParams = {
-    getRandomID?: () => string;
     identity?: Identity | Promise<Identity>;
     logger?: Logger;
+    runtime?: Partial<Runtime>;
     serverID?: string;
     transport: ClientTransport;
 };
 export type ClientParams = Omit<ReadClientParams, 'identity'> & {
     identity: SigningIdentity | Promise<SigningIdentity>;
-    getRandomValues?: GetRandomValues;
 };
 export declare class KubunReadClient {
     #private;
     constructor(params: ReadClientParams);
     /** @internal */
     get client(): Client<Protocol>;
+    /** @internal */
+    protected get logger(): Logger;
     listGraphs(signal?: AbortSignal): RequestCall<ListGraphResult>;
     loadGraph(param: LoadGraphParams, signal?: AbortSignal): RequestCall<LoadGraphResult>;
     queryGraph<Data extends Record<string, unknown> = Record<string, unknown>>(param: ExecuteGraphParams, signal?: AbortSignal): RequestCall<ExecuteGraphResult<Data>>;
-    subscribeToGraph<Data extends Record<string, unknown> = Record<string, unknown>>(param: ExecuteGraphParams, signal?: AbortSignal): StreamCall<ExecuteGraphResult<Data>, ExecuteGraphResult<Data>>;
+    subscribeToGraph<Data extends Record<string, unknown> = Record<string, unknown>>(param: ExecuteGraphParams, signal?: AbortSignal): GraphSubscription<Data>;
+    getGraphQLSource(params: GraphQLSourceParams): GraphQLSource;
 }
 export declare class KubunLightClient extends KubunReadClient implements KubunClientType {
     deployGraph(param: DeployGraphParams, signal?: AbortSignal): RequestCall<DeployGraphResult>;
+    getGraphQLSource(params: GraphQLSourceParams): GraphQLSource;
     mutateGraph<Data extends Record<string, unknown> = Record<string, unknown>>(param: MutateGraphParams, signal?: AbortSignal): RequestCall<ExecuteGraphResult<Data>>;
     beginTransaction(param: BeginTransactionParams): RequestCall<BeginTransactionResult>;
     commitTransaction(param: TransactionParams): RequestCall<TransactionResult>;
@@ -49,6 +53,7 @@ export declare class KubunLightClient extends KubunReadClient implements KubunCl
 export declare class KubunClient extends KubunReadClient implements KubunClientType {
     #private;
     constructor(params: ClientParams);
+    getGraphQLSource(params: GraphQLSourceParams): GraphQLSource;
     deployGraph(param: DeployGraphParams, signal?: AbortSignal): RequestCall<DeployGraphResult>;
     loadGraph(param: LoadGraphParams, signal?: AbortSignal): RequestCall<LoadGraphResult>;
     mutateGraph<Data extends Record<string, unknown> = Record<string, unknown>>(param: MutateGraphParams, signal?: AbortSignal): RequestCall<ExecuteGraphResult<Data>>;

package/lib/client.js

@@ -1 +1 @@
-import{Client as t}from"@enkaku/client";import{getKubunLogger as e}from"@kubun/logger";import{HLC as r}from"@kubun/mutation";import{GraphQLExecutionError as a,MutationsRunner as n}from"./graphql.js";export class KubunReadClient{#t;constructor(r){let a=r.getRandomID??(()=>globalThis.crypto.randomUUID()),n=r.logger??e("client",{clientID:a()});this.#t=new t({...r,logger:n})}get client(){return this.#t}listGraphs(t){return this.#t.request("graph/list",{signal:t})}loadGraph(t,e){return this.#t.request("graph/load",{param:t,signal:e})}queryGraph(t,e){return this.#t.request("graph/query",{param:t,signal:e})}subscribeToGraph(t,e){return this.#t.createStream("graph/subscribe",{param:t,signal:e})}}export class KubunLightClient extends KubunReadClient{deployGraph(t,e){return this.client.request("graph/deploy",{param:t,signal:e})}mutateGraph(t,e){return this.client.request("graph/mutate",{param:{...t,mutations:null},signal:e})}beginTransaction(t){return this.client.request("graph/beginTransaction",{param:t})}commitTransaction(t){return this.client.request("graph/commitTransaction",{param:t})}rollbackTransaction(t){return this.client.request("graph/rollbackTransaction",{param:t})}}export class KubunClient extends KubunReadClient{#e;#r;#a;#n;constructor(t){super(t),this.#e=t.getRandomID??(()=>globalThis.crypto.randomUUID()),this.#r=t.getRandomValues??(t=>globalThis.crypto.getRandomValues(t)),this.#a=Promise.resolve(t.identity),this.#n=new n}deployGraph(t,e){let r=this.client.request("graph/deploy",{param:t,signal:e});return Object.assign(r.then(t=>(this.#n.setSchema(t.id,t),t)),{abort:r.abort,id:r.id,procedure:r.procedure,type:r.type,signal:r.signal})}loadGraph(t,e){let r=super.loadGraph(t,e);return Object.assign(r.then(e=>(this.#n.setSchema(t.id,e),e)),{abort:r.abort,id:r.id,procedure:r.procedure,type:r.type,signal:r.signal})}async #i(t,e,n){let{id:i,...s}=e;if(this.#n.hasSchema(i)||await this.loadGraph({id:i},n),n.aborted)throw n.reason??new DOMException("The operation was aborted.","AbortError");let o=await this.#a,u={getRandomValues:this.#r,hlc:new r({nodeID:o.id}),identity:o,mutations:{}},{errors:l}=await this.#n.execute({context:u,schemaID:i,source:e.text,variables:e.variables});if(null!=l&&0!==l.length)throw new a(l);return await this.client.request("graph/mutate",{id:t,param:{id:i,mutations:u.mutations,...s},signal:n})}mutateGraph(t,e){let r=this.#e(),a=new AbortController,n=e?AbortSignal.any([a.signal,e]):a.signal;return Object.assign(this.#i(r,t,n),{id:r,abort:()=>a.abort(),signal:n})}beginTransaction(t){return this.client.request("graph/beginTransaction",{param:t})}commitTransaction(t){return this.client.request("graph/commitTransaction",{param:t})}rollbackTransaction(t){return this.client.request("graph/rollbackTransaction",{param:t})}}
+import{Client as e,RequestError as r}from"@enkaku/client";import{createRuntime as t}from"@enkaku/runtime";import{HLC as a}from"@kubun/hlc";import{getKubunLogger as i}from"@kubun/logger";import{GraphQLExecutionError as s,MutationsRunner as n}from"./graphql.js";export class KubunReadClient{#e;#r;constructor(r){let a=t(r.runtime),s=r.logger??i("client",{clientID:a.getRandomID()});this.#e=new e({...r,logger:s,runtime:a}),this.#r=s}get client(){return this.#e}get logger(){return this.#r}listGraphs(e){return this.#e.request("graph/list",{signal:e})}loadGraph(e,r){return this.#e.request("graph/load",{param:e,signal:r})}queryGraph(e,r){this.#r.debug("queryGraph graph={id} query={text}",{id:e.id,text:e.text.slice(0,200)});let t=performance.now(),a=this.#e.request("graph/query",{param:e,signal:r});return Object.assign(a.then(e=>{let r=Math.round((performance.now()-t)*100)/100;return this.#r.debug("queryGraph completed duration={duration}ms errors={hasErrors}",{duration:String(r),hasErrors:String(null!=e.errors&&e.errors.length>0)}),e},e=>{throw this.#r.error("queryGraph failed: {error}",{error:String(e)}),e}),{abort:a.abort,id:a.id,procedure:a.procedure,type:a.type,signal:a.signal})}subscribeToGraph(e,r){this.#r.debug("subscribeToGraph graph={id} query={text}",{id:e.id,text:e.text.slice(0,200)});let t=this.#e.createStream("graph/subscribe",{param:e,signal:r});return t.catch(()=>{}),Object.assign(Promise.resolve(async function*(){let e=t.readable.getReader();try{for(;;){let{done:r,value:t}=await e.read();if(r)break;yield t}}finally{e.releaseLock()}}()),{id:t.id,type:t.type,procedure:t.procedure,abort:()=>t.close(),signal:t.signal})}getGraphQLSource(e){let{graphID:r}=e;return{query:async e=>await this.queryGraph({id:r,text:e.text,variables:e.variables}),mutate:async()=>{throw Error("KubunReadClient does not support mutations")},subscribe:async e=>await this.subscribeToGraph({id:r,text:e.text,variables:e.variables})}}}export class KubunLightClient extends KubunReadClient{deployGraph(e,r){return this.client.request("graph/deploy",{param:e,signal:r})}getGraphQLSource(e){let{graphID:r}=e;return{query:async e=>await this.queryGraph({id:r,text:e.text,variables:e.variables}),mutate:async e=>await this.mutateGraph({id:r,text:e.text,variables:e.variables}),subscribe:async e=>await this.subscribeToGraph({id:r,text:e.text,variables:e.variables})}}mutateGraph(e,t){this.logger.debug("mutateGraph graph={id} query={text}",{id:e.id,text:e.text.slice(0,200)});let a=performance.now(),i=this.client.request("graph/mutate",{param:{...e,mutations:null},signal:t});return Object.assign(i.then(e=>{let r=Math.round((performance.now()-a)*100)/100;return this.logger.debug("mutateGraph completed duration={duration}ms errors={hasErrors}",{duration:String(r),hasErrors:String(null!=e.errors&&e.errors.length>0)}),e},e=>{throw e instanceof r?this.logger.error("mutateGraph failed: code={code} message={message} data={data}",{code:e.code,message:e.message,data:e.data}):this.logger.error("mutateGraph failed: {error}",{error:String(e)}),e}),{abort:i.abort,id:i.id,procedure:i.procedure,type:i.type,signal:i.signal})}beginTransaction(e){return this.client.request("graph/beginTransaction",{param:e})}commitTransaction(e){return this.client.request("graph/commitTransaction",{param:e})}rollbackTransaction(e){return this.client.request("graph/rollbackTransaction",{param:e})}}export class KubunClient extends KubunReadClient{#t;#a;#i;constructor(e){super(e),this.#i=t(e.runtime),this.#t=Promise.resolve(e.identity),this.#a=new n}getGraphQLSource(e){let{graphID:r}=e;return{query:async e=>await this.queryGraph({id:r,text:e.text,variables:e.variables}),mutate:async e=>await this.mutateGraph({id:r,text:e.text,variables:e.variables}),subscribe:async e=>await this.subscribeToGraph({id:r,text:e.text,variables:e.variables})}}deployGraph(e,r){let t=this.client.request("graph/deploy",{param:e,signal:r});return Object.assign(t.then(e=>(this.#a.setSchema(e.id,e),e)),{abort:t.abort,id:t.id,procedure:t.procedure,type:t.type,signal:t.signal})}loadGraph(e,r){let t=super.loadGraph(e,r);return Object.assign(t.then(r=>(this.#a.setSchema(e.id,r),r)),{abort:t.abort,id:t.id,procedure:t.procedure,type:t.type,signal:t.signal})}async #s(e,t,i){this.logger.debug("mutateGraph graph={id} query={text}",{id:t.id,text:t.text.slice(0,200)});let n=performance.now();try{let{id:r,...o}=t;if(this.#a.hasSchema(r)||await this.loadGraph({id:r},i),i.aborted)throw i.reason??new DOMException("The operation was aborted.","AbortError");let u=await this.#t,l={getRandomValues:this.#i.getRandomValues,hlc:new a({nodeID:u.id}),identity:u,mutations:{}},{errors:h}=await this.#a.execute({context:l,schemaID:r,source:t.text,variables:t.variables});if(null!=h&&0!==h.length)throw this.logger.error("mutateGraph pre-execution failed: {errorCount} error(s): {details}",{errorCount:String(h.length),details:h.map(e=>`${e.message} (path: ${e.path?.join(".")??"root"})`).join("; ")}),new s(h);let c=await this.client.request("graph/mutate",{id:e,param:{id:r,mutations:l.mutations,...o},signal:i}),g=Math.round((performance.now()-n)*100)/100;return this.logger.debug("mutateGraph completed duration={duration}ms errors={hasErrors}",{duration:String(g),hasErrors:String(null!=c.errors&&c.errors.length>0)}),c}catch(e){throw e instanceof r?this.logger.error("mutateGraph failed: code={code} message={message} data={data}",{code:e.code,message:e.message,data:e.data}):this.logger.error("mutateGraph failed: {error}",{error:String(e)}),e}}mutateGraph(e,r){let t=this.#i.getRandomID(),a=new AbortController,i=r?AbortSignal.any([a.signal,r]):a.signal;return Object.assign(this.#s(t,e,i),{id:t,abort:()=>a.abort(),signal:i})}beginTransaction(e){return this.client.request("graph/beginTransaction",{param:e})}commitTransaction(e){return this.client.request("graph/commitTransaction",{param:e})}rollbackTransaction(e){return this.client.request("graph/rollbackTransaction",{param:e})}}

package/lib/graphql.d.ts

@@ -1,9 +1,9 @@
+import type { GetRandomValues } from '@enkaku/runtime';
 import { type SigningIdentity } from '@enkaku/token';
 import type { Context } from '@kubun/graphql';
-import { type HLC } from '@kubun/mutation';
+import type { HLC } from '@kubun/hlc';
 import type { GraphModelJSON } from '@kubun/protocol';
 import type { ExecutionResult, GraphQLError, GraphQLSchema } from 'graphql';
-export type GetRandomValues = <T extends ArrayBufferView>(array: T) => T;
 export declare class GraphQLExecutionError extends Error {
     #private;
     constructor(errors: ReadonlyArray<GraphQLError>, message?: string);

package/lib/graphql.js

@@ -1 +1 @@
-import{stringifyToken as e}from"@enkaku/token";import{createSchema as t}from"@kubun/graphql";import{convertPatchInput as a,createMutationOperations as r}from"@kubun/mutation";import{graphql as n}from"graphql";import{signChangeMutation as o,signSetMutation as s}from"./mutations.js";export class GraphQLExecutionError extends Error{#e;constructor(e,t="GraphQL execution failed"){super(t),this.name=GraphQLExecutionError.name,this.#e=e}get errors(){return this.#e}}export function createContext(t){let n=r({issuer:t.identity.id,hlc:t.hlc,getRandomValues:t.getRandomValues,processSetMutation:async a=>e(await s({identity:t.identity,mutation:a})),processChangeMutation:async a=>e(await o({identity:t.identity,mutation:a}))});return{executeCreateMutation:async({modelID:e,data:a,info:r})=>(t.mutations[r.path.key]=await n.createDocument({modelID:e,data:a}),null),executeSetMutation:async({modelID:e,unique:a,data:r,info:o})=>(t.mutations[o.path.key]=await n.setDocument({modelID:e,unique:a,data:r}),null),executeUpdateMutation:async({input:e,info:r})=>(t.mutations[r.path.key]=await n.updateDocument({docID:e.id,patch:a(e.patch)}),null),async executeRemoveMutation({id:e,info:a}){t.mutations[a.path.key]=await n.removeDocument({docID:e})},executeSetModelAccessDefaults:async()=>null,async executeRemoveModelAccessDefaults(){},executeSetDocumentAccessOverride:async()=>null,async executeRemoveDocumentAccessOverride(){},beginTransaction(){throw Error("Transaction mutations are not supported in client mode")},async commitTransaction(){throw Error("Transaction mutations are not supported in client mode")},rollbackTransaction(){throw Error("Transaction mutations are not supported in client mode")}}}export class MutationsRunner{#t;constructor(e={}){this.#t=e.schemas??{}}hasSchema(e){return null!=this.#t[e]}setSchema(e,a){this.#t[e]=Promise.resolve(a).then(t)}async execute(e){let t=this.#t[e.schemaID];if(null==t)throw Error(`Schema ${e.schemaID} not found`);return await n({contextValue:createContext(e.context),schema:await t,source:e.source,variableValues:e.variables})}}
+import{stringifyToken as e}from"@enkaku/token";import{createSchema as t}from"@kubun/graphql";import{convertPatchInput as n,createMutationOperations as a}from"@kubun/mutation";import{graphql as o}from"graphql";import{signChangeMutation as s,signSetMutation as r}from"./mutations.js";export class GraphQLExecutionError extends Error{#e;constructor(e,t="GraphQL execution failed"){super(t),this.name=GraphQLExecutionError.name,this.#e=e}get errors(){return this.#e}}export function createContext(t){let o=a({issuer:t.identity.id,hlc:t.hlc,getRandomValues:t.getRandomValues,processSetMutation:async n=>e(await r({identity:t.identity,mutation:n})),processChangeMutation:async n=>e(await s({identity:t.identity,mutation:n}))});return{getViewer:()=>null,loadDocument:async()=>null,resolveConnection:async()=>({edges:[],pageInfo:{hasNextPage:!1,hasPreviousPage:!1}}),resolveList:async()=>[],resolveCount:async()=>0,searchDocuments:async()=>[],subscribeToDocumentCreated:()=>null,subscribeToDocumentChanged:()=>null,subscribeToDocumentRemoved:()=>null,subscribeToDocumentEdgeAdded:()=>null,subscribeToDocumentEdgeRemoved:()=>null,executeCreateMutation:async({modelID:e,data:n,info:a})=>(t.mutations[a.path.key]=await o.createDocument({modelID:e,data:n}),null),executeSetMutation:async({modelID:e,unique:n,data:a,info:s})=>(t.mutations[s.path.key]=await o.setDocument({modelID:e,unique:n,data:a}),null),executeUpdateMutation:async({input:e,info:a})=>(t.mutations[a.path.key]=await o.updateDocument({docID:e.id,patch:n(e.patch)}),null),async executeRemoveMutation({id:e,info:n}){t.mutations[n.path.key]=await o.removeDocument({docID:e})},executeSetModelAccessDefaults:async()=>null,async executeRemoveModelAccessDefaults(){},executeSetDocumentAccessOverride:async()=>null,async executeRemoveDocumentAccessOverride(){},beginTransaction(){throw Error("Transaction mutations are not supported in client mode")},async commitTransaction(){throw Error("Transaction mutations are not supported in client mode")},rollbackTransaction(){throw Error("Transaction mutations are not supported in client mode")}}}export class MutationsRunner{#t;constructor(e={}){this.#t=e.schemas??{}}hasSchema(e){return null!=this.#t[e]}setSchema(e,n){this.#t[e]=Promise.resolve(n).then(e=>t({...e,stubExtensionResolvers:!0}))}async execute(e){let t=this.#t[e.schemaID];if(null==t)throw Error(`Schema ${e.schemaID} not found`);return await o({contextValue:createContext(e.context),schema:await t,source:e.source,variableValues:e.variables})}}

package/lib/index.d.ts

@@ -1,3 +1,2 @@
 export { type Attachment, createAttachment, toAttachmentsRecord } from './attachments.js';
-export { type ClientParams, KubunClient, type KubunClientType, KubunLightClient, KubunReadClient, type MutateGraphParams, type ReadClientParams, } from './client.js';
-export type { GetRandomValues } from './graphql.js';
+export { type ClientParams, type GraphSubscription, KubunClient, type KubunClientType, KubunLightClient, KubunReadClient, type MutateGraphParams, type ReadClientParams, } from './client.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubun/client",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "license": "see LICENSE.md",
   "keywords": [],
   "type": "module",
@@ -15,18 +15,20 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@enkaku/client": "^0.14.0",
+    "@enkaku/runtime": "^0.14.0",
+    "@enkaku/client": "^0.14.3",
     "@enkaku/codec": "^0.14.0",
-    "@enkaku/token": "0.14.0",
-    "graphql": "^16.13.1",
+    "@enkaku/token": "0.14.1",
+    "graphql": "^16.13.2",
     "multiformats": "^13.4.2",
-    "@kubun/mutation": "^0.7.0",
-    "@kubun/id": "^0.7.0",
-    "@kubun/logger": "^0.7.0"
+    "@kubun/hlc": "^0.8.0",
+    "@kubun/logger": "^0.8.0",
+    "@kubun/id": "^0.8.0",
+    "@kubun/mutation": "^0.8.0"
   },
   "devDependencies": {
-    "@kubun/protocol": "^0.7.0",
-    "@kubun/graphql": "^0.7.0"
+    "@kubun/graphql": "^0.8.0",
+    "@kubun/protocol": "^0.8.0"
   },
   "scripts": {
     "build:clean": "del lib",