@itwin/core-backend 3.5.0-dev.8 → 3.6.0-dev.1

package/lib/cjs/RpcBackend.js.map

@@ -1 +1 @@
-{"version":3,"file":"RpcBackend.js","sourceRoot":"","sources":["../../src/RpcBackend.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,0BAA0B;AAE1B,sDAAwE;AACxE,oDAAiJ;AACjJ,6CAAgD;AAChD,sCAAsC;AACtC,yCAAyC;AACzC,mEAAgE;AAChE,6CAA0C;AAE1C;;;;;;GAMG;AACH,MAAa,QAAQ;IAGnB;;SAEK;IACE,MAAM,KAAK,eAAe;QAC/B,OAAO,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAA6B,CAAC;IACjE,CAAC;IAED;;SAEK;IACE,MAAM,KAAK,qBAAqB;QACrC,IAAA,qBAAM,EAAC,SAAS,KAAK,QAAQ,CAAC,eAAe,CAAC,CAAC;QAC/C,OAAO,QAAQ,CAAC,eAAe,CAAC;IAClC,CAAC;IAED,8CAA8C;IACvC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAI,QAAqB,EAAE,EAAoB;QACpE,OAAO,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,0EAA0E;IACnE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAI,QAAqB,EAAE,EAAoB;;QAC5E,OAAO,sBAAO,CAAC,QAAQ,CAAC,MAAA,QAAQ,CAAC,SAAS,mCAAI,oBAAoB,EAAE,KAAK,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE;YAC1G,UAAU,EAAE,EAAE,GAAG,2BAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE;YACzD,IAAI,EAAE,uBAAQ,CAAC,MAAM;SACtB,CAAC,CAAC;IACL,CAAC;;AA7BH,4BA8BC;AA7BgB,iBAAQ,GAAG,IAAI,+BAAiB,EAAE,CAAC;AA+BpD,IAAI,WAAW,GAAG,KAAK,CAAC;AACxB,gBAAgB;AAChB,SAAgB,oBAAoB,CAAC,sBAA+B,KAAK;IACvE,IAAI,WAAW;QACb,OAAO;IAET,WAAW,GAAG,IAAI,CAAC;IAEnB,2BAAa,CAAC,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,mDAAmD;IAE7F,IAAI,mBAAmB,EAAE;QACvB,IAAI;YACF,8DAA8D;YAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,qBAAqB,EAAE,uBAAU,CAAC,cAAc,CAAC,CAAC;YACrF,sBAAO,CAAC,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YACzC,2BAAa,CAAC,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,mEAAmE;SACtH;QAAC,OAAO,CAAC,EAAE;YACV,gEAAgE;YAChE,qBAAM,CAAC,QAAQ,CAAC,6CAAqB,CAAC,UAAU,EAAE,oCAAoC,CAAC,CAAC;YACxF,qBAAM,CAAC,YAAY,CAAC,6CAAqB,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;SAC1D;KACF;IAED,0GAA0G;IAC1G,qBAAM,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,2BAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC;IAE/F,0BAAY,CAAC,YAAY,GAAG,CAAC,KAAyB,EAAE,EAAE;QACxD,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC5B,0BAAY,CAAC,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3C,mHAAmH;QACnH,gBAAgB;QAChB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,0BAAY,CAAC,YAAY,GAAG,KAAK,EAAE,GAAsB,EAAE,EAAE;QAC3D,OAAO,IAAI,OAAO,CAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACzD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC9D,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACvB,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG,gCAAkB,CAAC,MAAM,EAAE,CAAC;YAC1C,MAAM,IAAI,GAA4D,EAAE,CAAC;YAEzE,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAqB,EAAE,EAAE;gBACxC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAsB,EAAE,EAAE;oBACzC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE;wBAC3B,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;qBACnC;yBAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;wBACjC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;4BACpB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;yBAC3C;wBAED,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC;wBACzC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;qBACpC;yBAAM;wBACL,MAAM,IAAI,yBAAW,CAAC,2BAAa,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;qBAC9D;gBACH,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACpB,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,SAAU;oBACR,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;oBAC/B,IAAI,CAAC,IAAI,EAAE;wBACT,MAAM;qBACP;oBAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;oBACvD,EAAE,CAAC,CAAC;iBACL;gBAED,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AA9ED,oDA8EC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module RpcInterface\r\n */\r\n\r\n// cspell:ignore calltrace\r\n\r\nimport { assert, Logger, SpanKind, Tracing } from \"@itwin/core-bentley\";\r\nimport { BentleyStatus, HttpServerRequest, IModelError, RpcActivity, RpcInvocation, RpcMultipart, RpcSerializedValue } from \"@itwin/core-common\";\r\nimport { AsyncLocalStorage } from \"async_hooks\";\r\nimport * as FormData from \"form-data\";\r\nimport * as multiparty from \"multiparty\";\r\nimport { BackendLoggerCategory } from \"./BackendLoggerCategory\";\r\nimport { IModelHost } from \"./IModelHost\";\r\n\r\n/**\r\n * Utility for tracing Rpc activity processing. When multiple Rpc requests are being processed asynchronously, this\r\n * class can be used to correlate the current calltrace with the originating RpcActivity. This is used for automatic appending\r\n * of RpcActivity to log messages emitted during Rpc processing. It may also be used to retrieve the user accessToken\r\n * from the RpcActivity.\r\n * @public\r\n */\r\nexport class RpcTrace {\r\n  private static _storage = new AsyncLocalStorage();\r\n\r\n  /** Get the [RpcActivity]($common) for the currently executing async, or `undefined` if there is no\r\n   * RpcActivity in the current call stack.\r\n   * */\r\n  public static get currentActivity(): RpcActivity | undefined {\r\n    return RpcTrace._storage.getStore() as RpcActivity | undefined;\r\n  }\r\n\r\n  /** Get the [RpcActivity]($common) for the currently executing async. Asserts that the RpcActivity\r\n   * exists in the current call stack.\r\n   * */\r\n  public static get expectCurrentActivity(): RpcActivity {\r\n    assert(undefined !== RpcTrace.currentActivity);\r\n    return RpcTrace.currentActivity;\r\n  }\r\n\r\n  /** Start the processing of an RpcActivity. */\r\n  public static async run<T>(activity: RpcActivity, fn: () => Promise<T>): Promise<T> {\r\n    return RpcTrace._storage.run(activity, fn);\r\n  }\r\n\r\n  /** Start the processing of an RpcActivity inside an OpenTelemetry span */\r\n  public static async runWithSpan<T>(activity: RpcActivity, fn: () => Promise<T>): Promise<T> {\r\n    return Tracing.withSpan(activity.rpcMethod ?? \"unknown RPC method\", async () => RpcTrace.run(activity, fn), {\r\n      attributes: { ...RpcInvocation.sanitizeForLog(activity) },\r\n      kind: SpanKind.SERVER,\r\n    });\r\n  }\r\n}\r\n\r\nlet initialized = false;\r\n/** @internal */\r\nexport function initializeRpcBackend(enableOpenTelemetry: boolean = false) {\r\n  if (initialized)\r\n    return;\r\n\r\n  initialized = true;\r\n\r\n  RpcInvocation.runActivity = RpcTrace.run; // redirect the invocation processing to the tracer\r\n\r\n  if (enableOpenTelemetry) {\r\n    try {\r\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\r\n      const api = require(\"@opentelemetry/api\");\r\n      const tracer = api.trace.getTracer(\"@itwin/core-backend\", IModelHost.backendVersion);\r\n      Tracing.enableOpenTelemetry(tracer, api);\r\n      RpcInvocation.runActivity = RpcTrace.runWithSpan; // wrap invocation in an OpenTelemetry span in addition to RpcTrace\r\n    } catch (e) {\r\n      // eslint-disable-next-line @typescript-eslint/naming-convention\r\n      Logger.logError(BackendLoggerCategory.IModelHost, \"Failed to initialize OpenTelemetry\");\r\n      Logger.logException(BackendLoggerCategory.IModelHost, e);\r\n    }\r\n  }\r\n\r\n  // set up static logger metadata to include current RpcActivity information for logs during rpc processing\r\n  Logger.staticMetaData.set(\"rpc\", () => RpcInvocation.sanitizeForLog(RpcTrace.currentActivity));\r\n\r\n  RpcMultipart.createStream = (value: RpcSerializedValue) => {\r\n    const form = new FormData();\r\n    RpcMultipart.writeValueToForm(form, value);\r\n    // Type information for FormData is lying. It actually extends Stream but not Readable, although it appears to work\r\n    // fine for now.\r\n    return form;\r\n  };\r\n\r\n  RpcMultipart.parseRequest = async (req: HttpServerRequest) => {\r\n    return new Promise<RpcSerializedValue>((resolve, reject) => {\r\n      const form = new multiparty.Form({ maxFieldsSize: Infinity });\r\n      form.on(\"error\", (err) => {\r\n        reject(err);\r\n      });\r\n\r\n      const value = RpcSerializedValue.create();\r\n      const data: { [index: string]: { size: number, chunks: Buffer[] } } = {};\r\n\r\n      form.on(\"part\", (part: multiparty.Part) => {\r\n        part.on(\"data\", (chunk: string | Buffer) => {\r\n          if (part.name === \"objects\") {\r\n            value.objects += chunk.toString();\r\n          } else if (Buffer.isBuffer(chunk)) {\r\n            if (!data[part.name]) {\r\n              data[part.name] = { size: 0, chunks: [] };\r\n            }\r\n\r\n            data[part.name].size += chunk.byteLength;\r\n            data[part.name].chunks.push(chunk);\r\n          } else {\r\n            throw new IModelError(BentleyStatus.ERROR, \"Unknown input.\");\r\n          }\r\n        });\r\n      });\r\n\r\n      form.on(\"close\", () => {\r\n        let i = 0;\r\n        for (; ;) {\r\n          const part = data[`data-${i}`];\r\n          if (!part) {\r\n            break;\r\n          }\r\n\r\n          value.data.push(Buffer.concat(part.chunks, part.size));\r\n          ++i;\r\n        }\r\n\r\n        resolve(value);\r\n      });\r\n\r\n      form.parse(req);\r\n    });\r\n  };\r\n}\r\n"]}
+{"version":3,"file":"RpcBackend.js","sourceRoot":"","sources":["../../src/RpcBackend.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,oDAAsF;AACtF,+CAAsG;AACtG,2CAAkD;AAClD,+CAA4D;AAC5D,+CAAiD;AACjD,iDAAkD;AAElD,IAAI,WAAW,GAAG,KAAK,CAAC;AACxB,gBAAgB;AAChB,SAAgB,oBAAoB,CAAC,sBAA+B,KAAK;IACvE,IAAI,WAAW;QACb,OAAO;IAET,IAAA,2BAAiB,EAAC,mBAAmB,CAAC,CAAC;IAEvC,0BAAY,CAAC,QAAQ,CAAC,YAAY,GAAG,iCAAqB,CAAC;IAC3D,0BAAY,CAAC,QAAQ,CAAC,YAAY,GAAG,iCAAqB,CAAC;IAC3D,0BAAY,CAAC,QAAQ,CAAC,YAAY,GAAG,iCAAqB,CAAC;IAE3D,8BAAgB,CAAC,OAAO,CAAC,YAAY,GAAG,uBAAY,CAAC;IACrD,8BAAgB,CAAC,OAAO,CAAC,YAAY,GAAG,sBAAY,CAAC;IAErD,8BAAgB,CAAC,iBAAiB,CAAC,IAAI,iCAAuB,EAAE,CAAC,CAAC;IAElE,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC;AAhBD,oDAgBC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module RpcInterface\r\n */\r\n\r\nimport { RpcMultipart, WebAppRpcLogging, WebAppRpcRequest } from \"@itwin/core-common\";\r\nimport { appendToMultipartForm, createMultipartStream, parseMultipartRequest } from \"./rpc/multipart\";\r\nimport { initializeTracing } from \"./rpc/tracing\";\r\nimport { WebAppRpcLoggingBackend } from \"./rpc/web/logging\";\r\nimport { parseRequest } from \"./rpc/web/request\";\r\nimport { sendResponse } from \"./rpc/web/response\";\r\n\r\nlet initialized = false;\r\n/** @internal */\r\nexport function initializeRpcBackend(enableOpenTelemetry: boolean = false) {\r\n  if (initialized)\r\n    return;\r\n\r\n  initializeTracing(enableOpenTelemetry);\r\n\r\n  RpcMultipart.platform.createStream = createMultipartStream;\r\n  RpcMultipart.platform.parseRequest = parseMultipartRequest;\r\n  RpcMultipart.platform.appendToForm = appendToMultipartForm;\r\n\r\n  WebAppRpcRequest.backend.sendResponse = sendResponse;\r\n  WebAppRpcRequest.backend.parseRequest = parseRequest;\r\n\r\n  WebAppRpcLogging.initializeBackend(new WebAppRpcLoggingBackend());\r\n\r\n  initialized = true;\r\n}\r\n"]}

package/lib/cjs/SqliteStatement.d.ts

@@ -88,22 +88,58 @@ export declare class SqliteStatement implements IterableIterator<any>, IDisposab
      *  case of other binding errors.
      */
     bindValue(parameter: BindParameter, value: any): void;
-    private checkBind;
     /** Bind an integer parameter
-     *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
-     *  @param val integer to bind.
+     * @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
+     * @param val integer to bind.
      */
     bindInteger(parameter: BindParameter, val: number): void;
+    /** Bind an integer parameter if it is defined. Otherwise do nothing.
+     * @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
+     * @param val integer to bind.
+     */
+    maybeBindInteger(parameter: BindParameter, val?: number): void;
+    /** Bind a boolean parameter.
+     * @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
+     * @param val boolean to bind.
+     */
+    bindBoolean(parameter: BindParameter, val: boolean): void;
+    /** Bind a boolean parameter if it is defined. Otherwise do nothing.
+     * @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
+     * @param val boolean to bind.
+     */
+    maybeBindBoolean(parameter: BindParameter, val?: boolean): void;
+    /** JSON.stringify a property value and bind the JSON string.
+     * @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
+     * @param val object to bind.
+     * @internal
+     */
+    bindProps<T>(colIndex: number, val: T): void;
+    /** JSON.stringify a property value if it is defined, and bind the JSON string. Otherwise do nothing.
+     * @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
+     * @param val object to bind.
+     * @internal
+     */
+    maybeBindProps<T>(colIndex: number, val?: T): void;
     /** Bind a double parameter
      *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
      *  @param val double to bind.
      */
     bindDouble(parameter: BindParameter, val: number): void;
+    /** Bind a double parameter if it is defined. Otherwise do nothing.
+     * @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
+     * @param val double to bind.
+     */
+    maybeBindDouble(parameter: BindParameter, val?: number): void;
     /** Bind a string parameter
      *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
      *  @param val string to bind.
      */
     bindString(parameter: BindParameter, val: string): void;
+    /** Bind a string parameter if it is defined. Otherwise do nothing.
+     * @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
+     * @param val string to bind.
+     */
+    maybeBindString(parameter: BindParameter, val?: string): void;
     /** Bind an Id64String parameter as a 64-bit integer
      *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
      *  @param val Id to bind.
@@ -119,6 +155,11 @@ export declare class SqliteStatement implements IterableIterator<any>, IDisposab
      *  @param val blob to bind.
      */
     bindBlob(parameter: BindParameter, blob: Uint8Array): void;
+    /** Bind a blob parameter if it is defined. Otherwise do nothing.
+     * @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
+     * @param val blob to bind.
+     */
+    maybeBindBlob(parameter: BindParameter, val?: Uint8Array): void;
     /** Bind null to a parameter
      *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
      */
@@ -165,18 +206,34 @@ export declare class SqliteStatement implements IterableIterator<any>, IDisposab
      * @param colIndex Index of SQL column in query result (0-based)
      */
     getValueBlob(colIndex: number): Uint8Array;
+    /** Get the value as a blob, or undefined if it is null.
+     * @param colIndex Index of SQL column in query result (0-based)
+     */
+    getValueBlobMaybe(colIndex: number): Uint8Array | undefined;
     /** Get a value as a double
     * @param colIndex Index of SQL column in query result (0-based)
     */
     getValueDouble(colIndex: number): number;
+    /** Get the value as an double, or undefined if it is null.
+     * @param colIndex Index of SQL column in query result (0-based)
+     */
+    getValueDoubleMaybe(colIndex: number): number | undefined;
     /** Get a value as a integer
     * @param colIndex Index of SQL column in query result (0-based)
     */
     getValueInteger(colIndex: number): number;
+    /** Get the value as an integer, or undefined if it is null.
+     * @param colIndex Index of SQL column in query result (0-based)
+     */
+    getValueIntegerMaybe(colIndex: number): number | undefined;
     /** Get a value as a string
     * @param colIndex Index of SQL column in query result (0-based)
     */
     getValueString(colIndex: number): string;
+    /** Get the value as a string, or undefined if it is null.
+     * @param colIndex Index of SQL column in query result (0-based)
+     */
+    getValueStringMaybe(colIndex: number): string | undefined;
     /** Get a value as an Id
     * @param colIndex Index of SQL column in query result (0-based)
     */
@@ -185,6 +242,26 @@ export declare class SqliteStatement implements IterableIterator<any>, IDisposab
     * @param colIndex Index of SQL column in query result (0-based)
     */
     getValueGuid(colIndex: number): GuidString;
+    /** Get the value as a boolean. Returns `false` if the column is null.
+     * @param colIndex Index of SQL column in query result (0-based)
+     */
+    getValueBoolean(colIndex: number): boolean;
+    /** Get the value of a [julianday](https://www.sqlite.org/lang_datefunc.html) column as a JavaScript `Date`.
+     * @param colIndex Index of SQL column in query result (0-based)
+     * @beta
+     */
+    getValueDate(colIndex: number): Date;
+    /** Get the value as a "props" JSON string, then parse it and return the object
+     * @param colIndex Index of SQL column in query result (0-based)
+     * @internal
+    */
+    getProps<T>(colIndex: number): T;
+    /** Get the value as a "props" JSON string, then parse it and return the object.
+     * If the column is null, return undefined.
+     * @param colIndex Index of SQL column in query result (0-based)
+     * @internal
+    */
+    getPropsMaybe<T>(colIndex: number): T | undefined;
     /** Get the current row.
      * The returned row is formatted as JavaScript object where every SELECT clause item becomes a property in the JavaScript object.
      *
@@ -247,7 +324,7 @@ export declare class SqliteValue {
      * [SqliteValueType.Blob]($backend) | Uint8Array
      */
     get value(): any;
-    /** Get the value as BLOB */
+    /** Get the value as Blob */
     getBlob(): Uint8Array;
     /** Get the value as a double value */
     getDouble(): number;

package/lib/cjs/SqliteStatement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SqliteStatement.d.ts","sourceRoot":"","sources":["../../src/SqliteStatement.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SqliteStatement.d.ts","sourceRoot":"","sources":["../../src/SqliteStatement.ts"],"names":[],"mappings":"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"}

package/lib/cjs/SqliteStatement.js

@@ -11,6 +11,10 @@ exports.StatementCache = exports.SqliteValue = exports.SqliteValueType = exports
 const core_bentley_1 = require("@itwin/core-bentley");
 const core_common_1 = require("@itwin/core-common");
 const IModelHost_1 = require("./IModelHost");
+function checkBind(stat) {
+    if (stat !== core_bentley_1.DbResult.BE_SQLITE_OK)
+        throw new core_common_1.IModelError(stat, "SQLite Bind error");
+}
 /** Executes SQLite SQL statements.
  *
  * A statement must be prepared before it can be executed, and it must be released when no longer needed.
@@ -137,57 +141,117 @@ class SqliteStatement {
         if (stat !== core_bentley_1.DbResult.BE_SQLITE_OK)
             throw new core_common_1.IModelError(stat, "Error in bindValue");
     }
-    checkBind(stat) {
-        if (stat !== core_bentley_1.DbResult.BE_SQLITE_OK)
-            throw new core_common_1.IModelError(stat, "SQLite Bind error");
-    }
     /** Bind an integer parameter
-     *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
-     *  @param val integer to bind.
+     * @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
+     * @param val integer to bind.
      */
     bindInteger(parameter, val) {
-        this.checkBind(this.stmt.bindInteger(parameter, val));
+        checkBind(this.stmt.bindInteger(parameter, val));
+    }
+    /** Bind an integer parameter if it is defined. Otherwise do nothing.
+     * @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
+     * @param val integer to bind.
+     */
+    maybeBindInteger(parameter, val) {
+        if (val !== undefined)
+            this.bindInteger(parameter, val);
+    }
+    /** Bind a boolean parameter.
+     * @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
+     * @param val boolean to bind.
+     */
+    bindBoolean(parameter, val) {
+        this.bindInteger(parameter, val ? 1 : 0);
+    }
+    /** Bind a boolean parameter if it is defined. Otherwise do nothing.
+     * @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
+     * @param val boolean to bind.
+     */
+    maybeBindBoolean(parameter, val) {
+        if (val !== undefined)
+            this.bindBoolean(parameter, val);
+    }
+    /** JSON.stringify a property value and bind the JSON string.
+     * @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
+     * @param val object to bind.
+     * @internal
+     */
+    bindProps(colIndex, val) {
+        this.bindString(colIndex, JSON.stringify(val));
+    }
+    /** JSON.stringify a property value if it is defined, and bind the JSON string. Otherwise do nothing.
+     * @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
+     * @param val object to bind.
+     * @internal
+     */
+    maybeBindProps(colIndex, val) {
+        if (val !== undefined)
+            this.bindProps(colIndex, val);
     }
     /** Bind a double parameter
      *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
      *  @param val double to bind.
      */
     bindDouble(parameter, val) {
-        this.checkBind(this.stmt.bindDouble(parameter, val));
+        checkBind(this.stmt.bindDouble(parameter, val));
+    }
+    /** Bind a double parameter if it is defined. Otherwise do nothing.
+     * @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
+     * @param val double to bind.
+     */
+    maybeBindDouble(parameter, val) {
+        if (val !== undefined)
+            this.bindDouble(parameter, val);
     }
     /** Bind a string parameter
      *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
      *  @param val string to bind.
      */
     bindString(parameter, val) {
-        this.checkBind(this.stmt.bindString(parameter, val));
+        checkBind(this.stmt.bindString(parameter, val));
+    }
+    /** Bind a string parameter if it is defined. Otherwise do nothing.
+     * @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
+     * @param val string to bind.
+     */
+    maybeBindString(parameter, val) {
+        if (val !== undefined)
+            this.bindString(parameter, val);
     }
     /** Bind an Id64String parameter as a 64-bit integer
      *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
      *  @param val Id to bind.
      */
     bindId(parameter, id) {
-        this.checkBind(this.stmt.bindId(parameter, id));
+        checkBind(this.stmt.bindId(parameter, id));
     }
     /** Bind a Guid parameter
      *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
      *  @param val Guid to bind.
      */
     bindGuid(parameter, guid) {
-        this.checkBind(this.stmt.bindGuid(parameter, guid));
+        checkBind(this.stmt.bindGuid(parameter, guid));
     }
     /** Bind a blob parameter
      *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
      *  @param val blob to bind.
      */
     bindBlob(parameter, blob) {
-        this.checkBind(this.stmt.bindBlob(parameter, blob));
+        checkBind(this.stmt.bindBlob(parameter, blob));
+    }
+    /** Bind a blob parameter if it is defined. Otherwise do nothing.
+     * @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
+     * @param val blob to bind.
+     */
+    maybeBindBlob(parameter, val) {
+        if (val !== undefined)
+            this.bindBlob(parameter, val);
     }
     /** Bind null to a parameter
      *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
      */
     bindNull(parameter) {
-        this.checkBind(this.stmt.bindNull(parameter));
+        checkBind(this.stmt.bindNull(parameter));
     }
     /** Bind values to all parameters in the statement.
      * @param values The values to bind to the parameters.
@@ -234,45 +298,119 @@ class SqliteStatement {
      *  - [DbResult.BE_SQLITE_DONE]($core-bentley) if the statement has been executed successfully.
      *  - Error status in case of errors.
      */
-    step() { return this.stmt.step(); }
+    step() {
+        return this.stmt.step();
+    }
     /** Get the query result's column count (only for SQL SELECT statements). */
-    getColumnCount() { return this.stmt.getColumnCount(); }
+    getColumnCount() {
+        return this.stmt.getColumnCount();
+    }
     /** Get the value for the column at the given index in the query result.
      * @param columnIx Index of SQL column in query result (0-based)
      */
-    getValue(columnIx) { return new SqliteValue(this.stmt, columnIx); }
+    getValue(columnIx) {
+        return new SqliteValue(this.stmt, columnIx);
+    }
     /** Determine whether the value of the specified column is null
      * @param colIndex Index of SQL column in query result (0-based)
      */
-    isValueNull(colIndex) { return this.stmt.isValueNull(colIndex); }
+    isValueNull(colIndex) {
+        return this.stmt.isValueNull(colIndex);
+    }
     /** Get a size in bytes of a blob or text column
      * @param colIndex Index of SQL column in query result (0-based)
      */
-    getColumnBytes(colIndex) { return this.stmt.getColumnBytes(colIndex); }
+    getColumnBytes(colIndex) {
+        return this.stmt.getColumnBytes(colIndex);
+    }
     /** Get a value as a blob
      * @param colIndex Index of SQL column in query result (0-based)
      */
-    getValueBlob(colIndex) { return this.stmt.getValueBlob(colIndex); }
+    getValueBlob(colIndex) {
+        return this.stmt.getValueBlob(colIndex);
+    }
+    /** Get the value as a blob, or undefined if it is null.
+     * @param colIndex Index of SQL column in query result (0-based)
+     */
+    getValueBlobMaybe(colIndex) {
+        return this.isValueNull(colIndex) ? undefined : this.getValueBlob(colIndex);
+    }
     /** Get a value as a double
     * @param colIndex Index of SQL column in query result (0-based)
     */
-    getValueDouble(colIndex) { return this.stmt.getValueDouble(colIndex); }
+    getValueDouble(colIndex) {
+        return this.stmt.getValueDouble(colIndex);
+    }
+    /** Get the value as an double, or undefined if it is null.
+     * @param colIndex Index of SQL column in query result (0-based)
+     */
+    getValueDoubleMaybe(colIndex) {
+        return this.isValueNull(colIndex) ? undefined : this.getValueDouble(colIndex);
+    }
     /** Get a value as a integer
     * @param colIndex Index of SQL column in query result (0-based)
     */
-    getValueInteger(colIndex) { return this.stmt.getValueInteger(colIndex); }
+    getValueInteger(colIndex) {
+        return this.stmt.getValueInteger(colIndex);
+    }
+    /** Get the value as an integer, or undefined if it is null.
+     * @param colIndex Index of SQL column in query result (0-based)
+     */
+    getValueIntegerMaybe(colIndex) {
+        return this.isValueNull(colIndex) ? undefined : this.getValueInteger(colIndex);
+    }
     /** Get a value as a string
     * @param colIndex Index of SQL column in query result (0-based)
     */
-    getValueString(colIndex) { return this.stmt.getValueString(colIndex); }
+    getValueString(colIndex) {
+        return this.stmt.getValueString(colIndex);
+    }
+    /** Get the value as a string, or undefined if it is null.
+     * @param colIndex Index of SQL column in query result (0-based)
+     */
+    getValueStringMaybe(colIndex) {
+        return this.isValueNull(colIndex) ? undefined : this.getValueString(colIndex);
+    }
     /** Get a value as an Id
     * @param colIndex Index of SQL column in query result (0-based)
     */
-    getValueId(colIndex) { return this.stmt.getValueId(colIndex); }
+    getValueId(colIndex) {
+        return this.stmt.getValueId(colIndex);
+    }
     /** Get a value as a Guid
     * @param colIndex Index of SQL column in query result (0-based)
     */
-    getValueGuid(colIndex) { return this.stmt.getValueGuid(colIndex); }
+    getValueGuid(colIndex) {
+        return this.stmt.getValueGuid(colIndex);
+    }
+    /** Get the value as a boolean. Returns `false` if the column is null.
+     * @param colIndex Index of SQL column in query result (0-based)
+     */
+    getValueBoolean(colIndex) {
+        return this.isValueNull(colIndex) ? false : 0 !== this.getValueInteger(colIndex);
+    }
+    /** Get the value of a [julianday](https://www.sqlite.org/lang_datefunc.html) column as a JavaScript `Date`.
+     * @param colIndex Index of SQL column in query result (0-based)
+     * @beta
+     */
+    getValueDate(colIndex) {
+        return new Date((this.stmt.getValueDouble(colIndex) - 2440587.5) * 86400000); // conversion from julian day ms to unix epoch ms
+    }
+    /** Get the value as a "props" JSON string, then parse it and return the object
+     * @param colIndex Index of SQL column in query result (0-based)
+     * @internal
+    */
+    getProps(colIndex) {
+        return JSON.parse(this.getValueString(colIndex));
+    }
+    /** Get the value as a "props" JSON string, then parse it and return the object.
+     * If the column is null, return undefined.
+     * @param colIndex Index of SQL column in query result (0-based)
+     * @internal
+    */
+    getPropsMaybe(colIndex) {
+        return this.isValueNull(colIndex) ? undefined : this.getProps(colIndex);
+    }
     /** Get the current row.
      * The returned row is formatted as JavaScript object where every SELECT clause item becomes a property in the JavaScript object.
      *
@@ -398,7 +536,7 @@ class SqliteValue {
                 throw new Error("Unhandled SqliteValueType");
         }
     }
-    /** Get the value as BLOB */
+    /** Get the value as Blob */
     getBlob() { return this._stmt.getValueBlob(this._colIndex); }
     /** Get the value as a double value */
     getDouble() { return this._stmt.getValueDouble(this._colIndex); }