@profoundlogic/ras-native 1.0.1

package/README.md

@@ -0,0 +1,3 @@
+# ras-native
+
+Component of Profound Logic Remote Access Server(RAS).  

package/index.d.ts

@@ -0,0 +1,110 @@
+declare module "@ProfoundLogic/ras-native" {
+
+  export type ConnectionOptions = {
+    auto_commit?: boolean;
+    commit?: "none" | "nc" | "chg" | "ur" | "cs" | "all" | "rs" | "rr";
+    date_format?: "iso" | "usa" | "eur" | "jis" | "mdy" | "dmy" | "ymd" | "jul" | "job";
+    date_separator?: "/" | "-" | "." | "," | " " | "job";
+    debug?: boolean;
+    decimal_separator?: "." | "," | "job";
+    force_translate?: boolean;
+    max_buffer?: number;
+    naming?: "sql" | "sys";
+    rows?: number;
+    sort_sequence?: "hex" | "job" | "jobrun";
+    time_format?: "iso" | "usa" | "eur" | "jis" | "hms";
+    time_separator?: ":" | "." | "," | " " | "job";
+  };
+
+  export class Connection {
+    constructor(options?: ConnectionOptions);
+    user: string | null;
+    rdb: string | null;
+    connect(rdb: string): Promise<void>;
+    connect(user: string, password: string, rdb?: string): Promise<void>;
+    disconnect(): Promise<void>;
+    query(sql: string): Query;
+    query(sql: string, options: QueryOptions): Query;
+    query(sql: string, params: QueryParams): Query;
+    query(sql: string, params: QueryParams, options: QueryOptions): Query;
+  }
+
+  export type QueryOutputParam = {
+    input?: QueryParam;
+  };
+
+  export type QueryParam = string | number | bigint | Buffer | null | QueryOutputParam;
+
+  export type QueryParams = QueryParam[];
+
+  export type QueryOptions = {
+    close?: boolean;
+    debug?: boolean;
+    force_translate?: boolean;
+    max_buffer?: number;
+    rows?: number;
+  };
+
+  export type QueryState = "not_executed" | "executing" | "executed" | "complete";
+
+  export type ResultColumnMetadata = {
+    name: string;
+    type: number;
+    length: number;
+    precision: number;
+    scale: number;
+    ccsid: number;
+    nullable: boolean;
+  };
+
+  export type ResultColumn = string | number | bigint | Buffer | null;
+  export type ResultRow = Record<string, ResultColumn>;
+
+  export type OutputParam = ResultColumn;
+  export type OutputParams = Record<string, OutputParam>;
+
+  export type OutputParamMetadata = {
+    name: string;
+    type: number;
+    ccsid: number;
+  }
+
+  export type QueryResult = {
+    state: QueryState;
+    affectedRows?: number;
+    sqlcode: number;
+    sqlstate: string;
+    message?: string;
+    outputParams?: OutputParams;
+    outputParamMetadata?: OutputParamMetadata[];
+    columns?: ResultColumnMetadata[];
+    results?: ResultRow[];
+  };
+
+   export type QueryFetchResult = {
+    state: QueryState;
+    sqlcode: number;
+    sqlstate: string;
+    message?: string;
+    outputParams?: OutputParams;
+    outputParamMetadata?: OutputParamMetadata[];
+    columns: ResultColumnMetadata[];
+    results: ResultRow[];
+  };
+
+  export class Query {
+    private constructor();
+    get sql(): string;
+    get state(): QueryState;
+    execute(): Promise<QueryResult>;
+    fetch(): Promise<QueryFetchResult>;
+    close(): Promise<void>;
+  }
+
+  export interface SQLError extends Error {
+    name: "SQLError";
+    sqlcode: number;
+    sqlstate: string;
+  }
+
+}

package/index.js

@@ -0,0 +1,4 @@
+"use strict";
+
+module.exports = require(`./bin/${process.platform}_${process.arch}/ras-native.node`);
+module.exports.init(require("pjsloader"));

package/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@profoundlogic/ras-native",
+  "description": "Native IBM i Db2 interface for Remote Access Server (RAS).",
+  "version": "1.0.1",
+  "author": "Profound Logic Software",
+  "license": "UNLICENSED",
+  "dependencies": {
+    "pjsloader": "^2.0.0"
+  }
+}