@managemint-solutions/sdk 0.2.0 → 0.4.0

package/README.md

@@ -12,7 +12,8 @@ npm install @managemint-solutions/sdk @supabase/supabase-js
 `@supabase/supabase-js` (^2.103.0), `class-validator` (^0.15) and `class-transformer` (^0.5)
 are peer dependencies — the request DTOs (`AddStatusDto`, `UpdateStatusDto`, `StatusIdDto`,
 `GetStatusesDto`, `AddAdditionalDetailsDto`, `UpdateAdditionalDetailsDto`,
-`AdditionalDetailsIdDto`, `GetAdditionalDetailsDto`) ship with their class-validator
+`AdditionalDetailsIdDto`, `GetAdditionalDetailsDto`, `AddNoteDto`, `NoteIdDto`,
+`GetNotesDto`, `SupportingFileIdDto`, `GetSupportingFilesDto`) ship with their class-validator
 decorators so consumers validate against
 the same rules the SDK's input types describe. `@nestjs/common` (^11) is an optional peer
 dependency, needed only for the `@managemint-solutions/sdk/nest` subpath.
@@ -64,6 +65,37 @@ await supabase.additionalDetails.remove(detail.mms_id);
 The `value` column is `text`; the SDK serializes on write and casts back on read according to the
 row's `type` (`number` → `Number`, `boolean`, `date` → `Date`, `url` → `URL`).
 
+```ts
+import { NotesEntityTypes } from '@managemint-solutions/entities/notes/enum';
+
+// Notes hang off another entity too, so reads and writes take (entity, entityId).
+const notes = await supabase.notes.list(NotesEntityTypes.PROJECT, projectId);
+const note = await supabase.notes.create(NotesEntityTypes.PROJECT, projectId, {
+  content: 'Called the client to confirm the site visit.',
+});
+await supabase.notes.getById(note.mms_id);
+await supabase.notes.togglePin(note.mms_id); // flips `pinned` and returns the refreshed note
+await supabase.notes.remove(note.mms_id);
+```
+
+Each note carries its author as an embedded `user` (from the `user_profiles` view), and `list`
+returns newest first.
+
+```ts
+import { SupportingFilesEntityTypes } from '@managemint-solutions/entities/supporting-files/enum';
+
+// Supporting files hang off another entity, and cover Supabase Storage as well as the table.
+const files = await supabase.supportingFiles.list(SupportingFilesEntityTypes.PROJECT, projectId);
+await supabase.supportingFiles.upload(SupportingFilesEntityTypes.PROJECT, projectId, {
+  files: uploaded, // web `File`s — uploaded to the `supporting-files` bucket, then rowed up
+});
+const { url, ttl } = await supabase.supportingFiles.getPresignedUrl(files[0].mms_id); // 5 min
+await supabase.supportingFiles.remove(files[0].mms_id); // deletes the row and the object
+```
+
+Uploads run in batches of 5 and upsert, so re-uploading a file refreshes the object without
+adding a second row; `upload` returns the entity's full file list.
+
 The client decodes `{ mms_id, organization_id }` from the JWT itself and scopes every query
 by `organization_id`. `supabase.supabase` is the raw typed `@supabase/supabase-js` client
 (`TypedSupabaseClient`) — the escape hatch for queries not yet covered by a resource.
@@ -73,7 +105,8 @@ by `organization_id`. `supabase.supabase` is the raw typed `@supabase/supabase-j
 Every error the SDK throws is a `SupabaseClientError` carrying the HTTP `status` to respond
 with and the client-facing body, `toResponse()` → `{ error, message }`. Postgrest/Postgres
 errors are translated by `mapPostgrestError` (Postgrest code → status, RLS permission and
-module denials → readable messages); JWT problems are `401 Authentication Error`. Consumers
+module denials → readable messages), Storage errors by `mapStorageError` (the storage error's
+own HTTP status, or 500 when it has none); JWT problems are `401 Authentication Error`. Consumers
 return these as-is instead of mapping database errors themselves.
 
 ## NestJS

package/dist/client.d.ts

@@ -2,7 +2,9 @@ import { type SupabaseClient as SupabaseJsClient } from '@supabase/supabase-js';
 import type { Database } from './database.types';
 import { type AuthContext } from './auth';
 import { AdditionalDetailsResource } from './additional-details';
+import { NotesResource } from './notes';
 import { StatusesResource } from './statuses';
+import { SupportingFilesResource } from './supporting-files';
 export type TypedSupabaseClient = SupabaseJsClient<Database>;
 export type SupabaseClientConfig = {
     url: string;
@@ -14,6 +16,8 @@ export declare class SupabaseClient {
     readonly auth: AuthContext;
     readonly statuses: StatusesResource;
     readonly additionalDetails: AdditionalDetailsResource;
+    readonly notes: NotesResource;
+    readonly supportingFiles: SupportingFilesResource;
     constructor(config: SupabaseClientConfig);
 }
 export declare const createSupabaseClient: (config: SupabaseClientConfig) => SupabaseClient;

package/dist/client.js

@@ -4,12 +4,16 @@ exports.createSupabaseClient = exports.SupabaseClient = void 0;
 const supabase_js_1 = require("@supabase/supabase-js");
 const auth_1 = require("./auth");
 const additional_details_1 = require("./additional-details");
+const notes_1 = require("./notes");
 const statuses_1 = require("./statuses");
+const supporting_files_1 = require("./supporting-files");
 class SupabaseClient {
     supabase; // escape hatch for not-yet-migrated queries
     auth;
     statuses;
     additionalDetails;
+    notes;
+    supportingFiles;
     constructor(config) {
         this.auth = (0, auth_1.decodeAuthContext)(config.accessToken);
         this.supabase = (0, supabase_js_1.createClient)(config.url, config.key, {
@@ -18,6 +22,8 @@ class SupabaseClient {
         });
         this.statuses = new statuses_1.StatusesResource(this.supabase, this.auth);
         this.additionalDetails = new additional_details_1.AdditionalDetailsResource(this.supabase, this.auth);
+        this.notes = new notes_1.NotesResource(this.supabase, this.auth);
+        this.supportingFiles = new supporting_files_1.SupportingFilesResource(this.supabase, this.auth);
     }
 }
 exports.SupabaseClient = SupabaseClient;

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;AAAA,uDAA8F;AAE9F,iCAA6D;AAC7D,6DAAiE;AACjE,yCAA8C;AAU9C,MAAa,cAAc;IAChB,QAAQ,CAAsB,CAAC,4CAA4C;IAC3E,IAAI,CAAc;IAClB,QAAQ,CAAmB;IAC3B,iBAAiB,CAA4B;IAEtD,YAAY,MAA4B;QACtC,IAAI,CAAC,IAAI,GAAG,IAAA,wBAAiB,EAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,GAAG,IAAA,0BAAY,EAAW,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE;YAC7D,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,CAAC,WAAW,EAAE,EAAE,EAAE;YACtE,IAAI,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE;SACzD,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,IAAI,2BAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,CAAC,iBAAiB,GAAG,IAAI,8CAAyB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACnF,CAAC;CACF;AAfD,wCAeC;AAEM,MAAM,oBAAoB,GAAG,CAAC,MAA4B,EAAkB,EAAE,CACnF,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;AADhB,QAAA,oBAAoB,wBACJ"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;AAAA,uDAA8F;AAE9F,iCAA6D;AAC7D,6DAAiE;AACjE,mCAAwC;AACxC,yCAA8C;AAC9C,yDAA6D;AAU7D,MAAa,cAAc;IAChB,QAAQ,CAAsB,CAAC,4CAA4C;IAC3E,IAAI,CAAc;IAClB,QAAQ,CAAmB;IAC3B,iBAAiB,CAA4B;IAC7C,KAAK,CAAgB;IACrB,eAAe,CAA0B;IAElD,YAAY,MAA4B;QACtC,IAAI,CAAC,IAAI,GAAG,IAAA,wBAAiB,EAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,GAAG,IAAA,0BAAY,EAAW,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE;YAC7D,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,CAAC,WAAW,EAAE,EAAE,EAAE;YACtE,IAAI,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE;SACzD,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,IAAI,2BAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,CAAC,iBAAiB,GAAG,IAAI,8CAAyB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACjF,IAAI,CAAC,KAAK,GAAG,IAAI,qBAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,eAAe,GAAG,IAAI,0CAAuB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/E,CAAC;CACF;AAnBD,wCAmBC;AAEM,MAAM,oBAAoB,GAAG,CAAC,MAA4B,EAAkB,EAAE,CACnF,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;AADhB,QAAA,oBAAoB,wBACJ"}

package/dist/errors.d.ts

@@ -1,3 +1,4 @@
+import type { StorageError } from '@supabase/storage-js';
 import type { PostgrestError } from '@supabase/supabase-js';
 export type SupabaseClientErrorInit = {
     /** HTTP status the consumer should respond with. */
@@ -27,3 +28,9 @@ export declare class SupabaseClientError extends Error {
 }
 /** Converts a raw Postgrest error into the SupabaseClientError the SDK throws. */
 export declare const mapPostgrestError: (error: PostgrestError) => SupabaseClientError;
+/**
+ * Converts a Supabase Storage error into the SupabaseClientError the SDK throws. `StorageError`
+ * carries the HTTP `status` only when it came back from the Storage API (`StorageApiError`);
+ * network/unknown failures have none, hence the 500 fallback.
+ */
+export declare const mapStorageError: (error: StorageError, message?: string) => SupabaseClientError;

package/dist/errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapPostgrestError = exports.SupabaseClientError = void 0;
+exports.mapStorageError = exports.mapPostgrestError = exports.SupabaseClientError = void 0;
 /**
  * Every error the SDK throws. It already carries the HTTP status and the body the
  * consumer sends back to the client (`toResponse()`), so the api needs no mapping.
@@ -129,4 +129,15 @@ const mapPostgrestError = (error) => new SupabaseClientError({
     code: error.code,
 }, { cause: error });
 exports.mapPostgrestError = mapPostgrestError;
+/**
+ * Converts a Supabase Storage error into the SupabaseClientError the SDK throws. `StorageError`
+ * carries the HTTP `status` only when it came back from the Storage API (`StorageApiError`);
+ * network/unknown failures have none, hence the 500 fallback.
+ */
+const mapStorageError = (error, message = error.message) => new SupabaseClientError({
+    status: error.status ?? 500,
+    error: 'Storage Error',
+    message,
+}, { cause: error });
+exports.mapStorageError = mapStorageError;
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -3,4 +3,6 @@ export * from './auth';
 export * from './errors';
 export * from './statuses';
 export * from './additional-details';
+export * from './notes';
+export * from './supporting-files';
 export type { Database, Tables, TablesInsert, TablesUpdate, Json } from './database.types';

package/dist/index.js

@@ -19,4 +19,6 @@ __exportStar(require("./auth"), exports);
 __exportStar(require("./errors"), exports);
 __exportStar(require("./statuses"), exports);
 __exportStar(require("./additional-details"), exports);
+__exportStar(require("./notes"), exports);
+__exportStar(require("./supporting-files"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,yCAAuB;AACvB,2CAAyB;AACzB,6CAA2B;AAC3B,uDAAqC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,yCAAuB;AACvB,2CAAyB;AACzB,6CAA2B;AAC3B,uDAAqC;AACrC,0CAAwB;AACxB,qDAAmC"}

package/dist/notes/dto.d.ts

@@ -0,0 +1,15 @@
+import type { AddNoteDto as AddNoteDtoType, GetNotesDto as GetNotesDtoType, NoteIdDto as NoteIdDtoType } from '@managemint-solutions/entities/notes/dto';
+import { NotesEntityTypes } from '@managemint-solutions/entities/notes/enum';
+import type { TablesInsert } from '../database.types';
+type NotesInsertColumns = Required<Pick<TablesInsert<'notes'>, 'content'>>;
+export declare class NoteIdDto implements NoteIdDtoType {
+    readonly noteId: string;
+}
+export declare class GetNotesDto implements GetNotesDtoType {
+    readonly entity: NotesEntityTypes;
+    readonly entityId: string;
+}
+export declare class AddNoteDto implements AddNoteDtoType, NotesInsertColumns {
+    readonly content: string;
+}
+export {};

package/dist/notes/dto.js

@@ -0,0 +1,46 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddNoteDto = exports.GetNotesDto = exports.NoteIdDto = void 0;
+const class_validator_1 = require("class-validator");
+const enum_1 = require("@managemint-solutions/entities/notes/enum");
+class NoteIdDto {
+    noteId;
+}
+exports.NoteIdDto = NoteIdDto;
+__decorate([
+    (0, class_validator_1.IsUUID)('4', { message: 'Invalid note ID format' }),
+    __metadata("design:type", String)
+], NoteIdDto.prototype, "noteId", void 0);
+class GetNotesDto {
+    entity;
+    entityId;
+}
+exports.GetNotesDto = GetNotesDto;
+__decorate([
+    (0, class_validator_1.IsEnum)(enum_1.NotesEntityTypes, { message: 'Invalid entity type' }),
+    __metadata("design:type", String)
+], GetNotesDto.prototype, "entity", void 0);
+__decorate([
+    (0, class_validator_1.IsUUID)('4', { message: 'Invalid entity ID format' }),
+    __metadata("design:type", String)
+], GetNotesDto.prototype, "entityId", void 0);
+class AddNoteDto {
+    content;
+}
+exports.AddNoteDto = AddNoteDto;
+__decorate([
+    (0, class_validator_1.IsString)({ message: 'Invalid content' }),
+    (0, class_validator_1.MinLength)(1, { message: 'Content cannot be empty' }),
+    (0, class_validator_1.MaxLength)(255, { message: 'Content cannot exceed 255 characters' }),
+    __metadata("design:type", String)
+], AddNoteDto.prototype, "content", void 0);
+//# sourceMappingURL=dto.js.map

package/dist/notes/dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dto.js","sourceRoot":"","sources":["../../src/notes/dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAiF;AAMjF,oEAA6E;AAQ7E,MAAa,SAAS;IAEX,MAAM,CAAU;CAC1B;AAHD,8BAGC;AADU;IADR,IAAA,wBAAM,EAAC,GAAG,EAAE,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC;;yCAC1B;AAG3B,MAAa,WAAW;IAEb,MAAM,CAAoB;IAG1B,QAAQ,CAAU;CAC5B;AAND,kCAMC;AAJU;IADR,IAAA,wBAAM,EAAC,uBAAgB,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC;;2CAC1B;AAG1B;IADR,IAAA,wBAAM,EAAC,GAAG,EAAE,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC;;6CAC1B;AAG7B,MAAa,UAAU;IAIZ,OAAO,CAAU;CAC3B;AALD,gCAKC;AADU;IAHR,IAAA,0BAAQ,EAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;IACxC,IAAA,2BAAS,EAAC,CAAC,EAAE,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC;IACpD,IAAA,2BAAS,EAAC,GAAG,EAAE,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;;2CAC1C"}

package/dist/notes/index.d.ts

@@ -0,0 +1,16 @@
+import type { NoteEntity } from '@managemint-solutions/entities/notes';
+import type { AddNoteDto } from '@managemint-solutions/entities/notes/dto';
+import { NotesEntityTypes } from '@managemint-solutions/entities/notes/enum';
+import type { AuthContext } from '../auth';
+import type { TypedSupabaseClient } from '../client';
+export * from './dto';
+export declare class NotesResource {
+    private readonly supabase;
+    private readonly auth;
+    constructor(supabase: TypedSupabaseClient, auth: AuthContext);
+    getById(noteId: string): Promise<NoteEntity>;
+    list(entity: NotesEntityTypes, entityId: string): Promise<NoteEntity[]>;
+    create(entity: NotesEntityTypes, entityId: string, input: AddNoteDto): Promise<NoteEntity>;
+    togglePin(noteId: string): Promise<NoteEntity>;
+    remove(noteId: string): Promise<void>;
+}

package/dist/notes/index.js

@@ -0,0 +1,98 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotesResource = void 0;
+const errors_1 = require("../errors");
+__exportStar(require("./dto"), exports);
+// The query is typed by the generated Database schema (so the select string and the insert/update
+// payloads are checked); the public contract is the shared NoteEntity from
+// @managemint-solutions/entities. The two shapes legitimately differ, hence `as unknown as`: the
+// embedded user_profiles row is an all-nullable view row where the entity declares UserIdentity,
+// and created_at is an ISO string where the entity declares Date.
+const NOTE_SELECT = 'mms_id, created_at, content, pinned, user:user_profiles!user_id(*)';
+class NotesResource {
+    supabase;
+    auth;
+    constructor(supabase, auth) {
+        this.supabase = supabase;
+        this.auth = auth;
+    }
+    async getById(noteId) {
+        const { data, error } = await this.supabase
+            .from('notes')
+            .select(NOTE_SELECT)
+            .eq('organization_id', this.auth.organization_id)
+            .eq('mms_id', noteId)
+            .single();
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        return data;
+    }
+    async list(entity, entityId) {
+        const { data, error } = await this.supabase
+            .from('notes')
+            .select(NOTE_SELECT)
+            .eq('organization_id', this.auth.organization_id)
+            .eq('entity_type', entity)
+            .eq('entity_id', entityId)
+            .order('created_at', { ascending: false });
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        return data;
+    }
+    async create(entity, entityId, input) {
+        const { data, error } = await this.supabase
+            .from('notes')
+            .insert({
+            content: input.content,
+            entity_type: entity,
+            entity_id: entityId,
+            organization_id: this.auth.organization_id,
+            user_id: this.auth.mms_id,
+        })
+            .select(NOTE_SELECT)
+            .single();
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        return data;
+    }
+    async togglePin(noteId) {
+        const existing = await this.getById(noteId);
+        const { error } = await this.supabase
+            .from('notes')
+            .update({
+            pinned: !existing.pinned,
+            updated_at: new Date().toISOString(),
+            last_updated_by: this.auth.mms_id,
+        })
+            .eq('mms_id', noteId)
+            .eq('organization_id', this.auth.organization_id);
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        return this.getById(noteId);
+    }
+    async remove(noteId) {
+        const { error } = await this.supabase
+            .from('notes')
+            .delete()
+            .eq('mms_id', noteId)
+            .eq('organization_id', this.auth.organization_id);
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+    }
+}
+exports.NotesResource = NotesResource;
+//# sourceMappingURL=index.js.map

package/dist/notes/index.js.map

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

package/dist/supporting-files/dto.d.ts

@@ -0,0 +1,9 @@
+import type { GetSupportingFilesDto as GetSupportingFilesDtoType, SupportingFileIdDto as SupportingFileIdDtoType } from '@managemint-solutions/entities/supporting-files/dto';
+import { SupportingFilesEntityTypes } from '@managemint-solutions/entities/supporting-files/enum';
+export declare class SupportingFileIdDto implements SupportingFileIdDtoType {
+    readonly supportingFileId: string;
+}
+export declare class GetSupportingFilesDto implements GetSupportingFilesDtoType {
+    readonly entity: SupportingFilesEntityTypes;
+    readonly entityId: string;
+}

package/dist/supporting-files/dto.js

@@ -0,0 +1,39 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetSupportingFilesDto = exports.SupportingFileIdDto = void 0;
+const class_validator_1 = require("class-validator");
+const enum_1 = require("@managemint-solutions/entities/supporting-files/enum");
+// class-validator versions of the shared DTO types from @managemint-solutions/entities.
+// Each class `implements` its entities type so the wire contract cannot drift. There is no class
+// for the upload payload — it arrives as multipart and is not validated by class-validator.
+class SupportingFileIdDto {
+    supportingFileId;
+}
+exports.SupportingFileIdDto = SupportingFileIdDto;
+__decorate([
+    (0, class_validator_1.IsUUID)('4', { message: 'Invalid supporting file ID format' }),
+    __metadata("design:type", String)
+], SupportingFileIdDto.prototype, "supportingFileId", void 0);
+class GetSupportingFilesDto {
+    entity;
+    entityId;
+}
+exports.GetSupportingFilesDto = GetSupportingFilesDto;
+__decorate([
+    (0, class_validator_1.IsEnum)(enum_1.SupportingFilesEntityTypes, { message: 'Invalid entity type' }),
+    __metadata("design:type", String)
+], GetSupportingFilesDto.prototype, "entity", void 0);
+__decorate([
+    (0, class_validator_1.IsUUID)('4', { message: 'Invalid entity ID format' }),
+    __metadata("design:type", String)
+], GetSupportingFilesDto.prototype, "entityId", void 0);
+//# sourceMappingURL=dto.js.map

package/dist/supporting-files/dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dto.js","sourceRoot":"","sources":["../../src/supporting-files/dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAiD;AAKjD,+EAAkG;AAElG,wFAAwF;AACxF,iGAAiG;AACjG,4FAA4F;AAE5F,MAAa,mBAAmB;IAErB,gBAAgB,CAAU;CACpC;AAHD,kDAGC;AADU;IADR,IAAA,wBAAM,EAAC,GAAG,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;;6DAC3B;AAGrC,MAAa,qBAAqB;IAEvB,MAAM,CAA8B;IAGpC,QAAQ,CAAU;CAC5B;AAND,sDAMC;AAJU;IADR,IAAA,wBAAM,EAAC,iCAA0B,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC;;qDAC1B;AAGpC;IADR,IAAA,wBAAM,EAAC,GAAG,EAAE,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC;;uDAC1B"}

package/dist/supporting-files/index.d.ts

@@ -0,0 +1,16 @@
+import type { SupportingFileEntity, SupportingFilePresignedUrl } from '@managemint-solutions/entities/supporting-files';
+import type { UploadSupportingFilesDto } from '@managemint-solutions/entities/supporting-files/dto';
+import { SupportingFilesEntityTypes } from '@managemint-solutions/entities/supporting-files/enum';
+import type { AuthContext } from '../auth';
+import type { TypedSupabaseClient } from '../client';
+export * from './dto';
+export * from './paths';
+export declare class SupportingFilesResource {
+    private readonly supabase;
+    private readonly auth;
+    constructor(supabase: TypedSupabaseClient, auth: AuthContext);
+    getPresignedUrl(supportingFileId: string): Promise<SupportingFilePresignedUrl>;
+    list(entity: SupportingFilesEntityTypes, entityId: string): Promise<SupportingFileEntity[]>;
+    upload(entity: SupportingFilesEntityTypes, entityId: string, input: UploadSupportingFilesDto): Promise<SupportingFileEntity[]>;
+    remove(supportingFileId: string): Promise<void>;
+}

package/dist/supporting-files/index.js

@@ -0,0 +1,130 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SupportingFilesResource = void 0;
+const errors_1 = require("../errors");
+const paths_1 = require("./paths");
+__exportStar(require("./dto"), exports);
+__exportStar(require("./paths"), exports);
+/** Storage bucket every supporting file lives in. */
+const BUCKET = 'supporting-files';
+/** How long a presigned download URL stays valid. */
+const SIGNED_URL_TTL_SECONDS = 300;
+/** Uploads run concurrently in batches of this size. */
+const UPLOAD_BATCH_SIZE = 5;
+// The queries are typed by the generated Database schema; the public contract is the shared
+// SupportingFileEntity from @managemint-solutions/entities. The row's `extension` is `text` where
+// the entity declares SupportingFilesExtensions, hence the cast at the return.
+class SupportingFilesResource {
+    supabase;
+    auth;
+    constructor(supabase, auth) {
+        this.supabase = supabase;
+        this.auth = auth;
+    }
+    async getPresignedUrl(supportingFileId) {
+        const { data, error } = await this.supabase
+            .from('supporting_files')
+            .select('name, extension, entity_type, entity_id')
+            .eq('mms_id', supportingFileId)
+            .eq('organization_id', this.auth.organization_id)
+            .single();
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        const { data: signed, error: signedError } = await this.supabase.storage
+            .from(BUCKET)
+            .createSignedUrl((0, paths_1.storagePath)(data.entity_type, data.entity_id, data.name, data.extension), SIGNED_URL_TTL_SECONDS);
+        if (signedError)
+            throw (0, errors_1.mapStorageError)(signedError);
+        return { url: signed.signedUrl, ttl: SIGNED_URL_TTL_SECONDS };
+    }
+    async list(entity, entityId) {
+        const { data, error } = await this.supabase
+            .from('supporting_files')
+            .select('mms_id, name, extension')
+            .eq('entity_type', entity)
+            .eq('entity_id', entityId)
+            .eq('organization_id', this.auth.organization_id)
+            .order('created_at', { ascending: false });
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        return data;
+    }
+    async upload(entity, entityId, input) {
+        const { data: existing, error: existingError } = await this.supabase
+            .from('supporting_files')
+            .select('name, extension')
+            .eq('entity_type', entity)
+            .eq('entity_id', entityId)
+            .eq('organization_id', this.auth.organization_id);
+        if (existingError)
+            throw (0, errors_1.mapPostgrestError)(existingError);
+        const existingFileNames = existing.map((file) => `${file.name}.${file.extension}`);
+        // Every file is written to the bucket, duplicates included — an upsert refreshes the object.
+        for (let index = 0; index < input.files.length; index += UPLOAD_BATCH_SIZE) {
+            await Promise.all(input.files.slice(index, index + UPLOAD_BATCH_SIZE).map(async (file) => {
+                const { error } = await this.supabase.storage
+                    .from(BUCKET)
+                    .upload(`${entity}/${entityId}/${file.name}`, file, {
+                    cacheControl: '3600',
+                    upsert: true,
+                });
+                if (error)
+                    throw (0, errors_1.mapStorageError)(error, `Failed to upload file: ${file.name}`);
+            }));
+        }
+        // Only files without an existing row get one — the rest were refreshed in place above.
+        const newFiles = input.files.filter((file) => !existingFileNames.includes(file.name));
+        if (newFiles.length > 0) {
+            const { error } = await this.supabase.from('supporting_files').insert(newFiles.map((file) => ({
+                ...(0, paths_1.splitFileName)(file.name),
+                entity_type: entity,
+                entity_id: entityId,
+                organization_id: this.auth.organization_id,
+                created_at: new Date().toISOString(),
+                created_by: this.auth.mms_id,
+            })));
+            if (error)
+                throw (0, errors_1.mapPostgrestError)(error);
+        }
+        return this.list(entity, entityId);
+    }
+    async remove(supportingFileId) {
+        const { data, error } = await this.supabase
+            .from('supporting_files')
+            .select('entity_type, entity_id, name, extension')
+            .eq('mms_id', supportingFileId)
+            .eq('organization_id', this.auth.organization_id)
+            .single();
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        const { error: deleteError } = await this.supabase
+            .from('supporting_files')
+            .delete()
+            .eq('mms_id', supportingFileId)
+            .eq('organization_id', this.auth.organization_id);
+        if (deleteError)
+            throw (0, errors_1.mapPostgrestError)(deleteError);
+        const { error: storageError } = await this.supabase.storage
+            .from(BUCKET)
+            .remove([(0, paths_1.storagePath)(data.entity_type, data.entity_id, data.name, data.extension)]);
+        if (storageError) {
+            throw (0, errors_1.mapStorageError)(storageError, `Failed to delete file: ${data.name}.${data.extension}`);
+        }
+    }
+}
+exports.SupportingFilesResource = SupportingFilesResource;
+//# sourceMappingURL=index.js.map

package/dist/supporting-files/index.js.map

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

package/dist/supporting-files/paths.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Splits an uploaded file name into the `name` / `extension` columns.
+ *
+ * This mirrors the api exactly, quirks included: only the segment before the *first* dot becomes
+ * the name, so `report.final.pdf` stores as name `report`, extension `pdf`.
+ */
+export declare const splitFileName: (fileName: string) => {
+    name: string;
+    extension: string;
+};
+/** Where an object lives in the `supporting-files` bucket. */
+export declare const storagePath: (entityType: string, entityId: string, name: string, extension: string) => string;

package/dist/supporting-files/paths.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.storagePath = exports.splitFileName = void 0;
+/**
+ * Splits an uploaded file name into the `name` / `extension` columns.
+ *
+ * This mirrors the api exactly, quirks included: only the segment before the *first* dot becomes
+ * the name, so `report.final.pdf` stores as name `report`, extension `pdf`.
+ */
+const splitFileName = (fileName) => ({
+    name: fileName.split('.')[0],
+    extension: fileName.split('.').pop() ?? '',
+});
+exports.splitFileName = splitFileName;
+/** Where an object lives in the `supporting-files` bucket. */
+const storagePath = (entityType, entityId, name, extension) => `${entityType}/${entityId}/${name}.${extension}`;
+exports.storagePath = storagePath;
+//# sourceMappingURL=paths.js.map

package/dist/supporting-files/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/supporting-files/paths.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACI,MAAM,aAAa,GAAG,CAAC,QAAgB,EAAuC,EAAE,CAAC,CAAC;IACvF,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5B,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE;CAC3C,CAAC,CAAC;AAHU,QAAA,aAAa,iBAGvB;AAEH,8DAA8D;AACvD,MAAM,WAAW,GAAG,CACzB,UAAkB,EAClB,QAAgB,EAChB,IAAY,EACZ,SAAiB,EACT,EAAE,CAAC,GAAG,UAAU,IAAI,QAAQ,IAAI,IAAI,IAAI,SAAS,EAAE,CAAC;AALjD,QAAA,WAAW,eAKsC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@managemint-solutions/sdk",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Typed Supabase data-access SDK for ManageMint Solutions",
   "license": "UNLICENSED",
   "author": "Scott Bebington <scottbebington@gmail.com>",