@geekmidas/storage 0.0.1 → 0.0.3

package/dist/AmazonStorageClient-C16fG3G4.d.cts

@@ -0,0 +1,39 @@
+import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider } from "./StorageClient-D-y4QLDq.cjs";
+import { S3Client } from "@aws-sdk/client-s3";
+
+//#region src/AmazonStorageClient.d.ts
+declare class AmazonStorageClient implements StorageClient {
+  private readonly client;
+  private readonly bucket;
+  private readonly acl;
+  readonly provider = StorageProvider.AWSS3;
+  static create(options: AmazonStorageClientCreateOptions): AmazonStorageClient;
+  constructor(client: S3Client, bucket: string, acl?: AmazonCannedAccessControlList);
+  getVersionDownloadURL(file: File, versionId: string): Promise<string>;
+  getVersions(key: string): Promise<DocumentVersion[]>;
+  getDownloadURL(file: File, expiresIn?: number): Promise<string>;
+  getUploadURL(params: GetUploadParams, expiresIn?: number): Promise<string>;
+  getUpload(params: GetUploadParams, expiresIn?: number): Promise<GetUploadResponse>;
+  upload(key: string, data: string | Buffer, contentType: string): Promise<void>;
+}
+declare enum AmazonCannedAccessControlList {
+  AuthenticatedRead = "authenticated-read",
+  Private = "private",
+  PublicRead = "public-read",
+  PublicReadWrite = "public-read-write",
+  AwsExecRead = "aws-exec-read",
+  BucketOwnerRead = "bucket-owner-read",
+  BucketOwnerFullControl = "bucket-owner-full-control",
+  LogDeliveryWrite = "log-delivery-write",
+}
+interface AmazonStorageClientCreateOptions {
+  bucket: string;
+  region?: string;
+  acl?: AmazonCannedAccessControlList;
+  accessKeyId?: string;
+  secretAccessKey?: string;
+  endpoint?: string;
+  forcePathStyle?: boolean;
+}
+//#endregion
+export { AmazonCannedAccessControlList, AmazonStorageClient };

package/dist/AmazonStorageClient-CP8Tx5oE.d.mts

@@ -0,0 +1,39 @@
+import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider } from "./StorageClient-CJbHRTVV.mjs";
+import { S3Client } from "@aws-sdk/client-s3";
+
+//#region src/AmazonStorageClient.d.ts
+declare class AmazonStorageClient implements StorageClient {
+  private readonly client;
+  private readonly bucket;
+  private readonly acl;
+  readonly provider = StorageProvider.AWSS3;
+  static create(options: AmazonStorageClientCreateOptions): AmazonStorageClient;
+  constructor(client: S3Client, bucket: string, acl?: AmazonCannedAccessControlList);
+  getVersionDownloadURL(file: File, versionId: string): Promise<string>;
+  getVersions(key: string): Promise<DocumentVersion[]>;
+  getDownloadURL(file: File, expiresIn?: number): Promise<string>;
+  getUploadURL(params: GetUploadParams, expiresIn?: number): Promise<string>;
+  getUpload(params: GetUploadParams, expiresIn?: number): Promise<GetUploadResponse>;
+  upload(key: string, data: string | Buffer, contentType: string): Promise<void>;
+}
+declare enum AmazonCannedAccessControlList {
+  AuthenticatedRead = "authenticated-read",
+  Private = "private",
+  PublicRead = "public-read",
+  PublicReadWrite = "public-read-write",
+  AwsExecRead = "aws-exec-read",
+  BucketOwnerRead = "bucket-owner-read",
+  BucketOwnerFullControl = "bucket-owner-full-control",
+  LogDeliveryWrite = "log-delivery-write",
+}
+interface AmazonStorageClientCreateOptions {
+  bucket: string;
+  region?: string;
+  acl?: AmazonCannedAccessControlList;
+  accessKeyId?: string;
+  secretAccessKey?: string;
+  endpoint?: string;
+  forcePathStyle?: boolean;
+}
+//#endregion
+export { AmazonCannedAccessControlList, AmazonStorageClient };

package/dist/AmazonStorageClient.d.cts

@@ -0,0 +1,3 @@
+import "./StorageClient-D-y4QLDq.cjs";
+import { AmazonCannedAccessControlList, AmazonStorageClient } from "./AmazonStorageClient-C16fG3G4.cjs";
+export { AmazonCannedAccessControlList, AmazonStorageClient };

package/dist/AmazonStorageClient.d.mts

@@ -0,0 +1,3 @@
+import "./StorageClient-CJbHRTVV.mjs";
+import { AmazonCannedAccessControlList, AmazonStorageClient } from "./AmazonStorageClient-CP8Tx5oE.mjs";
+export { AmazonCannedAccessControlList, AmazonStorageClient };

package/dist/StorageClient-CJbHRTVV.d.mts

@@ -0,0 +1,77 @@
+//#region src/StorageClient.d.ts
+interface DocumentVersion {
+  id: string;
+  createdAt: Date;
+}
+declare enum StorageProvider {
+  AWSS3 = "geekimdas.toolbox.storage.aws.s3",
+  GCP = "geekimdas.toolbox.storage.gcp",
+  AZURE = "geekimdas.toolbox.storage.azure",
+}
+interface StorageClient {
+  readonly provider: StorageProvider;
+  /**
+   * Get a URL to upload a file to.
+   *
+   * @param params - The parameters to get the upload URL for.
+   * @param expiresIn - The number of minutes the URL should be valid for.
+   * Defaults to 60 * 60 (1 hour).
+   * @returns A promise that resolves to the upload URL.
+   */
+  getUploadURL(params: GetUploadParams, expiresIn?: number): Promise<string>;
+  /**
+   * Get a URL to download a file from.
+   *
+   * @param file - The file to get the download URL for.
+   * @param expiresIn - The number of seconds the URL should be valid for.
+   * Defaults to 60 * 60 (1 hour).
+   * @returns A promise that resolves to the download URL.
+   */
+  getDownloadURL(file: File, expiresIn?: number): Promise<string>;
+  /**
+   * Get the versions for a key.
+   *
+   * @param key - The key to get the versions for.
+   */
+  getVersions(key: string): Promise<DocumentVersion[]>;
+  /**
+   * Get a URL to download a version of a file from.
+   *
+   * @param file - The file to get the download URL for.
+   * @param versionId - The version ID to get the download URL for.
+   */
+  getVersionDownloadURL(file: File, versionId: string): Promise<string>;
+  /**
+   *
+   * @param key - The key to upload the file to.
+   * @param data - The data to upload.
+   * @param contentType - The content type of the data.
+   */
+  upload(key: string, data: string | Buffer, contentType: string): Promise<void>;
+  /**
+   * Get a URL to upload a file to.
+   *
+   * @param params - The parameters to get the upload URL for.
+   * @param expiresIn - The number of minutes the URL should be valid for.
+   */
+  getUpload(params: GetUploadParams, expiresIn?: number): Promise<GetUploadResponse>;
+}
+interface GetUploadParams {
+  path: string;
+  contentType: string;
+  contentLength: number;
+}
+type UploadField = {
+  key: string;
+  value: string;
+};
+type GetUploadResponse = {
+  url: string;
+  fields: UploadField[];
+};
+interface File {
+  name?: string;
+  path: string;
+}
+//#endregion
+export { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider, UploadField };

package/dist/StorageClient-D-y4QLDq.d.cts

@@ -0,0 +1,77 @@
+//#region src/StorageClient.d.ts
+interface DocumentVersion {
+  id: string;
+  createdAt: Date;
+}
+declare enum StorageProvider {
+  AWSS3 = "geekimdas.toolbox.storage.aws.s3",
+  GCP = "geekimdas.toolbox.storage.gcp",
+  AZURE = "geekimdas.toolbox.storage.azure",
+}
+interface StorageClient {
+  readonly provider: StorageProvider;
+  /**
+   * Get a URL to upload a file to.
+   *
+   * @param params - The parameters to get the upload URL for.
+   * @param expiresIn - The number of minutes the URL should be valid for.
+   * Defaults to 60 * 60 (1 hour).
+   * @returns A promise that resolves to the upload URL.
+   */
+  getUploadURL(params: GetUploadParams, expiresIn?: number): Promise<string>;
+  /**
+   * Get a URL to download a file from.
+   *
+   * @param file - The file to get the download URL for.
+   * @param expiresIn - The number of seconds the URL should be valid for.
+   * Defaults to 60 * 60 (1 hour).
+   * @returns A promise that resolves to the download URL.
+   */
+  getDownloadURL(file: File, expiresIn?: number): Promise<string>;
+  /**
+   * Get the versions for a key.
+   *
+   * @param key - The key to get the versions for.
+   */
+  getVersions(key: string): Promise<DocumentVersion[]>;
+  /**
+   * Get a URL to download a version of a file from.
+   *
+   * @param file - The file to get the download URL for.
+   * @param versionId - The version ID to get the download URL for.
+   */
+  getVersionDownloadURL(file: File, versionId: string): Promise<string>;
+  /**
+   *
+   * @param key - The key to upload the file to.
+   * @param data - The data to upload.
+   * @param contentType - The content type of the data.
+   */
+  upload(key: string, data: string | Buffer, contentType: string): Promise<void>;
+  /**
+   * Get a URL to upload a file to.
+   *
+   * @param params - The parameters to get the upload URL for.
+   * @param expiresIn - The number of minutes the URL should be valid for.
+   */
+  getUpload(params: GetUploadParams, expiresIn?: number): Promise<GetUploadResponse>;
+}
+interface GetUploadParams {
+  path: string;
+  contentType: string;
+  contentLength: number;
+}
+type UploadField = {
+  key: string;
+  value: string;
+};
+type GetUploadResponse = {
+  url: string;
+  fields: UploadField[];
+};
+interface File {
+  name?: string;
+  path: string;
+}
+//#endregion
+export { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider, UploadField };

package/dist/StorageClient.d.cts

@@ -0,0 +1,2 @@
+import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider, UploadField } from "./StorageClient-D-y4QLDq.cjs";
+export { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider, UploadField };

package/dist/StorageClient.d.mts

@@ -0,0 +1,2 @@
+import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider, UploadField } from "./StorageClient-CJbHRTVV.mjs";
+export { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider, UploadField };

package/dist/__tests__/AmazonStorageClient.spec.cjs

@@ -1,7 +1,7 @@
 const require_chunk = require('../chunk-DWy1uDak.cjs');
 const require_StorageClient = require('../StorageClient-BDRVrMJj.cjs');
 const require_AmazonStorageClient = require('../AmazonStorageClient-DT9DeKVz.cjs');
-const require_vi_bdSIJ99Y = require('../vi.bdSIJ99Y-wDZVsqf8.cjs');
+const require_vi_bdSIJ99Y = require('../vi.bdSIJ99Y-D0m6qImj.cjs');
 const __aws_sdk_client_s3 = require_chunk.__toESM(require("@aws-sdk/client-s3"));
 
 //#region src/__tests__/AmazonStorageClient.spec.ts

package/dist/__tests__/AmazonStorageClient.spec.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/AmazonStorageClient.spec.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/AmazonStorageClient.spec.mjs

@@ -1,4 +1,4 @@
-import { beforeAll, describe, globalExpect, it } from "../vi.bdSIJ99Y-B0LMQgq6.mjs";
+import { beforeAll, describe, globalExpect, it } from "../vi.bdSIJ99Y-CucmVasy.mjs";
 import { StorageProvider } from "../StorageClient-CZGIC_fz.mjs";
 import { AmazonCannedAccessControlList, AmazonStorageClient } from "../AmazonStorageClient-DJMWn8vO.mjs";
 import { S3Client } from "@aws-sdk/client-s3";

package/dist/__tests__/StorageClient.spec.cjs

@@ -1,5 +1,5 @@
 const require_StorageClient = require('../StorageClient-BDRVrMJj.cjs');
-const require_vi_bdSIJ99Y = require('../vi.bdSIJ99Y-wDZVsqf8.cjs');
+const require_vi_bdSIJ99Y = require('../vi.bdSIJ99Y-D0m6qImj.cjs');
 
 //#region src/__tests__/StorageClient.spec.ts
 require_vi_bdSIJ99Y.describe("StorageClient", () => {

package/dist/__tests__/StorageClient.spec.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/StorageClient.spec.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/StorageClient.spec.mjs

@@ -1,4 +1,4 @@
-import { describe, globalExpect, it } from "../vi.bdSIJ99Y-B0LMQgq6.mjs";
+import { describe, globalExpect, it } from "../vi.bdSIJ99Y-CucmVasy.mjs";
 import { StorageProvider } from "../StorageClient-CZGIC_fz.mjs";
 
 //#region src/__tests__/StorageClient.spec.ts

package/dist/aws.d.cts

@@ -0,0 +1,3 @@
+import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient } from "./StorageClient-D-y4QLDq.cjs";
+import { AmazonCannedAccessControlList, AmazonStorageClient } from "./AmazonStorageClient-C16fG3G4.cjs";
+export { AmazonCannedAccessControlList, AmazonStorageClient, DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient };

package/dist/aws.d.mts

@@ -0,0 +1,3 @@
+import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient } from "./StorageClient-CJbHRTVV.mjs";
+import { AmazonCannedAccessControlList, AmazonStorageClient } from "./AmazonStorageClient-CP8Tx5oE.mjs";
+export { AmazonCannedAccessControlList, AmazonStorageClient, DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient };

package/dist/index.d.cts

@@ -0,0 +1,2 @@
+import { StorageClient } from "./StorageClient-D-y4QLDq.cjs";
+export { StorageClient };

package/dist/index.d.mts

@@ -0,0 +1,2 @@
+import { StorageClient } from "./StorageClient-CJbHRTVV.mjs";
+export { StorageClient };

package/dist/{vi.bdSIJ99Y-B0LMQgq6.mjs → vi.bdSIJ99Y-CucmVasy.mjs}

@@ -10335,7 +10335,7 @@ function createTestHook(name, handler) {
 }
 
 //#endregion
-//#region ../../node_modules/.pnpm/vitest@3.2.4_@types+node@22.16.3_@vitest+ui@3.2.4_jiti@2.4.2_jsdom@26.1.0_msw@2.10.3_@t_04250e705606c7b90022e49f9988d66d/node_modules/vitest/dist/chunks/utils.XdZDrNZV.js
+//#region ../../node_modules/.pnpm/vitest@3.2.4_@types+node@22.16.3_@vitest+ui@3.2.4_jiti@2.4.2_jsdom@26.1.0_lightningcss@_9e855e585de3badded1a4cd0b32436f6/node_modules/vitest/dist/chunks/utils.XdZDrNZV.js
 const NAME_WORKER_STATE = "__vitest_worker__";
 function getWorkerState() {
 	const workerState = globalThis[NAME_WORKER_STATE];
@@ -10384,7 +10384,7 @@ async function waitForImportsToResolve() {
 }
 
 //#endregion
-//#region ../../node_modules/.pnpm/vitest@3.2.4_@types+node@22.16.3_@vitest+ui@3.2.4_jiti@2.4.2_jsdom@26.1.0_msw@2.10.3_@t_04250e705606c7b90022e49f9988d66d/node_modules/vitest/dist/chunks/_commonjsHelpers.BFTU3MAI.js
+//#region ../../node_modules/.pnpm/vitest@3.2.4_@types+node@22.16.3_@vitest+ui@3.2.4_jiti@2.4.2_jsdom@26.1.0_lightningcss@_9e855e585de3badded1a4cd0b32436f6/node_modules/vitest/dist/chunks/_commonjsHelpers.BFTU3MAI.js
 var commonjsGlobal = typeof globalThis !== "undefined" ? globalThis : typeof window !== "undefined" ? window : typeof global !== "undefined" ? global : typeof self !== "undefined" ? self : {};
 function getDefaultExportFromCjs(x) {
 	return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, "default") ? x["default"] : x;
@@ -12235,7 +12235,7 @@ var SnapshotClient = class {
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/vitest@3.2.4_@types+node@22.16.3_@vitest+ui@3.2.4_jiti@2.4.2_jsdom@26.1.0_msw@2.10.3_@t_04250e705606c7b90022e49f9988d66d/node_modules/vitest/dist/chunks/date.Bq6ZW5rf.js
+//#region ../../node_modules/.pnpm/vitest@3.2.4_@types+node@22.16.3_@vitest+ui@3.2.4_jiti@2.4.2_jsdom@26.1.0_lightningcss@_9e855e585de3badded1a4cd0b32436f6/node_modules/vitest/dist/chunks/date.Bq6ZW5rf.js
 const RealDate = Date;
 let now = null;
 var MockDate = class MockDate extends RealDate {
@@ -12284,7 +12284,7 @@ function resetDate() {
 }
 
 //#endregion
-//#region ../../node_modules/.pnpm/vitest@3.2.4_@types+node@22.16.3_@vitest+ui@3.2.4_jiti@2.4.2_jsdom@26.1.0_msw@2.10.3_@t_04250e705606c7b90022e49f9988d66d/node_modules/vitest/dist/chunks/vi.bdSIJ99Y.js
+//#region ../../node_modules/.pnpm/vitest@3.2.4_@types+node@22.16.3_@vitest+ui@3.2.4_jiti@2.4.2_jsdom@26.1.0_lightningcss@_9e855e585de3badded1a4cd0b32436f6/node_modules/vitest/dist/chunks/vi.bdSIJ99Y.js
 const unsupported = [
 	"matchSnapshot",
 	"toMatchSnapshot",

package/dist/{vi.bdSIJ99Y-wDZVsqf8.cjs → vi.bdSIJ99Y-D0m6qImj.cjs}

@@ -10310,7 +10310,7 @@ function createTestHook(name, handler) {
 }
 
 //#endregion
-//#region ../../node_modules/.pnpm/vitest@3.2.4_@types+node@22.16.3_@vitest+ui@3.2.4_jiti@2.4.2_jsdom@26.1.0_msw@2.10.3_@t_04250e705606c7b90022e49f9988d66d/node_modules/vitest/dist/chunks/utils.XdZDrNZV.js
+//#region ../../node_modules/.pnpm/vitest@3.2.4_@types+node@22.16.3_@vitest+ui@3.2.4_jiti@2.4.2_jsdom@26.1.0_lightningcss@_9e855e585de3badded1a4cd0b32436f6/node_modules/vitest/dist/chunks/utils.XdZDrNZV.js
 const NAME_WORKER_STATE = "__vitest_worker__";
 function getWorkerState() {
 	const workerState = globalThis[NAME_WORKER_STATE];
@@ -10359,7 +10359,7 @@ async function waitForImportsToResolve() {
 }
 
 //#endregion
-//#region ../../node_modules/.pnpm/vitest@3.2.4_@types+node@22.16.3_@vitest+ui@3.2.4_jiti@2.4.2_jsdom@26.1.0_msw@2.10.3_@t_04250e705606c7b90022e49f9988d66d/node_modules/vitest/dist/chunks/_commonjsHelpers.BFTU3MAI.js
+//#region ../../node_modules/.pnpm/vitest@3.2.4_@types+node@22.16.3_@vitest+ui@3.2.4_jiti@2.4.2_jsdom@26.1.0_lightningcss@_9e855e585de3badded1a4cd0b32436f6/node_modules/vitest/dist/chunks/_commonjsHelpers.BFTU3MAI.js
 var commonjsGlobal = typeof globalThis !== "undefined" ? globalThis : typeof window !== "undefined" ? window : typeof global !== "undefined" ? global : typeof self !== "undefined" ? self : {};
 function getDefaultExportFromCjs(x) {
 	return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, "default") ? x["default"] : x;
@@ -12210,7 +12210,7 @@ var SnapshotClient = class {
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/vitest@3.2.4_@types+node@22.16.3_@vitest+ui@3.2.4_jiti@2.4.2_jsdom@26.1.0_msw@2.10.3_@t_04250e705606c7b90022e49f9988d66d/node_modules/vitest/dist/chunks/date.Bq6ZW5rf.js
+//#region ../../node_modules/.pnpm/vitest@3.2.4_@types+node@22.16.3_@vitest+ui@3.2.4_jiti@2.4.2_jsdom@26.1.0_lightningcss@_9e855e585de3badded1a4cd0b32436f6/node_modules/vitest/dist/chunks/date.Bq6ZW5rf.js
 const RealDate = Date;
 let now = null;
 var MockDate = class MockDate extends RealDate {
@@ -12259,7 +12259,7 @@ function resetDate() {
 }
 
 //#endregion
-//#region ../../node_modules/.pnpm/vitest@3.2.4_@types+node@22.16.3_@vitest+ui@3.2.4_jiti@2.4.2_jsdom@26.1.0_msw@2.10.3_@t_04250e705606c7b90022e49f9988d66d/node_modules/vitest/dist/chunks/vi.bdSIJ99Y.js
+//#region ../../node_modules/.pnpm/vitest@3.2.4_@types+node@22.16.3_@vitest+ui@3.2.4_jiti@2.4.2_jsdom@26.1.0_lightningcss@_9e855e585de3badded1a4cd0b32436f6/node_modules/vitest/dist/chunks/vi.bdSIJ99Y.js
 const unsupported = [
 	"matchSnapshot",
 	"toMatchSnapshot",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekmidas/storage",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "private": false,
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -9,14 +9,14 @@
   "type": "module",
   "exports": {
     "./aws": {
+      "types": "./dist/aws.d.ts",
       "import": "./dist/aws.mjs",
-      "require": "./dist/aws.cjs",
-      "types": "./src/aws.ts"
+      "require": "./dist/aws.cjs"
     },
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
-      "require": "./dist/index.cjs",
-      "types": "./src/index.ts"
+      "require": "./dist/index.cjs"
     }
   },
   "dependencies": {

package/src/__tests__/StorageClient.spec.ts

@@ -69,7 +69,10 @@ describe('StorageClient', () => {
 
       expect(response.url).toBe('https://example.com/upload');
       expect(response.fields).toHaveLength(2);
-      expect(response.fields[0]).toEqual({ key: 'key', value: 'test/path.txt' });
+      expect(response.fields[0]).toEqual({
+        key: 'key',
+        value: 'test/path.txt',
+      });
       expect(response.fields[1]).toEqual({ key: 'acl', value: 'public-read' });
     });
 
@@ -83,4 +86,4 @@ describe('StorageClient', () => {
       expect(field.value).toBe('test-value');
     });
   });
-});
+});

package/src/aws.ts

@@ -1,2 +1,11 @@
-export { AmazonStorageClient, AmazonCannedAccessControlList } from './AmazonStorageClient';
-export type { StorageClient, DocumentVersion, File, GetUploadParams, GetUploadResponse } from './StorageClient';
+export {
+  AmazonStorageClient,
+  AmazonCannedAccessControlList,
+} from './AmazonStorageClient';
+export type {
+  StorageClient,
+  DocumentVersion,
+  File,
+  GetUploadParams,
+  GetUploadResponse,
+} from './StorageClient';