@yydb/yydb 0.1.6 → 0.1.7

package/README.md

@@ -101,6 +101,6 @@ The native binding exposes additive operations (`schemaVersion`, `schemaDocument
 Electron: main process can use `@yydb/yydb`; renderer code can use `@yydb/yydb-client` against the main-process
 endpoint.
 
-The managed engine listens on `127.0.0.1` with no authentication — keep the endpoint private.
+The managed engine listens on `127.0.0.1` with no authentication �?keep the endpoint private.
 
-[YYDB overview](https://github.com/yy-database/yydb) · [User guides](https://github.com/yy-database/yydb/tree/dev/projects/packages/homepage/documentation/zh-hans)
+[YYDB overview](https://github.com/yy-database/yydb) · [User guides](https://github.com/yy-database/yydb/tree/dev/projects/yydb.ts/homepage/documentation/zh-hans)

package/dist/api/database.d.ts

@@ -77,6 +77,84 @@ export interface CompactReport {
 }
 /** Declared type for a prepared statement parameter slot. */
 export type SlotType = 'any' | 'bool' | 'i64' | 'text' | 'null';
+/**
+ * Tagged JSON form of an exact `date` value (days since the Unix epoch,
+ * proleptic Gregorian calendar, UTC-free).
+ */
+export interface DateScalar {
+    readonly $yydb: 'date';
+    readonly days: number;
+}
+/** Tagged JSON form of an exact `time` value (nanoseconds since midnight, no zone). */
+export interface TimeScalar {
+    readonly $yydb: 'time';
+    readonly nanos: number;
+}
+/**
+ * Tagged JSON form of an exact `timestamp` value (microseconds since the Unix
+ * epoch). Always UTC, encoded as a decimal string to avoid precision loss.
+ */
+export interface TimestampScalar {
+    readonly $yydb: 'timestamp';
+    readonly utcMicros: string;
+}
+/**
+ * Tagged JSON form of an exact fixed-point `decimal` value. `unscaled` is the
+ * decimal string of the integer significand scaled by `scale`.
+ */
+export interface DecimalScalar {
+    readonly $yydb: 'decimal';
+    readonly precision: number;
+    readonly scale: number;
+    readonly unscaled: string;
+}
+/** Every exact scalar crossing the JSON wire boundary uses this tagged form. */
+export type ScalarValue = DateScalar | TimeScalar | TimestampScalar | DecimalScalar;
+/** Declared execution type of a catalog field. */
+export type SchemaFieldType = {
+    readonly kind: 'null' | 'bool' | 'i64' | 'text' | 'bytes' | 'file' | 'date';
+} | {
+    readonly kind: 'time';
+    readonly unit: 'nanosecond';
+    readonly timezone: 'none';
+} | {
+    readonly kind: 'timestamp';
+    readonly unit: 'microsecond';
+    readonly timezone: 'utc';
+} | {
+    readonly kind: 'decimal';
+    readonly precision: number;
+    readonly scale: number;
+} | {
+    readonly kind: 'vector';
+    readonly dimension: number;
+    readonly metric: 'cosine' | 'euclidean' | 'dot';
+} | {
+    readonly kind: 'record';
+    readonly schemaId: number;
+    readonly fieldCount: number;
+};
+/** One uniqueness rule published by the catalog. */
+export interface UniqueConstraintDescriptor {
+    readonly name: string;
+    readonly columns: string[];
+    /** `true` means NULLs never collide (SQL default); `false` means one shared NULL. */
+    readonly nullsDistinct: boolean;
+}
+/** One field in an introspected table. */
+export interface SchemaFieldDescriptor {
+    readonly name: string;
+    readonly fieldId: number;
+    readonly virtualField: number;
+    readonly type: SchemaFieldType;
+}
+/** One introspected table with its declared field types and uniqueness rules. */
+export interface SchemaTableDescriptor {
+    readonly name: string;
+    readonly schemaId: number;
+    readonly fields: SchemaFieldDescriptor[];
+    readonly uniqueConstraints: UniqueConstraintDescriptor[];
+}
 /** One named parameter descriptor on a {@link Statement}. */
 export interface ParameterDescriptor {
     /** Canonical parameter name (no leading `$`). */

package/dist/index.d.ts

@@ -1,7 +1,8 @@
-export { Database, Statement, type OpenOptions, type SchemaVersion, type ParameterDescriptor, type QueryKind, type SlotType, type StatementInfo } from './api/database.js';
+export { Database, Statement, type DateScalar, type DecimalScalar, type OpenOptions, type ParameterDescriptor, type QueryKind, type ScalarValue, type SchemaFieldDescriptor, type SchemaFieldType, type SchemaTableDescriptor, type SchemaVersion, type SlotType, type StatementInfo, type TimeScalar, type TimestampScalar, type UniqueConstraintDescriptor, } from './api/database.js';
 export { YydbError, YydbErrorCodes, YydbClientErrorCodes, isYydbError } from './shared/errors.js';
 export type { YydbErrorCode, YydbErrorOptions } from './shared/errors.js';
 export { defineMicro, type DefinedMicro, type MicroHandle, type TsMicroDefinitionInput, MicroSessionRegistry } from './shared/micro.js';
 export { type InferUdfArgs, type InferUdfReturn, type MicroEffect, type MicroInvocationMode, type UdfScalarDescriptor, type UdfScalarKind, } from './shared/udf-types.js';
 export { nativeBindingName, platformKey, resolveYydbBinary, resolveYydbCli } from './native/resolve.js';
+export { loadNative } from './native/binding.js';
 export * from './shared/vos.js';

package/dist/index.js

@@ -1,5 +1,6 @@
-export { Database, Statement } from './api/database.js';
+export { Database, Statement, } from './api/database.js';
 export { YydbError, YydbErrorCodes, YydbClientErrorCodes, isYydbError } from './shared/errors.js';
 export { defineMicro, MicroSessionRegistry } from './shared/micro.js';
 export { nativeBindingName, platformKey, resolveYydbBinary, resolveYydbCli } from './native/resolve.js';
+export { loadNative } from './native/binding.js';
 export * from './shared/vos.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yydb/yydb",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "YYDB Node embedded engine and CLI",
   "license": "MPL-2.0",
   "type": "module",
@@ -30,9 +30,9 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/yy-database/yydb.git",
-    "directory": "projects/packages/yydb"
+    "directory": "projects/yydb.ts/packages/yydb"
   },
-  "homepage": "https://github.com/yy-database/yydb/tree/dev/projects/packages/yydb#readme",
+  "homepage": "https://github.com/yy-database/yydb/tree/dev/projects/yydb.ts/packages/yydb#readme",
   "bugs": {
     "url": "https://github.com/yy-database/yydb/issues"
   },
@@ -59,9 +59,9 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "@yydb/yydb-darwin-arm64": "0.1.6",
-    "@yydb/yydb-darwin-x64": "0.1.6",
-    "@yydb/yydb-linux-x64": "0.1.6",
-    "@yydb/yydb-win32-x64": "0.1.6"
+    "@yydb/yydb-darwin-arm64": "0.1.7",
+    "@yydb/yydb-darwin-x64": "0.1.7",
+    "@yydb/yydb-linux-x64": "0.1.7",
+    "@yydb/yydb-win32-x64": "0.1.7"
   }
 }