@yydb/yydb-client 0.0.11 → 0.0.15

package/dist/client.d.ts

@@ -3,7 +3,7 @@ import type { MicroHostHandler, Transport } from './transport.js';
 export type { Frame, MicroHostInvokePayload, MicroRegisterPayload, MsgTypeCode, SchemaVersion, WireErrorBody, WireUdfScalarKind, WireUdfScalarValue, } from './wire.js';
 export type { MicroHostHandler } from './transport.js';
 export { MsgType, encodeFrame, decodeFrame, encodeErrorBody, decodeErrorBody } from './wire.js';
-export { YydbError, YydbErrorCodes, isRetryableYydbCode, isYydbError } from './errors.js';
+export { YydbError, YydbErrorCodes, YydbClientErrorCodes, isYydbError } from './errors.js';
 export type { YydbErrorCode, YydbErrorOptions } from './errors.js';
 export interface ConnectOptions {
     /** `ws://127.0.0.1:7700/wire` or `127.0.0.1:7700` (upgraded to `/wire`). */

package/dist/client.js

@@ -2,7 +2,7 @@ import { decodeErrorBody, decodeKvGetOk, decodeScalarCallOk, decodeSchemaGetOk,
 import { openWebSocketTransport } from './ws.js';
 import { YydbError, YydbErrorCodes } from './errors.js';
 export { MsgType, encodeFrame, decodeFrame, encodeErrorBody, decodeErrorBody } from './wire.js';
-export { YydbError, YydbErrorCodes, isRetryableYydbCode, isYydbError } from './errors.js';
+export { YydbError, YydbErrorCodes, YydbClientErrorCodes, isYydbError } from './errors.js';
 /** Expected reply type and operation label per request type. */
 const REQUESTS = {
     [MsgType.Hello]: { operation: 'hello', ok: MsgType.HelloOk },
@@ -47,6 +47,7 @@ export class Client {
         catch (cause) {
             throw new YydbError(YydbErrorCodes.clientTransportFailure, `connect ${endpoint}: transport failed`, {
                 operation: 'connect',
+                retryable: true,
                 cause,
             });
         }
@@ -122,7 +123,7 @@ export class Client {
             });
         }
         catch (cause) {
-            throw new YydbError(YydbErrorCodes.clientTransportFailure, `${operation}: transport failed`, { operation, cause });
+            throw new YydbError(YydbErrorCodes.clientTransportFailure, `${operation}: transport failed`, { operation, retryable: true, cause });
         }
         if (response.requestId !== requestId) {
             throw new YydbError(YydbErrorCodes.clientRequestIdMismatch, `${operation}: wire response request_id mismatch (got ${response.requestId}, want ${requestId})`, { operation });

package/dist/errors.d.ts

@@ -1,57 +1,12 @@
 /**
- * Host-facing YYDB error surface.
+ * @yydb/yydb-client consumes the same error surface as @yydb/yydb.
  *
- * Every public failure carries a stable `code`: engine codes come from the
- * Rust core (`yydb.schema.invalid`, …) over the wire, client codes are minted
- * locally with the `yydb.client.` prefix. Branch on `code` — `message` is
- * display text only.
+ * YydbError / YydbErrorCodes / YydbClientErrorCodes / isYydbError are re-exported
+ * from {@linkcode @yydb/yydb/shared/errors} so engine code, retryability and
+ * params handling live in exactly one place. Client authors minting
+ * client-local errors (connect failure, request-id mismatch, …) still use
+ * {@link YydbClientErrorCodes} from this package via YydbErrorCodes or the
+ * named export.
  */
-/** Stable codes known to the TypeScript hosts. */
-export declare const YydbErrorCodes: {
-    readonly io: "yydb.io";
-    readonly corrupt: "yydb.corrupt";
-    readonly schemaConflict: "yydb.schema.conflict";
-    readonly schemaInvalid: "yydb.schema.invalid";
-    readonly udfNotFound: "yydb.udf.not_found";
-    readonly udfArity: "yydb.udf.arity";
-    readonly udfFailed: "yydb.udf.failed";
-    readonly udfVersionMismatch: "yydb.udf.version_mismatch";
-    readonly objectNotFound: "yydb.object.not_found";
-    readonly objectCorrupt: "yydb.object.corrupt";
-    readonly unsupported: "yydb.unsupported";
-    readonly protocol: "yydb.protocol";
-    readonly casConflict: "yydb.cas.conflict";
-    readonly leaseUnavailable: "yydb.lease.unavailable";
-    readonly fencingMismatch: "yydb.fencing.mismatch";
-    readonly leaseExpired: "yydb.lease.expired";
-    readonly quotaExceeded: "yydb.quota.exceeded";
-    readonly sessionClosed: "yydb.session.closed";
-    readonly clientInvalidEndpoint: "yydb.client.invalid_endpoint";
-    readonly clientTransportFailure: "yydb.client.transport_failure";
-    readonly clientRequestIdMismatch: "yydb.client.request_id_mismatch";
-    readonly clientUnexpectedResponse: "yydb.client.unexpected_response";
-    readonly clientDecodeFailure: "yydb.client.decode_failure";
-};
-/** A known code, or any future code the engine introduces. */
-export type YydbErrorCode = (typeof YydbErrorCodes)[keyof typeof YydbErrorCodes] | (string & {});
-/** Whether `code` may be retried with the same arguments. */
-export declare function isRetryableYydbCode(code: string): boolean;
-/** Options carried by a {@link YydbError}. */
-export interface YydbErrorOptions {
-    /** Operation that failed (`schemaGet`, `kvPut`, `query`, …). */
-    operation?: string;
-    /** Underlying failure when this error wraps one. */
-    cause?: unknown;
-}
-/** YYDB failure with a stable machine-readable {@link YydbError.code}. */
-export declare class YydbError extends Error {
-    /** Stable code — engine code or `yydb.client.*`. */
-    readonly code: string;
-    /** Operation that failed. */
-    readonly operation: string;
-    /** Whether the same call may be retried. */
-    readonly retryable: boolean;
-    constructor(code: YydbErrorCode, message: string, options?: YydbErrorOptions);
-}
-/** Narrowing helper so callers can branch without `instanceof` imports. */
-export declare function isYydbError(value: unknown): value is YydbError;
+export { YydbError, YydbErrorCodes, YydbClientErrorCodes, isYydbError, } from '@yydb/yydb';
+export type { YydbErrorCode, YydbErrorOptions } from '@yydb/yydb';

package/dist/errors.js

@@ -1,68 +1,11 @@
 /**
- * Host-facing YYDB error surface.
+ * @yydb/yydb-client consumes the same error surface as @yydb/yydb.
  *
- * Every public failure carries a stable `code`: engine codes come from the
- * Rust core (`yydb.schema.invalid`, …) over the wire, client codes are minted
- * locally with the `yydb.client.` prefix. Branch on `code` — `message` is
- * display text only.
+ * YydbError / YydbErrorCodes / YydbClientErrorCodes / isYydbError are re-exported
+ * from {@linkcode @yydb/yydb/shared/errors} so engine code, retryability and
+ * params handling live in exactly one place. Client authors minting
+ * client-local errors (connect failure, request-id mismatch, …) still use
+ * {@link YydbClientErrorCodes} from this package via YydbErrorCodes or the
+ * named export.
  */
-/** Stable codes known to the TypeScript hosts. */
-export const YydbErrorCodes = {
-    io: 'yydb.io',
-    corrupt: 'yydb.corrupt',
-    schemaConflict: 'yydb.schema.conflict',
-    schemaInvalid: 'yydb.schema.invalid',
-    udfNotFound: 'yydb.udf.not_found',
-    udfArity: 'yydb.udf.arity',
-    udfFailed: 'yydb.udf.failed',
-    udfVersionMismatch: 'yydb.udf.version_mismatch',
-    objectNotFound: 'yydb.object.not_found',
-    objectCorrupt: 'yydb.object.corrupt',
-    unsupported: 'yydb.unsupported',
-    protocol: 'yydb.protocol',
-    casConflict: 'yydb.cas.conflict',
-    leaseUnavailable: 'yydb.lease.unavailable',
-    fencingMismatch: 'yydb.fencing.mismatch',
-    leaseExpired: 'yydb.lease.expired',
-    quotaExceeded: 'yydb.quota.exceeded',
-    sessionClosed: 'yydb.session.closed',
-    clientInvalidEndpoint: 'yydb.client.invalid_endpoint',
-    clientTransportFailure: 'yydb.client.transport_failure',
-    clientRequestIdMismatch: 'yydb.client.request_id_mismatch',
-    clientUnexpectedResponse: 'yydb.client.unexpected_response',
-    clientDecodeFailure: 'yydb.client.decode_failure',
-};
-/**
- * Codes where retrying the same operation can legitimately succeed: a socket or
- * lease hiccup, or a compare-and-set that lost a benign race. Every other code
- * needs the caller to change input, schema, or wiring first.
- */
-const RETRYABLE_CODES = new Set([
-    YydbErrorCodes.clientTransportFailure,
-    YydbErrorCodes.casConflict,
-    YydbErrorCodes.leaseUnavailable,
-]);
-/** Whether `code` may be retried with the same arguments. */
-export function isRetryableYydbCode(code) {
-    return RETRYABLE_CODES.has(code);
-}
-/** YYDB failure with a stable machine-readable {@link YydbError.code}. */
-export class YydbError extends Error {
-    /** Stable code — engine code or `yydb.client.*`. */
-    code;
-    /** Operation that failed. */
-    operation;
-    /** Whether the same call may be retried. */
-    retryable;
-    constructor(code, message, options = {}) {
-        super(message, { cause: options.cause });
-        this.name = 'YydbError';
-        this.code = code;
-        this.operation = options.operation ?? 'unknown';
-        this.retryable = isRetryableYydbCode(code);
-    }
-}
-/** Narrowing helper so callers can branch without `instanceof` imports. */
-export function isYydbError(value) {
-    return value instanceof YydbError;
-}
+export { YydbError, YydbErrorCodes, YydbClientErrorCodes, isYydbError, } from '@yydb/yydb';

package/dist/index.d.ts

@@ -3,6 +3,6 @@ export { Client } from './client.js';
 export type { ConnectOptions } from './client.js';
 export { MAGIC, MAGIC_YYDB, MAGIC_YYDS, WIRE_VERSION, WIRE_VERSION_NEXT, HEADER_LEN, MsgType, encodeFrame, decodeFrame, encodeSchemaEnsure, encodeKvGet, encodeKvPut, encodeMicroRegister, encodeScalarCall, encodeErrorBody, decodeErrorBody, decodeScalarCallOk, decodeSchemaGetOk, decodeKvGetOk, } from './wire.js';
 export type { Frame, MicroRegisterPayload, MsgTypeCode, ProductMagic, SchemaVersion, WireErrorBody, WireUdfScalarKind, WireUdfScalarValue, } from './wire.js';
-export { YydbError, YydbErrorCodes, isRetryableYydbCode, isYydbError } from './errors.js';
+export { YydbError, YydbErrorCodes, YydbClientErrorCodes, isYydbError } from './errors.js';
 export type { YydbErrorCode, YydbErrorOptions } from './errors.js';
 export type { MicroHostHandler, Transport } from './transport.js';

package/dist/index.js

@@ -1,4 +1,4 @@
 /** Browser-safe entry (WebSocket). For Node TCP use `@yydb/yydb-client/node`. */
 export { Client } from './client.js';
 export { MAGIC, MAGIC_YYDB, MAGIC_YYDS, WIRE_VERSION, WIRE_VERSION_NEXT, HEADER_LEN, MsgType, encodeFrame, decodeFrame, encodeSchemaEnsure, encodeKvGet, encodeKvPut, encodeMicroRegister, encodeScalarCall, encodeErrorBody, decodeErrorBody, decodeScalarCallOk, decodeSchemaGetOk, decodeKvGetOk, } from './wire.js';
-export { YydbError, YydbErrorCodes, isRetryableYydbCode, isYydbError } from './errors.js';
+export { YydbError, YydbErrorCodes, YydbClientErrorCodes, isYydbError } from './errors.js';

package/dist/node.d.ts

@@ -3,7 +3,7 @@ export { Client } from './client.js';
 export type { ConnectOptions } from './client.js';
 export { MsgType, encodeFrame, decodeFrame, encodeSchemaEnsure, encodeKvGet, encodeKvPut, decodeSchemaGetOk, decodeKvGetOk, encodeErrorBody, decodeErrorBody, } from './wire.js';
 export type { Frame, MsgTypeCode, SchemaVersion, WireErrorBody } from './wire.js';
-export { YydbError, YydbErrorCodes, isRetryableYydbCode, isYydbError } from './errors.js';
+export { YydbError, YydbErrorCodes, YydbClientErrorCodes, isYydbError } from './errors.js';
 export type { YydbErrorCode, YydbErrorOptions } from './errors.js';
 export type { MicroHostHandler, Transport } from './transport.js';
 /** Node entry: TCP by default; `ws://` uses WebSocket. */

package/dist/node.js

@@ -5,7 +5,7 @@ import { normalizeWsUrl } from './transport.js';
 import { YydbError, YydbErrorCodes } from './errors.js';
 export { Client } from './client.js';
 export { MsgType, encodeFrame, decodeFrame, encodeSchemaEnsure, encodeKvGet, encodeKvPut, decodeSchemaGetOk, decodeKvGetOk, encodeErrorBody, decodeErrorBody, } from './wire.js';
-export { YydbError, YydbErrorCodes, isRetryableYydbCode, isYydbError } from './errors.js';
+export { YydbError, YydbErrorCodes, YydbClientErrorCodes, isYydbError } from './errors.js';
 function wantsWebSocket(endpoint) {
     const trimmed = endpoint.trim();
     return trimmed.startsWith('ws://') || trimmed.startsWith('wss://');

package/package.json

@@ -1,38 +1,33 @@
 {
-  "name": "@yydb/yydb-client",
-  "version": "0.0.11",
+  "bugs": {
+    "url": "https://github.com/yy-database/yydb.rs/issues"
+  },
+  "dependencies": {
+    "@yydb/yydb": "0.0.15"
+  },
   "description": "TypeScript client for the YYDB WebSocket and TCP wire protocol",
-  "license": "MPL-2.0",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "~5.3.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
     },
     "./node": {
-      "types": "./dist/node.d.ts",
-      "import": "./dist/node.js"
+      "import": "./dist/node.js",
+      "types": "./dist/node.d.ts"
     }
   },
   "files": [
     "dist",
     "README.md"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "test": "pnpm run build && node --experimental-strip-types --test src/**/*.test.ts"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/yy-database/yydb.git",
-    "directory": "projects/packages/yydb-client"
-  },
-  "homepage": "https://github.com/yy-database/yydb/tree/dev/projects/packages/yydb-client#readme",
-  "bugs": {
-    "url": "https://github.com/yy-database/yydb/issues"
-  },
+  "homepage": "https://github.com/yy-database/yydb.rs/tree/dev/projects/packages/yydb-client#readme",
   "keywords": [
     "yydb",
     "yyds",
@@ -40,14 +35,22 @@
     "wire-protocol",
     "typescript"
   ],
+  "license": "MPL-2.0",
+  "main": "./dist/index.js",
+  "name": "@yydb/yydb-client",
   "publishConfig": {
     "access": "public"
   },
-  "devDependencies": {
-    "@types/node": "^20.10.0",
-    "typescript": "~5.3.0"
+  "repository": {
+    "directory": "projects/packages/yydb-client",
+    "type": "git",
+    "url": "git+https://github.com/yy-database/yydb.rs.git"
   },
-  "engines": {
-    "node": ">=18"
-  }
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "pnpm run build && node --experimental-strip-types --test src/**/*.test.ts"
+  },
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "version": "0.0.15"
 }