@kubun/client 0.5.0 → 0.6.1

package/lib/client.d.ts

@@ -1,9 +1,11 @@
 import { Client, type RequestCall, type StreamCall } from '@enkaku/client';
 import type { Identity, SigningIdentity } from '@enkaku/token';
 import { type Logger } from '@kubun/logger';
-import type { ClientTransport, DeployGraphParams, DeployGraphResult, ExecuteGraphParams, ExecuteGraphResult, ListGraphResult, LoadGraphParams, LoadGraphResult, Protocol } from '@kubun/protocol';
+import type { BeginTransactionParams, BeginTransactionResult, ClientTransport, DeployGraphParams, DeployGraphResult, ExecuteGraphParams, ExecuteGraphResult, ListGraphResult, LoadGraphParams, LoadGraphResult, Protocol, TransactionParams, TransactionResult } from '@kubun/protocol';
+import { type GetRandomValues } from './graphql.js';
 export type MutateGraphParams = ExecuteGraphParams & {
     attachments?: Record<string, string>;
+    transactionID?: string;
 };
 export type KubunClientType = {
     deployGraph: (params: DeployGraphParams) => RequestCall<DeployGraphResult>;
@@ -11,7 +13,10 @@ export type KubunClientType = {
     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>>;
-    mutateGraph: (params: MutateGraphParams, signal?: AbortSignal) => RequestCall<ExecuteGraphResult>;
+    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;
@@ -22,6 +27,7 @@ export type ReadClientParams = {
 };
 export type ClientParams = Omit<ReadClientParams, 'identity'> & {
     identity: SigningIdentity | Promise<SigningIdentity>;
+    getRandomValues?: GetRandomValues;
 };
 export declare class KubunReadClient {
     #private;
@@ -36,6 +42,9 @@ export declare class KubunReadClient {
 export declare class KubunLightClient extends KubunReadClient implements KubunClientType {
     deployGraph(param: DeployGraphParams, signal?: AbortSignal): RequestCall<DeployGraphResult>;
     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>;
+    rollbackTransaction(param: TransactionParams): RequestCall<TransactionResult>;
 }
 export declare class KubunClient extends KubunReadClient implements KubunClientType {
     #private;
@@ -43,4 +52,7 @@ export declare class KubunClient extends KubunReadClient implements KubunClientT
     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>>;
+    beginTransaction(param: BeginTransactionParams): RequestCall<BeginTransactionResult>;
+    commitTransaction(param: TransactionParams): RequestCall<TransactionResult>;
+    rollbackTransaction(param: TransactionParams): RequestCall<TransactionResult>;
 }

package/lib/client.js

@@ -1 +1 @@
-import{Client as t}from"@enkaku/client";import{fromB64 as e}from"@enkaku/codec";import{getKubunLogger as r}from"@kubun/logger";import{GraphQLExecutionError as a,MutationsRunner as n}from"./graphql.js";export class KubunReadClient{#t;constructor(e){let a=e.logger??r("client",{clientID:e.getRandomID?.()??crypto.randomUUID()});this.#t=new t({...e,logger:a})}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:{}},signal:e})}}export class KubunClient extends KubunReadClient{#e;#r;constructor(t){super(t),this.#e=Promise.resolve(t.identity),this.#r=new n}deployGraph(t,e){let r=this.client.request("graph/deploy",{param:t,signal:e});return Object.assign(r.then(t=>(this.#r.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.#r.setSchema(t.id,e),e)),{abort:r.abort,id:r.id,procedure:r.procedure,type:r.type,signal:r.signal})}async #a(t,r,n){let{id:i,...s}=r;this.#r.hasSchema(i)||await this.loadGraph({id:i},n),n.throwIfAborted();let u={identity:await this.#e,loadState:async t=>{let r=(await this.client.request("document/sync",{param:{documents:{[t]:null}}})).states[t];return r?e(r):null},mutations:{}},{errors:o}=await this.#r.execute({context:u,schemaID:i,source:r.text,variables:r.variables});if(null!=o&&0!==o.length)throw new a(o);return await this.client.request("graph/mutate",{id:t,param:{id:i,mutations:u.mutations,...s},signal:n})}mutateGraph(t,e){let r=globalThis.crypto.randomUUID(),a=new AbortController,n=e?AbortSignal.any([a.signal,e]):a.signal;return Object.assign(this.#a(r,t,n),{id:r,abort:()=>a.abort(),signal:n})}}
+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})}}

package/lib/graphql.d.ts

@@ -1,15 +1,18 @@
 import { type SigningIdentity } from '@enkaku/token';
 import type { Context } from '@kubun/graphql';
+import { type HLC } from '@kubun/mutation';
 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);
     get errors(): ReadonlyArray<GraphQLError>;
 }
 export type ExecutionContext = {
+    getRandomValues: GetRandomValues;
+    hlc: HLC;
     identity: SigningIdentity;
-    loadState: (id: string) => Promise<Uint8Array | null>;
     mutations: Record<string, string>;
 };
 export declare function createContext(client: ExecutionContext): Context;

package/lib/graphql.js

@@ -1 +1 @@
-import{stringifyToken as e}from"@enkaku/token";import{createSchema as t}from"@kubun/graphql";import{graphql as a}from"graphql";import{signChangeMutation as r,signRemoveMutation as s,signSetMutation as n}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){return{async executeCreateMutation(a,r,s){let o=globalThis.crypto.getRandomValues(new Uint8Array(12)),c=await n({identity:t.identity,modelID:a,data:r,unique:o});return t.mutations[s.path.key]=e(c),null},async executeSetMutation(a,r,s,o){let c=await n({identity:t.identity,modelID:a,data:s,unique:r});return t.mutations[o.path.key]=e(c),null},async executeUpdateMutation(a,s){let n=await r({loadState:t.loadState,identity:t.identity,docID:a.id,patch:a.patch.map(e=>{let[t,a]=Object.entries(e)[0];return{...a,op:t}}),from:a.from});return t.mutations[s.path.key]=e(n),null},async executeRemoveMutation(a,r){let n=await s({docID:a,identity:t.identity});t.mutations[r.path.key]=e(n)},executeSetModelAccessDefaults:async()=>null,async executeRemoveModelAccessDefaults(){},executeSetDocumentAccessOverride:async()=>null,async executeRemoveDocumentAccessOverride(){}}}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 a({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 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})}}

package/lib/index.d.ts

@@ -1,2 +1,3 @@
 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';

package/lib/mutations.d.ts

@@ -5,8 +5,14 @@ export type IdentityParams = {
     identity: SigningIdentity;
 };
 export type SetMutationParams<Data extends DocumentData = DocumentData> = Omit<CreateSetMutationParams<Data>, 'issuer'> & IdentityParams;
-export declare function signSetMutation<Data extends DocumentData = DocumentData>(params: SetMutationParams<Data>): Promise<SignedToken<SetDocumentMutation>>;
-export type ChangeMutationParams<Data extends DocumentData = DocumentData> = Omit<CreateChangeMutationParams<Data>, 'issuer'> & IdentityParams;
-export declare function signChangeMutation<Data extends DocumentData = DocumentData>(params: ChangeMutationParams<Data>): Promise<SignedToken<ChangeDocumentMutation>>;
+export declare function signSetMutation<Data extends DocumentData = DocumentData>(params: SetMutationParams<Data> | {
+    identity: SigningIdentity;
+    mutation: SetDocumentMutation;
+}): Promise<SignedToken<SetDocumentMutation>>;
+export type ChangeMutationParams = Omit<CreateChangeMutationParams, 'issuer'> & IdentityParams;
+export declare function signChangeMutation(params: ChangeMutationParams | {
+    identity: SigningIdentity;
+    mutation: ChangeDocumentMutation;
+}): Promise<SignedToken<ChangeDocumentMutation>>;
 export type RemoveMutationParams = Omit<CreateRemoveMutationParams, 'issuer'> & IdentityParams;
 export declare function signRemoveMutation(params: RemoveMutationParams): Promise<SignedToken<ChangeDocumentMutation>>;

package/lib/mutations.js

@@ -1 +1 @@
-import{createChangeMutation as n,createRemoveMutation as t,createSetMutation as i}from"@kubun/mutation";export async function signSetMutation(n){let{identity:t,...e}=n,a=await i({...e,issuer:t.id});return await t.signToken(a)}export async function signChangeMutation(t){let{identity:i,...e}=t,a=await n({...e,issuer:i.id});return await i.signToken(a)}export async function signRemoveMutation(n){let{identity:i,...e}=n,a=t({...e,issuer:i.id});return await i.signToken(a)}
+import{createChangeMutation as n,createRemoveMutation as t,createSetMutation as i}from"@kubun/mutation";export async function signSetMutation(n){if("mutation"in n)return await n.identity.signToken(n.mutation);let{identity:t,...e}=n,o=await i({...e,issuer:t.id});return await t.signToken(o)}export function signChangeMutation(t){if("mutation"in t)return t.identity.signToken(t.mutation);let{identity:i,...e}=t,o=n({...e,issuer:i.id});return i.signToken(o)}export function signRemoveMutation(n){let{identity:i,...e}=n,o=t({...e,issuer:i.id});return i.signToken(o)}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubun/client",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "license": "see LICENSE.md",
   "keywords": [],
   "type": "module",
@@ -15,18 +15,18 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@enkaku/client": "^0.13.0",
+    "@enkaku/client": "^0.13.1",
     "@enkaku/codec": "^0.13.0",
     "@enkaku/token": "0.13.0",
-    "graphql": "^16.12.0",
+    "graphql": "^16.13.1",
     "multiformats": "^13.4.2",
-    "@kubun/id": "^0.5.0",
-    "@kubun/logger": "^0.5.0",
-    "@kubun/mutation": "^0.5.0"
+    "@kubun/id": "^0.6.0",
+    "@kubun/logger": "^0.6.1",
+    "@kubun/mutation": "^0.6.0"
   },
   "devDependencies": {
-    "@kubun/graphql": "^0.5.0",
-    "@kubun/protocol": "^0.5.0"
+    "@kubun/protocol": "^0.6.0",
+    "@kubun/graphql": "^0.6.1"
   },
   "scripts": {
     "build:clean": "del lib",