@archlast/server 0.0.1

package/dist/db/socket-client.d.ts

@@ -0,0 +1,122 @@
+import { QueryBuilder } from "../query/builder.js";
+import type { IDatabaseClient, RelationsMap, Document } from "./interfaces.js";
+import type { WhereClause } from "../query/types.js";
+/**
+ * Configuration for socket connection to Document Store
+ * Supports both Unix sockets (dev) and TCP with TLS (production)
+ * Implements Secure Document Store Protocol (v4)
+ */
+export interface SocketClientOptions {
+    useUnixSocket?: boolean;
+    socketPath?: string;
+    host?: string;
+    port?: number;
+    secret?: string;
+    certFingerprint?: string;
+    caPath?: string;
+    useTls?: boolean;
+    authTimeoutMs?: number;
+}
+/**
+ * Loads configuration from environment variables
+ * Implements Secure Document Store Protocol (v4) with Dev Shim
+ */
+export declare function loadSocketConfig(): SocketClientOptions;
+/**
+ * Database client that connects to Archlast.Store via socket
+ * Supports Unix sockets, TCP, and TLS with PSK authentication
+ */
+export declare class SocketDatabaseClient<DataModel extends Record<string, Document> = any, Relations extends RelationsMap<DataModel> = RelationsMap<DataModel>> implements IDatabaseClient<DataModel, Relations> {
+    private socket;
+    private requestId;
+    private pendingRequests;
+    private buffer;
+    private options;
+    private connected;
+    private connecting;
+    private connectPromise;
+    private authenticated;
+    private schemaRelationships;
+    constructor(options?: SocketClientOptions);
+    /**
+     * Ensures socket connection is established with retry logic
+     */
+    private ensureConnection;
+    /**
+     * Attempts to connect with exponential backoff retry
+     */
+    private connectWithRetry;
+    /**
+     * Single connection attempt
+     */
+    private attemptConnection;
+    /**
+     * Sends authentication packet (JSON with PSK) to server
+     * Implements Secure Protocol v4: JSON auth packet with length prefix
+     */
+    private authenticate;
+    /**
+     * Waits for auth response from server
+     */
+    private waitForAuthResponse;
+    /**
+     * Sets up socket event handlers after successful connection
+     */
+    private setupSocketHandlers;
+    private sleep;
+    /**
+     * Handles incoming data from socket
+     */
+    private handleData;
+    /**
+     * Sends a request to the store and waits for response
+     */
+    private sendRequest;
+    /**
+     * Normalizes a where clause for the Document Store.
+     * The C# Store now supports operator-based conditions.
+     * This method flattens 'and' conditions and preserves operator objects.
+     */
+    private normalizeWhere;
+    get<TableName extends keyof DataModel>(tableName: TableName, id: string): Promise<DataModel[TableName] | null>;
+    list<TableName extends keyof DataModel>(tableName: TableName): Promise<DataModel[TableName][]>;
+    query<TableName extends keyof DataModel>(tableName: TableName): QueryBuilder<DataModel[TableName]>;
+    findMany<TableName extends keyof DataModel>(tableName: TableName, options?: {
+        where?: WhereClause<DataModel[TableName]>;
+        orderBy?: any;
+        take?: number;
+        skip?: number;
+        select?: any;
+    }): Promise<DataModel[TableName][]>;
+    findFirst<TableName extends keyof DataModel>(tableName: TableName, options?: {
+        where?: WhereClause<DataModel[TableName]>;
+        orderBy?: any;
+    }): Promise<DataModel[TableName] | null>;
+    findUnique<TableName extends keyof DataModel>(tableName: TableName, where: WhereClause<DataModel[TableName]>): Promise<DataModel[TableName] | null>;
+    count<TableName extends keyof DataModel>(tableName: TableName, where?: WhereClause<DataModel[TableName]>): Promise<number>;
+    loadRelation<TableName extends keyof DataModel, RelationName extends keyof Relations[TableName] & string>(tableName: TableName, record: DataModel[TableName], relationName: RelationName): Promise<Relations[TableName][RelationName]>;
+    loadRelations<TableName extends keyof DataModel, RelationName extends keyof Relations[TableName] & string>(tableName: TableName, records: DataModel[TableName][], relationName: RelationName): Promise<Map<string, Relations[TableName][RelationName]>>;
+    private schemaMetadata;
+    /**
+     * Apply schema definitions for validation and type generation
+     */
+    applySchema(schema: any): Promise<void>;
+    private applySchemaEnforcement;
+    insert<TableName extends keyof DataModel>(tableName: TableName, data: Omit<DataModel[TableName], "_id" | "_collection">): Promise<string>;
+    insertMany<TableName extends keyof DataModel>(tableName: TableName, data: Omit<DataModel[TableName], "_id" | "_collection">[]): Promise<string[]>;
+    update<TableName extends keyof DataModel>(tableName: TableName, id: string, data: Partial<Omit<DataModel[TableName], "_id" | "_collection">>): Promise<void>;
+    updateMany<TableName extends keyof DataModel>(tableName: TableName, where: WhereClause<DataModel[TableName]>, data: Partial<Omit<DataModel[TableName], "_id" | "_collection">>): Promise<number>;
+    patch<TableName extends keyof DataModel>(tableName: TableName, id: string, data: Partial<Omit<DataModel[TableName], "_id" | "_collection">>): Promise<void>;
+    delete<TableName extends keyof DataModel>(tableName: TableName, id: string): Promise<void>;
+    deleteMany<TableName extends keyof DataModel>(tableName: TableName, where: WhereClause<DataModel[TableName]>): Promise<number>;
+    runInTransaction<T>(fn: (db: IDatabaseClient<DataModel, Relations>) => Promise<T>): Promise<T>;
+    executeQuery(spec: any): Promise<any[]>;
+    executeCount(spec: any): Promise<number>;
+    executeAggregate(spec: any): Promise<any>;
+    clearCache(): void;
+    /**
+     * Closes the socket connection
+     */
+    disconnect(): void;
+}
+//# sourceMappingURL=socket-client.d.ts.map

package/dist/db/socket-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-client.d.ts","sourceRoot":"","sources":["../../src/db/socket-client.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAoB,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMrD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,mBAAmB,CAyCtD;AAiDD;;;GAGG;AACH,qBAAa,oBAAoB,CAC7B,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,GAAG,EAChD,SAAS,SAAS,YAAY,CAAC,SAAS,CAAC,GAAG,YAAY,CAAC,SAAS,CAAC,CACrE,YAAW,eAAe,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9C,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,eAAe,CAGnB;IACJ,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,OAAO,CAQb;IACF,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,aAAa,CAAS;IAG9B,OAAO,CAAC,mBAAmB,CAA+C;gBAE9D,OAAO,GAAE,mBAAwB;IAwB7C;;OAEG;YACW,gBAAgB;IAwB9B;;OAEG;YACW,gBAAgB;IAgC9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgLzB;;;OAGG;YACW,YAAY;IAiD1B;;OAEG;YACW,mBAAmB;IAwDjC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA6B3B,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,UAAU;IA2BlB;;OAEG;YACW,WAAW;IAwDzB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAgFhB,GAAG,CAAC,SAAS,SAAS,MAAM,SAAS,EACvC,SAAS,EAAE,SAAS,EACpB,EAAE,EAAE,MAAM,GACX,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IAQjC,IAAI,CAAC,SAAS,SAAS,MAAM,SAAS,EACxC,SAAS,EAAE,SAAS,GACrB,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;IAOlC,KAAK,CAAC,SAAS,SAAS,MAAM,SAAS,EACnC,SAAS,EAAE,SAAS,GACrB,YAAY,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAK/B,QAAQ,CAAC,SAAS,SAAS,MAAM,SAAS,EAC5C,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;QAC1C,OAAO,CAAC,EAAE,GAAG,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,GAAG,CAAC;KAChB,GACF,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;IAmB5B,SAAS,CAAC,SAAS,SAAS,MAAM,SAAS,EAC7C,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,GACvE,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IAKjC,UAAU,CAAC,SAAS,SAAS,MAAM,SAAS,EAC9C,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,WAAW,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,GACzC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IAKjC,KAAK,CAAC,SAAS,SAAS,MAAM,SAAS,EACzC,SAAS,EAAE,SAAS,EACpB,KAAK,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,GAC1C,OAAO,CAAC,MAAM,CAAC;IAeZ,YAAY,CACd,SAAS,SAAS,MAAM,SAAS,EACjC,YAAY,SAAS,MAAM,SAAS,CAAC,SAAS,CAAC,GAAG,MAAM,EAExD,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,EAC5B,YAAY,EAAE,YAAY,GAC3B,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC;IA6DxC,aAAa,CACf,SAAS,SAAS,MAAM,SAAS,EACjC,YAAY,SAAS,MAAM,SAAS,CAAC,SAAS,CAAC,GAAG,MAAM,EAExD,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,EAAE,EAC/B,YAAY,EAAE,YAAY,GAC3B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;IAkF3D,OAAO,CAAC,cAAc,CAA4C;IAElE;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAkG7C,OAAO,CAAC,sBAAsB;IAiCxB,MAAM,CAAC,SAAS,SAAS,MAAM,SAAS,EAC1C,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,aAAa,CAAC,GACxD,OAAO,CAAC,MAAM,CAAC;IAqBZ,UAAU,CAAC,SAAS,SAAS,MAAM,SAAS,EAC9C,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,aAAa,CAAC,EAAE,GAC1D,OAAO,CAAC,MAAM,EAAE,CAAC;IAqBd,MAAM,CAAC,SAAS,SAAS,MAAM,SAAS,EAC1C,SAAS,EAAE,SAAS,EACpB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,aAAa,CAAC,CAAC,GACjE,OAAO,CAAC,IAAI,CAAC;IAqBV,UAAU,CAAC,SAAS,SAAS,MAAM,SAAS,EAC9C,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,WAAW,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,EACxC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,aAAa,CAAC,CAAC,GACjE,OAAO,CAAC,MAAM,CAAC;IAsBZ,KAAK,CAAC,SAAS,SAAS,MAAM,SAAS,EACzC,SAAS,EAAE,SAAS,EACpB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,aAAa,CAAC,CAAC,GACjE,OAAO,CAAC,IAAI,CAAC;IAKV,MAAM,CAAC,SAAS,SAAS,MAAM,SAAS,EAC1C,SAAS,EAAE,SAAS,EACpB,EAAE,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC;IAcV,UAAU,CAAC,SAAS,SAAS,MAAM,SAAS,EAC9C,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,WAAW,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC;IAiBZ,gBAAgB,CAAC,CAAC,EACpB,EAAE,EAAE,CAAC,EAAE,EAAE,eAAe,CAAC,SAAS,EAAE,SAAS,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAC9D,OAAO,CAAC,CAAC,CAAC;IAkBP,YAAY,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAoBvC,YAAY,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBxC,gBAAgB,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAc/C,UAAU,IAAI,IAAI;IAalB;;OAEG;IACH,UAAU,IAAI,IAAI;CAQrB"}