anbaric-tsapi 1.55.0 → 1.56.0

package/dist/api/files/FileStorage.d.ts

@@ -0,0 +1,33 @@
+import { Actor } from "../actors/Actor.js";
+import { Auditor } from "../auditing/Auditor.js";
+type StoredFile = {
+    path: string;
+    contents: Uint8Array;
+    contentType: string;
+    size: number;
+    lastModified: Date;
+};
+type StoredFileInfo = Omit<StoredFile, "contents">;
+declare abstract class FileStorage {
+    protected auditor: Auditor;
+    constructor(auditor: Auditor);
+    put(actor: Actor, path: string, contents: Uint8Array, contentType?: string): Promise<void>;
+    get(path: string, actor: Actor): Promise<StoredFile>;
+    delete(path: string, actor: Actor): Promise<void>;
+    list(prefix: string, actor: Actor): Promise<Array<StoredFileInfo>>;
+    protected abstract putInternal(path: string, contents: Uint8Array, contentType: string): Promise<void>;
+    protected abstract getInternal(path: string): Promise<StoredFile>;
+    protected abstract deleteInternal(path: string): Promise<void>;
+    protected abstract listInternal(prefix: string): Promise<Array<StoredFileInfo>>;
+}
+declare namespace FileStorage {
+    enum Interaction {
+        PUT = "PUT",
+        READ = "READ",
+        DELETE = "DELETE",
+        LIST = "LIST"
+    }
+}
+export { FileStorage };
+export type { StoredFile, StoredFileInfo };
+//# sourceMappingURL=FileStorage.d.ts.map

package/dist/api/files/FileStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileStorage.d.ts","sourceRoot":"","sources":["../../../src/api/files/FileStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAC,OAAO,EAAC,MAAM,wBAAwB,CAAC;AAM/C,KAAK,UAAU,GAAG;IAEd,IAAI,EAAG,MAAM,CAAC;IACd,QAAQ,EAAG,UAAU,CAAC;IACtB,WAAW,EAAG,MAAM,CAAC;IACrB,IAAI,EAAG,MAAM,CAAC;IACd,YAAY,EAAG,IAAI,CAAC;CAEvB,CAAC;AAEF,KAAK,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AAOnD,uBAAe,WAAW;IAEV,SAAS,CAAC,OAAO,EAAG,OAAO;IAAvC,YAAsB,OAAO,EAAG,OAAO,EACtC;IAEK,GAAG,CAAC,KAAK,EAAG,KAAK,EAAE,IAAI,EAAG,MAAM,EAAE,QAAQ,EAAG,UAAU,EAAE,WAAW,GAAG,MAAmC,GAAI,OAAO,CAAC,IAAI,CAAC,CAIhI;IAEK,GAAG,CAAC,IAAI,EAAG,MAAM,EAAE,KAAK,EAAG,KAAK,GAAI,OAAO,CAAC,UAAU,CAAC,CAG5D;IAEK,MAAM,CAAC,IAAI,EAAG,MAAM,EAAE,KAAK,EAAG,KAAK,GAAI,OAAO,CAAC,IAAI,CAAC,CAGzD;IAEK,IAAI,CAAC,MAAM,EAAG,MAAM,EAAE,KAAK,EAAG,KAAK,GAAI,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAG1E;IAED,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAG,MAAM,EAAE,QAAQ,EAAG,UAAU,EAAE,WAAW,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3G,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAG,MAAM,GAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IACpE,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAG,MAAM,GAAI,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;CAErF;AAED,kBAAU,WAAW,CAAC;IAElB,KAAY,WAAW;QACnB,GAAG,QAAQ;QACX,IAAI,SAAS;QACb,MAAM,WAAW;QACjB,IAAI,SAAS;KAChB;CAEJ;AAED,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC"}

package/dist/api/files/FileStorage.js

@@ -0,0 +1,39 @@
+import { currentAppId } from "../cloud/AppAware.js";
+/* Stores files under paths and audits every interaction. Contents never
+   appear in an audit record; their size and type do. Paths are relative,
+   forward-slash separated, and scoped to the calling app - an implementation
+   must refuse anything that could escape that scope. Public methods audit then
+   defer to the abstract ...Internal methods. */
+class FileStorage {
+    auditor;
+    constructor(auditor) {
+        this.auditor = auditor;
+    }
+    async put(actor, path, contents, contentType = "application/octet-stream") {
+        await this.auditor.audit(currentAppId(), "file", path, actor, [FileStorage.Interaction.PUT], "File stored", { size: contents.byteLength, contentType });
+        await this.putInternal(path, contents, contentType);
+    }
+    async get(path, actor) {
+        await this.auditor.audit(currentAppId(), "file", path, actor, [FileStorage.Interaction.READ], "", null);
+        return this.getInternal(path);
+    }
+    async delete(path, actor) {
+        await this.auditor.audit(currentAppId(), "file", path, actor, [FileStorage.Interaction.DELETE], "", null);
+        await this.deleteInternal(path);
+    }
+    async list(prefix, actor) {
+        await this.auditor.audit(currentAppId(), "file", prefix || "*", actor, [FileStorage.Interaction.LIST], "", null);
+        return this.listInternal(prefix);
+    }
+}
+(function (FileStorage) {
+    let Interaction;
+    (function (Interaction) {
+        Interaction["PUT"] = "PUT";
+        Interaction["READ"] = "READ";
+        Interaction["DELETE"] = "DELETE";
+        Interaction["LIST"] = "LIST";
+    })(Interaction = FileStorage.Interaction || (FileStorage.Interaction = {}));
+})(FileStorage || (FileStorage = {}));
+export { FileStorage };
+//# sourceMappingURL=FileStorage.js.map

package/dist/api/files/FileStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileStorage.js","sourceRoot":"","sources":["../../../src/api/files/FileStorage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,YAAY,EAAC,MAAM,sBAAsB,CAAC;AAiBlD;;;;gDAIgD;AAChD,MAAe,WAAW;IAEA,OAAO;IAA7B,YAAsB,OAAiB;uBAAjB,OAAO;IAC7B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAAa,EAAE,IAAa,EAAE,QAAqB,EAAE,WAAW,GAAY,0BAA0B;QAC5G,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,aAAa,EACtG,EAAE,IAAI,EAAE,QAAQ,CAAC,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;QAChD,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAa,EAAE,KAAa;QAClC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QACxG,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAa,EAAE,KAAa;QACrC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QAC1G,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAe,EAAE,KAAa;QACrC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QACjH,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;CAOJ;AAED,WAAU,WAAW;IAEjB,IAAY,WAKX;IALD,WAAY,WAAW;QACnB,0BAAW,CAAA;QACX,4BAAa,CAAA;QACb,gCAAiB,CAAA;QACjB,4BAAa,CAAA;IACjB,CAAC,EALW,WAAW,GAAX,YAAA,WAAW,KAAX,YAAA,WAAW,QAKtB;AAEL,CAAC,EATS,WAAW,KAAX,WAAW,QASpB;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/index.d.ts

@@ -19,6 +19,7 @@ export * from "./api/actors/SystemActor.js";
 export * from "./api/sessions/SessionResolver.js";
 export * from "./api/documents/JsonStore.js";
 export * from "./api/secrets/SecretStore.js";
+export * from "./api/files/FileStorage.js";
 export * from "./api/entitlements/Entitlements.js";
 export * from "./api/prompts/PromptManager.js";
 export * from "./api/sql/SqlStore.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kCAAkC,CAAA;AAChD,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,qCAAqC,CAAA;AACnD,cAAc,qCAAqC,CAAA;AACnD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,oCAAoC,CAAA;AAClD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,kDAAkD,CAAA;AAChE,cAAc,iCAAiC,CAAA;AAC/C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kCAAkC,CAAA;AAChD,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,qCAAqC,CAAA;AACnD,cAAc,qCAAqC,CAAA;AACnD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oCAAoC,CAAA;AAClD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,kDAAkD,CAAA;AAChE,cAAc,iCAAiC,CAAA;AAC/C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA"}

package/dist/index.js

@@ -19,6 +19,7 @@ export * from "./api/actors/SystemActor.js";
 export * from "./api/sessions/SessionResolver.js";
 export * from "./api/documents/JsonStore.js";
 export * from "./api/secrets/SecretStore.js";
+export * from "./api/files/FileStorage.js";
 export * from "./api/entitlements/Entitlements.js";
 export * from "./api/prompts/PromptManager.js";
 export * from "./api/sql/SqlStore.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kCAAkC,CAAA;AAChD,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,qCAAqC,CAAA;AACnD,cAAc,qCAAqC,CAAA;AACnD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,oCAAoC,CAAA;AAClD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,kDAAkD,CAAA;AAChE,cAAc,iCAAiC,CAAA;AAC/C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kCAAkC,CAAA;AAChD,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,qCAAqC,CAAA;AACnD,cAAc,qCAAqC,CAAA;AACnD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oCAAoC,CAAA;AAClD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,kDAAkD,CAAA;AAChE,cAAc,iCAAiC,CAAA;AAC/C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anbaric-tsapi",
-  "version": "1.55.0",
+  "version": "1.56.0",
   "description": "These are the shared libraries - types, classes, etc - that both the public state-machine and hosting services share",
   "license": "MIT",
   "author": "chris@anbaric.ai",