@kwiz/node 1.0.8 → 1.0.10

package/__azurite_db_blob__.json

@@ -0,0 +1 @@
+{"filename":"C:\\Repos\\@kwiz\\node\\__azurite_db_blob__.json","collections":[{"name":"$SERVICES_COLLECTION$","data":[],"idIndex":null,"binaryIndices":{},"constraints":null,"uniqueNames":["accountName"],"transforms":{},"objType":"$SERVICES_COLLECTION$","dirty":false,"cachedIndex":null,"cachedBinaryIndex":null,"cachedData":null,"adaptiveBinaryIndices":true,"transactional":false,"cloneObjects":false,"cloneMethod":"parse-stringify","asyncListeners":false,"disableMeta":false,"disableChangesApi":true,"disableDeltaChangesApi":true,"autoupdate":false,"serializableIndices":true,"disableFreeze":true,"ttl":null,"maxId":0,"DynamicViews":[],"events":{"insert":[],"update":[],"pre-insert":[],"pre-update":[],"close":[],"flushbuffer":[],"error":[],"delete":[null],"warning":[null]},"changes":[],"dirtyIds":[]},{"name":"$CONTAINERS_COLLECTION$","data":[],"idIndex":null,"binaryIndices":{"accountName":{"name":"accountName","dirty":false,"values":[]},"name":{"name":"name","dirty":false,"values":[]}},"constraints":null,"uniqueNames":[],"transforms":{},"objType":"$CONTAINERS_COLLECTION$","dirty":false,"cachedIndex":null,"cachedBinaryIndex":null,"cachedData":null,"adaptiveBinaryIndices":true,"transactional":false,"cloneObjects":false,"cloneMethod":"parse-stringify","asyncListeners":false,"disableMeta":false,"disableChangesApi":true,"disableDeltaChangesApi":true,"autoupdate":false,"serializableIndices":true,"disableFreeze":true,"ttl":null,"maxId":0,"DynamicViews":[],"events":{"insert":[],"update":[],"pre-insert":[],"pre-update":[],"close":[],"flushbuffer":[],"error":[],"delete":[null],"warning":[null]},"changes":[],"dirtyIds":[]},{"name":"$BLOBS_COLLECTION$","data":[],"idIndex":null,"binaryIndices":{"accountName":{"name":"accountName","dirty":false,"values":[]},"containerName":{"name":"containerName","dirty":false,"values":[]},"name":{"name":"name","dirty":false,"values":[]},"snapshot":{"name":"snapshot","dirty":false,"values":[]}},"constraints":null,"uniqueNames":[],"transforms":{},"objType":"$BLOBS_COLLECTION$","dirty":false,"cachedIndex":null,"cachedBinaryIndex":null,"cachedData":null,"adaptiveBinaryIndices":true,"transactional":false,"cloneObjects":false,"cloneMethod":"parse-stringify","asyncListeners":false,"disableMeta":false,"disableChangesApi":true,"disableDeltaChangesApi":true,"autoupdate":false,"serializableIndices":true,"disableFreeze":true,"ttl":null,"maxId":0,"DynamicViews":[],"events":{"insert":[],"update":[],"pre-insert":[],"pre-update":[],"close":[],"flushbuffer":[],"error":[],"delete":[null],"warning":[null]},"changes":[],"dirtyIds":[]},{"name":"$BLOCKS_COLLECTION$","data":[],"idIndex":null,"binaryIndices":{"accountName":{"name":"accountName","dirty":false,"values":[]},"containerName":{"name":"containerName","dirty":false,"values":[]},"blobName":{"name":"blobName","dirty":false,"values":[]},"name":{"name":"name","dirty":false,"values":[]}},"constraints":null,"uniqueNames":[],"transforms":{},"objType":"$BLOCKS_COLLECTION$","dirty":false,"cachedIndex":null,"cachedBinaryIndex":null,"cachedData":null,"adaptiveBinaryIndices":true,"transactional":false,"cloneObjects":false,"cloneMethod":"parse-stringify","asyncListeners":false,"disableMeta":false,"disableChangesApi":true,"disableDeltaChangesApi":true,"autoupdate":false,"serializableIndices":true,"disableFreeze":true,"ttl":null,"maxId":0,"DynamicViews":[],"events":{"insert":[],"update":[],"pre-insert":[],"pre-update":[],"close":[],"flushbuffer":[],"error":[],"delete":[null],"warning":[null]},"changes":[],"dirtyIds":[]}],"databaseVersion":1.5,"engineVersion":1.5,"autosave":true,"autosaveInterval":5000,"autosaveHandle":null,"throttledSaves":true,"options":{"persistenceMethod":"fs","autosave":true,"autosaveInterval":5000,"serializationMethod":"normal","destructureDelimiter":"$<\n"},"persistenceMethod":"fs","persistenceAdapter":null,"verbose":false,"events":{"init":[null],"loaded":[],"flushChanges":[],"close":[],"changes":[],"warning":[]},"ENV":"NODEJS"}

package/__azurite_db_blob_extent__.json

@@ -0,0 +1 @@
+{"filename":"C:\\Repos\\@kwiz\\node\\__azurite_db_blob_extent__.json","collections":[{"name":"$EXTENTS_COLLECTION$","data":[],"idIndex":null,"binaryIndices":{"id":{"name":"id","dirty":false,"values":[]}},"constraints":null,"uniqueNames":[],"transforms":{},"objType":"$EXTENTS_COLLECTION$","dirty":false,"cachedIndex":null,"cachedBinaryIndex":null,"cachedData":null,"adaptiveBinaryIndices":true,"transactional":false,"cloneObjects":false,"cloneMethod":"parse-stringify","asyncListeners":false,"disableMeta":false,"disableChangesApi":true,"disableDeltaChangesApi":true,"autoupdate":false,"serializableIndices":true,"disableFreeze":true,"ttl":null,"maxId":0,"DynamicViews":[],"events":{"insert":[],"update":[],"pre-insert":[],"pre-update":[],"close":[],"flushbuffer":[],"error":[],"delete":[null],"warning":[null]},"changes":[],"dirtyIds":[]}],"databaseVersion":1.5,"engineVersion":1.5,"autosave":true,"autosaveInterval":5000,"autosaveHandle":null,"throttledSaves":true,"options":{"persistenceMethod":"fs","autosave":true,"autosaveInterval":5000,"serializationMethod":"normal","destructureDelimiter":"$<\n"},"persistenceMethod":"fs","persistenceAdapter":null,"verbose":false,"events":{"init":[null],"loaded":[],"flushChanges":[],"close":[],"changes":[],"warning":[]},"ENV":"NODEJS"}

package/__azurite_db_queue__.json

@@ -0,0 +1 @@
+{"filename":"C:\\Repos\\@kwiz\\node\\__azurite_db_queue__.json","collections":[{"name":"$SERVICES_COLLECTION$","data":[],"idIndex":null,"binaryIndices":{},"constraints":null,"uniqueNames":["accountName"],"transforms":{},"objType":"$SERVICES_COLLECTION$","dirty":false,"cachedIndex":null,"cachedBinaryIndex":null,"cachedData":null,"adaptiveBinaryIndices":true,"transactional":false,"cloneObjects":false,"cloneMethod":"parse-stringify","asyncListeners":false,"disableMeta":false,"disableChangesApi":true,"disableDeltaChangesApi":true,"autoupdate":false,"serializableIndices":true,"disableFreeze":true,"ttl":null,"maxId":0,"DynamicViews":[],"events":{"insert":[],"update":[],"pre-insert":[],"pre-update":[],"close":[],"flushbuffer":[],"error":[],"delete":[null],"warning":[null]},"changes":[],"dirtyIds":[]},{"name":"$QUEUES_COLLECTION$","data":[],"idIndex":null,"binaryIndices":{"accountName":{"name":"accountName","dirty":false,"values":[]},"name":{"name":"name","dirty":false,"values":[]}},"constraints":null,"uniqueNames":[],"transforms":{},"objType":"$QUEUES_COLLECTION$","dirty":false,"cachedIndex":null,"cachedBinaryIndex":null,"cachedData":null,"adaptiveBinaryIndices":true,"transactional":false,"cloneObjects":false,"cloneMethod":"parse-stringify","asyncListeners":false,"disableMeta":false,"disableChangesApi":true,"disableDeltaChangesApi":true,"autoupdate":false,"serializableIndices":true,"disableFreeze":true,"ttl":null,"maxId":0,"DynamicViews":[],"events":{"insert":[],"update":[],"pre-insert":[],"pre-update":[],"close":[],"flushbuffer":[],"error":[],"delete":[null],"warning":[null]},"changes":[],"dirtyIds":[]},{"name":"$MESSAGES_COLLECTION$","data":[],"idIndex":null,"binaryIndices":{"accountName":{"name":"accountName","dirty":false,"values":[]},"queueName":{"name":"queueName","dirty":false,"values":[]},"messageId":{"name":"messageId","dirty":false,"values":[]},"visibleTime":{"name":"visibleTime","dirty":false,"values":[]}},"constraints":null,"uniqueNames":[],"transforms":{},"objType":"$MESSAGES_COLLECTION$","dirty":false,"cachedIndex":null,"cachedBinaryIndex":null,"cachedData":null,"adaptiveBinaryIndices":true,"transactional":false,"cloneObjects":false,"cloneMethod":"parse-stringify","asyncListeners":false,"disableMeta":false,"disableChangesApi":true,"disableDeltaChangesApi":true,"autoupdate":false,"serializableIndices":true,"disableFreeze":true,"ttl":null,"maxId":0,"DynamicViews":[],"events":{"insert":[],"update":[],"pre-insert":[],"pre-update":[],"close":[],"flushbuffer":[],"error":[],"delete":[null],"warning":[null]},"changes":[],"dirtyIds":[]}],"databaseVersion":1.5,"engineVersion":1.5,"autosave":true,"autosaveInterval":5000,"autosaveHandle":null,"throttledSaves":true,"options":{"persistenceMethod":"fs","autosave":true,"autosaveInterval":5000,"serializationMethod":"normal","destructureDelimiter":"$<\n"},"persistenceMethod":"fs","persistenceAdapter":null,"verbose":false,"events":{"init":[null],"loaded":[],"flushChanges":[],"close":[],"changes":[],"warning":[]},"ENV":"NODEJS"}

package/__azurite_db_queue_extent__.json

@@ -0,0 +1 @@
+{"filename":"C:\\Repos\\@kwiz\\node\\__azurite_db_queue_extent__.json","collections":[{"name":"$EXTENTS_COLLECTION$","data":[],"idIndex":null,"binaryIndices":{"id":{"name":"id","dirty":false,"values":[]}},"constraints":null,"uniqueNames":[],"transforms":{},"objType":"$EXTENTS_COLLECTION$","dirty":false,"cachedIndex":null,"cachedBinaryIndex":null,"cachedData":null,"adaptiveBinaryIndices":true,"transactional":false,"cloneObjects":false,"cloneMethod":"parse-stringify","asyncListeners":false,"disableMeta":false,"disableChangesApi":true,"disableDeltaChangesApi":true,"autoupdate":false,"serializableIndices":true,"disableFreeze":true,"ttl":null,"maxId":0,"DynamicViews":[],"events":{"insert":[],"update":[],"pre-insert":[],"pre-update":[],"close":[],"flushbuffer":[],"error":[],"delete":[null],"warning":[null]},"changes":[],"dirtyIds":[]}],"databaseVersion":1.5,"engineVersion":1.5,"autosave":true,"autosaveInterval":5000,"autosaveHandle":null,"throttledSaves":true,"options":{"persistenceMethod":"fs","autosave":true,"autosaveInterval":5000,"serializationMethod":"normal","destructureDelimiter":"$<\n"},"persistenceMethod":"fs","persistenceAdapter":null,"verbose":false,"events":{"init":[null],"loaded":[],"flushChanges":[],"close":[],"changes":[],"warning":[]},"ENV":"NODEJS"}

package/__azurite_db_table__.json

@@ -0,0 +1 @@
+{"filename":"C:\\Repos\\@kwiz\\node\\__azurite_db_table__.json","collections":[{"name":"$TABLES_COLLECTION$","data":[],"idIndex":[],"binaryIndices":{"account":{"name":"account","dirty":false,"values":[]},"table":{"name":"table","dirty":false,"values":[]}},"constraints":null,"uniqueNames":[],"transforms":{},"objType":"$TABLES_COLLECTION$","dirty":false,"cachedIndex":null,"cachedBinaryIndex":null,"cachedData":null,"adaptiveBinaryIndices":true,"transactional":false,"cloneObjects":false,"cloneMethod":"parse-stringify","asyncListeners":false,"disableMeta":false,"disableChangesApi":true,"disableDeltaChangesApi":true,"autoupdate":false,"serializableIndices":true,"disableFreeze":true,"ttl":null,"maxId":5,"DynamicViews":[],"events":{"insert":[],"update":[],"pre-insert":[],"pre-update":[],"close":[],"flushbuffer":[],"error":[],"delete":[null],"warning":[null]},"changes":[],"dirtyIds":[]},{"name":"$SERVICES_COLLECTION$","data":[],"idIndex":null,"binaryIndices":{},"constraints":null,"uniqueNames":["accountName"],"transforms":{},"objType":"$SERVICES_COLLECTION$","dirty":false,"cachedIndex":null,"cachedBinaryIndex":null,"cachedData":null,"adaptiveBinaryIndices":true,"transactional":false,"cloneObjects":false,"cloneMethod":"parse-stringify","asyncListeners":false,"disableMeta":false,"disableChangesApi":true,"disableDeltaChangesApi":true,"autoupdate":false,"serializableIndices":true,"disableFreeze":true,"ttl":null,"maxId":0,"DynamicViews":[],"events":{"insert":[],"update":[],"pre-insert":[],"pre-update":[],"close":[],"flushbuffer":[],"error":[],"delete":[null],"warning":[null]},"changes":[],"dirtyIds":[]}],"databaseVersion":1.5,"engineVersion":1.5,"autosave":true,"autosaveInterval":5000,"autosaveHandle":null,"throttledSaves":true,"options":{"persistenceMethod":"fs","autosave":true,"autosaveInterval":5000,"serializationMethod":"normal","destructureDelimiter":"$<\n"},"persistenceMethod":"fs","persistenceAdapter":null,"verbose":false,"events":{"init":[null],"loaded":[],"flushChanges":[],"close":[],"changes":[],"warning":[]},"ENV":"NODEJS"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kwiz/node",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "KWIZ utilities and helpers for node applications",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -24,7 +24,9 @@
     "npm-publish": "npm publish --access public",
     "reset-repo": "git fetch origin && git reset --hard origin/main",
     "link-local-common": "npm link @kwiz/common",
-    "reindex-project": "cti create ./src -i _dependencies -w -b -n -o exports-index.ts && node fix-folder-imports.js"
+    "reindex-project": "cti create ./src -i _dependencies -w -b -n -o exports-index.ts && node fix-folder-imports.js",
+    "install-packages": "npm install azurite -g && npm ci",
+    "startDevStorage": "azurite -s -l"
   },
   "repository": {
     "type": "git",
@@ -64,6 +66,7 @@
     "typescript": "^5.3.3"
   },
   "dependencies": {
+    "@azure/data-tables": "^13.2.2",
     "@azure/msal-node": "^2.6.4",
     "@kwiz/common": "^1.0.10",
     "axios": "^1.6.7",

package/src/exports-index.ts

@@ -1,4 +1,5 @@
 export * from './auth/exports-index';
 export * from './graph/exports-index';
 export * from './spo/exports-index';
+export * from './storage/exports-index';
 export * from './axios';

package/src/storage/exports-index.ts

@@ -0,0 +1,2 @@
+export * from './odata';
+export * from './table-storage';

package/src/storage/odata.ts

@@ -0,0 +1,87 @@
+import { isNullOrEmptyArray, isNullOrEmptyString, isNullOrUndefined } from "@kwiz/common";
+
+export enum ODataOperators {
+    equal = "eq",
+    notEqual = "ne",
+    greater = "gt",
+    greaterOrEqual = "ge",
+    less = "lt",
+    lessOrEqual = "le",
+    contains = "in",
+    startswith = "startswith"
+}
+export enum ODataJoinOperators {
+    and = "and",
+    or = "or"
+}
+
+export interface IOdataFilter<DataType> {
+    property: keyof DataType;
+    operator: ODataOperators;
+    value: string | Date | number | boolean;
+    not?: boolean;
+}
+export interface IOdataFilterStatement<DataType> {
+    filters: (IOdataFilter<DataType> | IOdataFilterStatement<DataType>)[];
+    /** default: or */
+    join?: ODataJoinOperators;
+    not?: boolean;
+}
+function isIOdataFilter<DataType>(f: IOdataFilter<DataType> | IOdataFilterStatement<DataType>): f is IOdataFilter<DataType> {
+    if (typeof (f as IOdataFilter<DataType>).property === "string")
+        return true;
+    return false;
+}
+function isIOdataFilterStatement<DataType>(f: IOdataFilter<DataType> | IOdataFilterStatement<DataType>): f is IOdataFilter<DataType> {
+    if (typeof (f as IOdataFilterStatement<DataType>).filters === "object" && Array.isArray((f as IOdataFilterStatement<DataType>).filters))
+        return true;
+    return false;
+}
+
+enum TableStorageKnownColumns {
+    partitionKey = "PartitionKey",
+    rowKey = "RowKey"
+}
+
+function getPropNameForFilter(prop: string | number | symbol) {
+    return TableStorageKnownColumns[prop] || prop as string;
+}
+function getOdataFilterStatement<DataType>(filter: IOdataFilter<DataType>) {
+    let filterValue = isNullOrUndefined(filter.value)
+        ? `null`
+        : typeof filter.value === "string"
+            ? `'${filter.value.replace(/'/g, "''")}'`
+            : filter.value instanceof Date
+                ? `datetime'${filter.value.toISOString()}'`
+                : `${filter.value}`;
+
+    if (filter.operator === ODataOperators.startswith)
+        return `${filter.not ? 'not ' : ''}${filter.operator}(${getPropNameForFilter(filter.property)}, ${filterValue})`;
+    return `${filter.not ? 'not ' : ''}${getPropNameForFilter(filter.property)} ${filter.operator} ${filterValue}`;
+}
+
+export function getOdataFilter<DataType>(statement: IOdataFilterStatement<DataType>) {
+    if (isNullOrUndefined(statement) || isNullOrEmptyArray(statement.filters)) return "";
+    if (isNullOrEmptyString(statement.join)) statement.join = ODataJoinOperators.or;
+
+    let filterStatements: string[] = [];
+    statement.filters.forEach(filter => {
+        if (isIOdataFilter(filter)) {
+            filterStatements.push(getOdataFilterStatement<DataType>(filter));
+        }
+        else {
+            let subStatement = getOdataFilter(filter);
+            if (!isNullOrEmptyString(subStatement))
+                filterStatements.push(subStatement);
+        }
+    });
+    if (filterStatements.length === 0) return "";
+
+    let result = "";
+    if (filterStatements.length === 1) result = filterStatements[0];
+    else if (filterStatements.length > 1) {
+        result = `(${filterStatements.join(` ${statement.join} `)})`;
+    }
+
+    return `${statement.not ? '(not ' : ''}${result}${statement.not ? ')' : ''}`;
+}

package/src/storage/table-storage.test.js

@@ -0,0 +1,129 @@
+import assert from 'assert/strict';
+import test from 'node:test';
+import { ODataOperators } from "./odata";
+import { ConfigureTableStorage, Table, addItem, ensureTable } from "./table-storage";
+
+test('testTableStorage', async t => {
+    //configure storage
+    ConfigureTableStorage({ connectionString: "UseDevelopmentStorage=true" });
+
+    const tableName = "TestTable";
+    const table = new Table(tableName, {
+        getKeys: p => p,
+        transform: {
+            load: v => ({ ...v, schedule: JSON.parse(v.schedule) }),
+            save: v => ({ ...v, schedule: JSON.stringify(v.schedule) })
+        }
+    });
+    const partitionKey = "PK1";
+    const partitionKey2 = "PK2";
+    const rowKey1 = "0b8612bb-377d-4897-be8f-a532a1ad3e73|d2e32b93-c096-431c-8a79-fcce9a4d7bce";
+    const rowKey2 = "0b8612bb-377d-4897-be8f-a532a1ad3e73|cd24aa15-0d03-4892-bb46-af32e5fb9361";
+    //start fresh
+    let result = await table.delete();
+    await t.test("Delete table", t => assert.strictEqual(result, true));
+
+    //provoke table name not allowed
+    result = await ensureTable("T2");
+    await t.test("Table name not allowed", t => assert.strictEqual(result, false));
+
+    //create table
+    result = await table.ensure();
+    await t.test("Create table", t => assert.strictEqual(result, true));
+
+    //provoke table already exists
+    result = await table.ensure();
+    await t.test("Ensure existing table", t => assert.strictEqual(result, true));
+
+    //add item
+    result = await table.addItem({
+        partitionKey: partitionKey,
+        rowKey: rowKey1,
+        list: "1bd32599-375e-4c98-9e1c-ce9dd2f2e17d",
+        action: "6b964dd7-6e62-42f6-89e4-5e79d6b6cbb0",
+        nextUTC: "2023010105",
+        schedule: { days: 4, hours: [1, 2, 3] }
+    });
+    await t.test("Create item 1", t => assert.strictEqual(result, true));
+
+    result = await table.addItem({
+        partitionKey: partitionKey,
+        rowKey: rowKey2,
+        list: "1bd32599-375e-4c98-9e1c-ce9dd2f2e17d",
+        action: "fab4094b-c000-4ff4-bb52-0f8538b2bc49",
+        nextUTC: "2023010105",
+        schedule: { days: 4, hours: [1, 2, 3] }
+    });
+    await t.test("Create item 2", t => assert.strictEqual(result, true));
+
+    result = await table.addItem({
+        partitionKey: partitionKey2,
+        rowKey: rowKey1,
+        list: "b98211e2-809a-4761-b928-559eddc28dfc",
+        action: "d20196e5-feb9-4202-bd03-718b49bf029e",
+        nextUTC: "2023010105",
+        schedule: { days: 4, hours: [1, 2, 3] }
+    });
+    await t.test("Create item in second partition", t => assert.strictEqual(result, true));
+
+    //provoke add second item with same key
+    result = await table.addItem({
+        partitionKey: partitionKey,
+        rowKey: rowKey1,
+        list: "1bd32599-375e-4c98-9e1c-ce9dd2f2e17d",
+        action: "6b964dd7-6e62-42f6-89e4-5e79d6b6cbb0",
+        nextUTC: "2023010105",
+        schedule: { days: 4, hours: [1, 2, 3] }
+    });
+    await t.test("Create item with existing key", t => assert.strictEqual(result, false));
+
+    //provoke add second item with same key
+    result = await table.upsertItem({
+        partitionKey: partitionKey,
+        rowKey: rowKey1,
+        list: "1bd32599-375e-4c98-9e1c-ce9dd2f2e17d",
+        action: "6b964dd7-6e62-42f6-89e4-5e79d6b6cbb0",
+        nextUTC: "2023020202",
+        schedule: { days: 4, hours: [1, 2, 3] }
+    });
+    await t.test("Update item 1", t => assert.strictEqual(result, true));
+
+    //provoke add item to table that does not exist
+    result = await addItem(tableName + "DoeNotExist", {
+        partitionKey: partitionKey,
+        rowKey: rowKey1,
+        list: "1bd32599-375e-4c98-9e1c-ce9dd2f2e17d",
+        action: "6b964dd7-6e62-42f6-89e4-5e79d6b6cbb0",
+        nextUTC: "2023020202",
+        schedule: { days: 4, hours: [1, 2, 3] }
+    });
+    await t.test("Create item in table that does not exist", t => assert.strictEqual(result, false));
+
+    let allItems = await table.getItems();
+    await t.test("Get items", t => assert.strictEqual(allItems.length, 3));
+
+    //find items by partition
+    let partitionItems = await table.getItems({
+        filterStatment: {
+            filters: [
+                {
+                    property: "partitionKey",
+                    operator: ODataOperators.equal,
+                    value: partitionKey
+                }
+            ]
+        }
+    });
+
+    await t.test("Get items with filter", t => assert.strictEqual(partitionItems.length, 2));
+    await t.test("Update values", t => assert.strictEqual(partitionItems[1].nextUTC, "2023020202"));
+
+    let deleteResult = await table.deleteItem({ partitionKey: partitionKey, rowKey: rowKey1 });
+    await t.test("delete item", t => assert.strictEqual(deleteResult, true));
+    deleteResult = await table.deleteItem({ partitionKey: partitionKey, rowKey: rowKey1 });
+    await t.test("delete item that was already deleted", t => assert.strictEqual(deleteResult, true));
+
+    //cleanup
+    result = await table.delete();
+    await t.test("Delete table", t => assert.strictEqual(result, true));
+});

package/src/storage/table-storage.ts

@@ -0,0 +1,314 @@
+//https://www.npmjs.com/package/@azure/storage-blob
+//https://www.npmjs.com/package/@azure/storage-queue
+//https://www.npmjs.com/package/@azure/storage-file-share
+//https://www.npmjs.com/package/@azure/data-tables
+//https://learn.microsoft.com/en-us/azure/storage/common/storage-use-azurite?tabs=visual-studio-code
+import { FullOperationResponse } from "@azure/core-client";
+import { ListTableEntitiesOptions, TableClient, TableServiceClient, UpdateMode, odata } from "@azure/data-tables";
+import { isNullOrEmptyString, isNullOrUndefined } from "@kwiz/common";
+import { IOdataFilterStatement, getOdataFilter } from "./odata";
+
+var connectionString: string = null;
+export function ConfigureTableStorage(config: { connectionString: string; }) {
+    connectionString = config.connectionString;
+}
+
+function getTableService() {
+    if (isNullOrEmptyString(connectionString)) throw Error("Call ConfigureTableStorage first");
+    return TableServiceClient.fromConnectionString(connectionString);
+}
+function getTableClient(tableName: string) {
+    if (isNullOrEmptyString(connectionString)) throw Error("Call ConfigureTableStorage first");
+    return TableClient.fromConnectionString(connectionString, tableName);
+}
+
+interface IODataError {
+    odataError: {
+        code: string | "TableAlreadyExists" | "EntityAlreadyExists" | "TableNotFound" | "",
+        message: {
+            lang: string | "en-US",
+            value: string
+        }
+    }
+}
+
+type TableEntityBase = {
+    /**
+     * The PartitionKey property of the entity.
+     * Does not allow / \ # ? any control characted (like \n)
+     */
+    partitionKey: string;
+    /**
+     * The RowKey property of the entity.
+     */
+    rowKey: string;
+}
+//correctly limits the column types...
+export type TableEntityType<DataType extends TableEntityBase> = {
+    [P in keyof DataType]: string | boolean | Date | number;
+};
+
+export async function findTable(tableName: string) {
+    const tableService = getTableService();
+
+    let found = false;
+    try {
+        const tables = tableService.listTables({
+            queryOptions: {
+                //Tag function - read more https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals
+                filter: odata`TableName eq ${tableName}`
+            }
+        });
+        for await (const table of tables) {
+            found = true;
+        }
+    } catch (e) {
+        //console.log(e);
+    }
+    return found;
+}
+
+export async function listTables() {
+    const tableService = getTableService();
+
+    let arr: string[] = [];
+    try {
+        const tables = tableService.listTables();
+        for await (const table of tables) {
+            arr.push(table.name);
+        }
+    } catch (e) {
+        //console.log(e);
+    }
+    return arr;
+}
+
+// async function ensureTableObsolete(name: string) {
+//     const tableService = getTableService();
+//     //create table
+//     // If the table 'newTable' already exists, createTable doesn't throw
+//     let success = false;
+//     try {
+//         await tableService.createTable(name, {
+//             onResponse: raw => {
+//                 let error = isError(raw);
+//                 success = error.isError !== true;
+//                 if (error.isError) console.log(error.message);
+//             }
+//         });
+//     }
+//     catch (e) {
+//         success = false;
+//     }
+
+//     return success;
+// }
+
+export async function ensureTable(tableName: string) {
+    const table = getTableClient(tableName);
+    let success = false;
+    try {
+        await table.createTable({
+            onResponse: raw => {
+                let error = isError(raw);
+                success = error.isError !== true || error.message === "TableAlreadyExists";
+                //if (error.isError) console.error(error.message);
+            }
+        });
+    } catch (e) {
+        //console.error(e);
+    }
+
+    return success;
+}
+
+export async function deleteTable(tableName: string) {
+    const table = getTableClient(tableName);
+    let success = false;
+    try {
+        await table.deleteTable({
+            onResponse: raw => {
+                let error = isError(raw);
+                success = error.isError !== true;
+                //if (error.isError) console.log(error.message);
+            }
+        });
+    } catch (e) {
+        //console.log(e);
+    }
+
+    return success;
+}
+
+//https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/tables/data-tables/samples/v13/typescript/src/queryEntities.ts
+export async function getItems<DataType extends TableEntityBase & TableEntityType<DataType>>(tableName: string, options?: {
+    filterStatment?: IOdataFilterStatement<DataType>;
+    postFilter?: (item: DataType) => boolean;
+}) {
+    const table = getTableClient(tableName);
+    let result: DataType[] = [];
+    try {
+        let o: ListTableEntitiesOptions;
+        if (options) {
+            if (!isNullOrUndefined(options.filterStatment)) {
+                let filterStatment = getOdataFilter(options.filterStatment);
+                if (!isNullOrEmptyString(filterStatment))
+                    o = {
+                        queryOptions: {
+                            filter: filterStatment
+                        }
+                    };
+            }
+        }
+        let items = table.listEntities<DataType>(o);
+        for await (const item of items) {
+            //console.dir(item);
+            if (!options || typeof options.postFilter !== "function" || options.postFilter(item))
+                result.push(item as DataType);
+        }
+    } catch (e) {
+        //console.log(e);
+    }
+    return result;
+}
+
+export async function addItem<DataType extends TableEntityBase & TableEntityType<DataType>>(tableName: string, item: DataType) {
+    const table = getTableClient(tableName);
+    let success = false;
+    try {
+        let result = await table.createEntity(item, {
+            onResponse: raw => {
+                let error = isError(raw);
+                success = error.isError !== true;
+                //if (error.isError) console.log(error.message);
+            }
+        });
+        //console.log(result);
+        success = true;
+    } catch (e) { success = false; }
+    return success;
+}
+
+export async function deleteItem(tableName: string, partitionKey: string, rowKey: string) {
+    const table = getTableClient(tableName);
+    let success = false;
+    try {
+        let result = await table.deleteEntity(partitionKey, rowKey, {
+            onResponse: raw => {
+                let error = isError(raw);
+                success = error.isError !== true || error.message === "ResourceNotFound";
+            }
+        });
+        //console.log(result);
+        success = true;
+    } catch (e) {
+        //success = false;
+    }
+    return success;
+}
+
+export async function upsertItem<DataType extends TableEntityBase & TableEntityType<DataType>>(tableName: string, item: DataType, options?: {
+    mode?: UpdateMode
+}) {
+    const table = getTableClient(tableName);
+    let success = false;
+    try {
+        let result = await table.upsertEntity(item, options?.mode || "Replace", {
+            onResponse: raw => {
+                let error = isError(raw);
+                success = error.isError !== true;
+                //if (error.isError) console.log(error.message);
+            }
+        });
+        //console.log(result);
+        success = true;
+    } catch (e) {
+        console.error(e);
+        success = false;
+    }
+    return success;
+}
+
+export class Table<KeysType extends TableEntityBase,
+    GetKeysParam,
+    SavedRow extends KeysType & TableEntityType<SavedRow>,
+    ParsedRow = SavedRow>{
+    private tableName: string;
+    private transform: {
+        save: (parsed: ParsedRow, table: Table<KeysType, GetKeysParam, SavedRow, ParsedRow>) => SavedRow;
+        load: (saved: SavedRow, table: Table<KeysType, GetKeysParam, SavedRow, ParsedRow>) => ParsedRow;
+    }
+
+    public getKeys: (p: GetKeysParam) => KeysType = null;
+
+    /** If your type contains complex values, provide a transforer to serialize/deserialize those complex columns */
+    public constructor(tableName: string, options: {
+        getKeys: (p: GetKeysParam) => KeysType,
+        transform?: {
+            save: (parsed: ParsedRow, table: Table<KeysType, GetKeysParam, SavedRow, ParsedRow>) => SavedRow;
+            load: (saved: SavedRow, table: Table<KeysType, GetKeysParam, SavedRow, ParsedRow>) => ParsedRow;
+        }
+    }) {
+        this.tableName = tableName;
+        this.getKeys = options.getKeys;
+        this.transform = options.transform || {
+            save: v => v as any as SavedRow,
+            load: v => v as any as ParsedRow
+        };
+    }
+    public delete() {
+        return deleteTable(this.tableName);
+    }
+    public ensure() {
+        return ensureTable(this.tableName);
+    }
+    public async getItems(options?: {
+        filterStatment?: IOdataFilterStatement<SavedRow>;
+        postFilter?: (item: SavedRow) => boolean;
+    }) {
+        let items = await getItems<SavedRow>(this.tableName, options);
+        return items.map(i => this.transform.load(i, this));
+    }
+    public async addItem(item: ParsedRow) {
+        await this.ensure();
+
+        return addItem<SavedRow>(this.tableName, this.transform.save(item, this));
+    }
+    public async upsertItem(item: ParsedRow, options?: {
+        mode?: UpdateMode
+    }) {
+        await this.ensure();
+
+        return upsertItem<SavedRow>(this.tableName, this.transform.save(item, this), options);
+    }
+    public deleteItemByKey(param: GetKeysParam) {
+        let keys = this.getKeys(param);
+        return this.deleteItem(keys);
+    }
+    public deleteItem(item: KeysType) {
+        return deleteItem(this.tableName, item.partitionKey, item.rowKey);
+    }
+}
+
+function isError(raw: FullOperationResponse) {
+    let isError = false;
+    let message: string = null;
+
+    //201 - table created successfully
+    //204 - entity created successfully
+    //409 - table/entity already exists
+    //400 - table name not allowed
+    //404 - TableNotFound when adding item
+    if (raw.status >= 400) {
+        isError = true;
+        let error = raw.parsedBody as IODataError;
+        message = error && error.odataError && !isNullOrEmptyString(error.odataError.code)
+            ? error.odataError.code
+            : `Unknown error`;//for some errors like table name too short, error code is empty
+    }
+    else {
+        isError = false;
+    }
+
+    return { isError, message };
+}