@managemint-solutions/sdk 0.1.0 → 0.2.0

package/README.md

@@ -11,14 +11,16 @@ 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`) ship with their class-validator decorators so consumers validate against
+`GetStatusesDto`, `AddAdditionalDetailsDto`, `UpdateAdditionalDetailsDto`,
+`AdditionalDetailsIdDto`, `GetAdditionalDetailsDto`) 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.
 
 ## Usage
 
 ```ts
-import { createSupabaseClient, isPostgrestError } from '@managemint-solutions/sdk';
+import { createSupabaseClient } from '@managemint-solutions/sdk';
 import type { StatusEntity } from '@managemint-solutions/entities/status';
 import { StatusEntityTypes } from '@managemint-solutions/entities/status/enum';
 
@@ -39,6 +41,29 @@ await supabase.statuses.update(created.mms_id, { label: 'Doing', colour: '#2ecc7
 await supabase.statuses.remove(created.mms_id);
 ```
 
+```ts
+import { AdditionalDetailsEntityTypes, AdditionalDetailsTypes } from '@managemint-solutions/entities/additional-details/enum';
+
+// Additional details hang off another entity, so reads and writes take (entity, entityId).
+const details = await supabase.additionalDetails.list(AdditionalDetailsEntityTypes.PROJECT, projectId);
+const detail = await supabase.additionalDetails.create(
+  AdditionalDetailsEntityTypes.PROJECT,
+  projectId,
+  { key: 'Reference', value: 'INV-1001', type: AdditionalDetailsTypes.Text, copyable: true },
+);
+await supabase.additionalDetails.getById(detail.mms_id);
+await supabase.additionalDetails.update(detail.mms_id, {
+  key: 'Reference',
+  value: 42,
+  type: AdditionalDetailsTypes.Number,
+  copyable: false,
+});
+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`).
+
 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.

package/dist/additional-details/dto.d.ts

@@ -0,0 +1,27 @@
+import { type ValidationOptions } from 'class-validator';
+import type { AddAdditionalDetailsDto as AddAdditionalDetailsDtoType, AdditionalDetailsIdDto as AdditionalDetailsIdDtoType, GetAdditionalDetailsDto as GetAdditionalDetailsDtoType, UpdateAdditionalDetailsDto as UpdateAdditionalDetailsDtoType } from '@managemint-solutions/entities/additional-details/dto';
+import { AdditionalDetailsEntityTypes, AdditionalDetailsTypes } from '@managemint-solutions/entities/additional-details/enum';
+import type { TablesInsert } from '../database.types';
+/** Validates `value` against the sibling `type` property (the discriminator). */
+export declare function IsAdditionalDetailsValueByType(typeProperty: string, validationOptions?: ValidationOptions): (object: object, propertyName: string) => void;
+type AdditionalDetailsInsertColumns = Required<Pick<TablesInsert<'additional_details'>, 'key' | 'copyable'>>;
+export declare class AdditionalDetailsIdDto implements AdditionalDetailsIdDtoType {
+    readonly additionalDetailsId: string;
+}
+export declare class GetAdditionalDetailsDto implements GetAdditionalDetailsDtoType {
+    readonly entity: AdditionalDetailsEntityTypes;
+    readonly entityId: string;
+}
+export declare class AddAdditionalDetailsDto implements AddAdditionalDetailsDtoType, AdditionalDetailsInsertColumns {
+    readonly key: string;
+    readonly value: string | number | boolean | Date | URL;
+    readonly type: AdditionalDetailsTypes;
+    readonly copyable: boolean;
+}
+export declare class UpdateAdditionalDetailsDto implements UpdateAdditionalDetailsDtoType, AdditionalDetailsInsertColumns {
+    readonly key: string;
+    readonly value: string | number | boolean;
+    readonly type: AdditionalDetailsTypes;
+    readonly copyable: boolean;
+}
+export {};

package/dist/additional-details/dto.js

@@ -0,0 +1,142 @@
+"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.UpdateAdditionalDetailsDto = exports.AddAdditionalDetailsDto = exports.GetAdditionalDetailsDto = exports.AdditionalDetailsIdDto = void 0;
+exports.IsAdditionalDetailsValueByType = IsAdditionalDetailsValueByType;
+const class_validator_1 = require("class-validator");
+const enum_1 = require("@managemint-solutions/entities/additional-details/enum");
+/** Validates `value` against the sibling `type` property (the discriminator). */
+function IsAdditionalDetailsValueByType(typeProperty, validationOptions) {
+    return function (object, propertyName) {
+        (0, class_validator_1.registerDecorator)({
+            name: 'isAdditionalDetailsValueByType',
+            target: object.constructor,
+            propertyName,
+            constraints: [typeProperty],
+            options: validationOptions,
+            validator: {
+                validate(value, args) {
+                    const [typeKey] = args.constraints;
+                    const selectedType = args.object[typeKey];
+                    // Let enum validation on `type` report invalid type values.
+                    if (!selectedType || !Object.values(enum_1.AdditionalDetailsTypes).includes(selectedType)) {
+                        return true;
+                    }
+                    if (value === null || value === undefined) {
+                        return false;
+                    }
+                    switch (selectedType) {
+                        case enum_1.AdditionalDetailsTypes.Text:
+                            return typeof value === 'string' && value.trim().length > 0;
+                        case enum_1.AdditionalDetailsTypes.Number:
+                            return typeof value === 'number' && Number.isFinite(value);
+                        case enum_1.AdditionalDetailsTypes.Boolean:
+                            return typeof value === 'boolean';
+                        case enum_1.AdditionalDetailsTypes.DATE:
+                            return typeof value === 'string' && !Number.isNaN(Date.parse(value));
+                        case enum_1.AdditionalDetailsTypes.URL:
+                            if (typeof value !== 'string') {
+                                return false;
+                            }
+                            try {
+                                const parsedUrl = new URL(value);
+                                return parsedUrl.protocol === 'http:' || parsedUrl.protocol === 'https:';
+                            }
+                            catch {
+                                return false;
+                            }
+                        default:
+                            return true;
+                    }
+                },
+                defaultMessage(args) {
+                    const [typeKey] = args.constraints;
+                    const selectedType = args.object[typeKey];
+                    return `Value does not match provided type: ${String(selectedType)}`;
+                },
+            },
+        });
+    };
+}
+class AdditionalDetailsIdDto {
+    additionalDetailsId;
+}
+exports.AdditionalDetailsIdDto = AdditionalDetailsIdDto;
+__decorate([
+    (0, class_validator_1.IsUUID)('4', { message: 'Invalid additional details ID format' }),
+    __metadata("design:type", String)
+], AdditionalDetailsIdDto.prototype, "additionalDetailsId", void 0);
+class GetAdditionalDetailsDto {
+    entity;
+    entityId;
+}
+exports.GetAdditionalDetailsDto = GetAdditionalDetailsDto;
+__decorate([
+    (0, class_validator_1.IsEnum)(enum_1.AdditionalDetailsEntityTypes, { message: 'Invalid entity type' }),
+    __metadata("design:type", String)
+], GetAdditionalDetailsDto.prototype, "entity", void 0);
+__decorate([
+    (0, class_validator_1.IsUUID)('4', { message: 'Invalid entity ID format' }),
+    __metadata("design:type", String)
+], GetAdditionalDetailsDto.prototype, "entityId", void 0);
+class AddAdditionalDetailsDto {
+    key;
+    value;
+    type;
+    copyable;
+}
+exports.AddAdditionalDetailsDto = AddAdditionalDetailsDto;
+__decorate([
+    (0, class_validator_1.IsString)({ message: 'Invalid key' }),
+    (0, class_validator_1.MinLength)(1, { message: 'Key cannot be empty' }),
+    (0, class_validator_1.MaxLength)(100, { message: 'Key cannot exceed 100 characters' }),
+    __metadata("design:type", String)
+], AddAdditionalDetailsDto.prototype, "key", void 0);
+__decorate([
+    (0, class_validator_1.IsDefined)({ message: 'Value is required' }),
+    IsAdditionalDetailsValueByType('type', { message: 'Value does not match the provided type' }),
+    __metadata("design:type", Object)
+], AddAdditionalDetailsDto.prototype, "value", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(enum_1.AdditionalDetailsTypes, { message: 'Invalid additional details type' }),
+    __metadata("design:type", String)
+], AddAdditionalDetailsDto.prototype, "type", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)({ message: 'Invalid copyable value' }),
+    __metadata("design:type", Boolean)
+], AddAdditionalDetailsDto.prototype, "copyable", void 0);
+class UpdateAdditionalDetailsDto {
+    key;
+    value;
+    type;
+    copyable;
+}
+exports.UpdateAdditionalDetailsDto = UpdateAdditionalDetailsDto;
+__decorate([
+    (0, class_validator_1.IsString)({ message: 'Invalid key' }),
+    (0, class_validator_1.MinLength)(1, { message: 'Key cannot be empty' }),
+    (0, class_validator_1.MaxLength)(100, { message: 'Key cannot exceed 100 characters' }),
+    __metadata("design:type", String)
+], UpdateAdditionalDetailsDto.prototype, "key", void 0);
+__decorate([
+    (0, class_validator_1.IsDefined)({ message: 'Value is required' }),
+    IsAdditionalDetailsValueByType('type', { message: 'Value does not match the provided type' }),
+    __metadata("design:type", Object)
+], UpdateAdditionalDetailsDto.prototype, "value", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(enum_1.AdditionalDetailsTypes, { message: 'Invalid additional details type' }),
+    __metadata("design:type", String)
+], UpdateAdditionalDetailsDto.prototype, "type", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)({ message: 'Invalid copyable value' }),
+    __metadata("design:type", Boolean)
+], UpdateAdditionalDetailsDto.prototype, "copyable", void 0);
+//# sourceMappingURL=dto.js.map

package/dist/additional-details/dto.js.map

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

package/dist/additional-details/index.d.ts

@@ -0,0 +1,17 @@
+import type { AdditionalDetailSummary, AdditionalDetailsEntity } from '@managemint-solutions/entities/additional-details';
+import type { AddAdditionalDetailsDto, UpdateAdditionalDetailsDto } from '@managemint-solutions/entities/additional-details/dto';
+import { AdditionalDetailsEntityTypes } from '@managemint-solutions/entities/additional-details/enum';
+import type { AuthContext } from '../auth';
+import type { TypedSupabaseClient } from '../client';
+export * from './dto';
+export * from './values';
+export declare class AdditionalDetailsResource {
+    private readonly supabase;
+    private readonly auth;
+    constructor(supabase: TypedSupabaseClient, auth: AuthContext);
+    getById(additionalDetailsId: string): Promise<AdditionalDetailsEntity>;
+    list(entity: AdditionalDetailsEntityTypes, entityId: string): Promise<AdditionalDetailSummary[]>;
+    create(entity: AdditionalDetailsEntityTypes, entityId: string, input: AddAdditionalDetailsDto): Promise<AdditionalDetailsEntity>;
+    update(additionalDetailsId: string, input: UpdateAdditionalDetailsDto): Promise<AdditionalDetailsEntity>;
+    remove(additionalDetailsId: string): Promise<void>;
+}

package/dist/additional-details/index.js

@@ -0,0 +1,113 @@
+"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.AdditionalDetailsResource = void 0;
+const errors_1 = require("../errors");
+const values_1 = require("./values");
+__exportStar(require("./dto"), exports);
+__exportStar(require("./values"), 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 entities type.
+// The two shapes legitimately differ, hence `as unknown as`: the embedded user_profiles rows
+// are all-nullable view rows where the entity declares UserIdentity, the timestamps are ISO
+// strings where the entity declares Date, and `value` is the `text` column where the entity
+// declares the parsed string | number | boolean | Date | URL union that castValueByType produces.
+const ADDITIONAL_DETAILS_SELECT = 'mms_id, created_at, created_by:user_profiles!created_by(*), updated_at, last_updated_by:user_profiles!last_updated_by(*), key, value, type, copyable';
+const ADDITIONAL_DETAILS_SUMMARY_SELECT = 'mms_id, key, value, type, copyable';
+const withCastValue = (detail) => ({
+    ...detail,
+    value: (0, values_1.castValueByType)(detail.type, detail.value),
+});
+class AdditionalDetailsResource {
+    supabase;
+    auth;
+    constructor(supabase, auth) {
+        this.supabase = supabase;
+        this.auth = auth;
+    }
+    async getById(additionalDetailsId) {
+        const { data, error } = await this.supabase
+            .from('additional_details')
+            .select(ADDITIONAL_DETAILS_SELECT)
+            .eq('organization_id', this.auth.organization_id)
+            .eq('mms_id', additionalDetailsId)
+            .single();
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        return withCastValue(data);
+    }
+    async list(entity, entityId) {
+        const { data, error } = await this.supabase
+            .from('additional_details')
+            .select(ADDITIONAL_DETAILS_SUMMARY_SELECT)
+            .eq('organization_id', this.auth.organization_id)
+            .eq('entity_type', entity)
+            .eq('entity_id', entityId)
+            .order('key', { ascending: false });
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        return data.map(withCastValue);
+    }
+    async create(entity, entityId, input) {
+        const { data, error } = await this.supabase
+            .from('additional_details')
+            .insert({
+            organization_id: this.auth.organization_id,
+            entity_type: entity,
+            entity_id: entityId,
+            key: input.key,
+            value: (0, values_1.serializeValue)(input.value),
+            type: input.type,
+            copyable: input.copyable,
+            created_by: this.auth.mms_id,
+        })
+            .select(ADDITIONAL_DETAILS_SELECT)
+            .single();
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        return withCastValue(data);
+    }
+    async update(additionalDetailsId, input) {
+        const { data, error } = await this.supabase
+            .from('additional_details')
+            .update({
+            key: input.key,
+            value: (0, values_1.serializeValue)(input.value),
+            type: input.type,
+            copyable: input.copyable,
+            updated_at: new Date().toISOString(),
+            last_updated_by: this.auth.mms_id,
+        })
+            .eq('mms_id', additionalDetailsId)
+            .eq('organization_id', this.auth.organization_id)
+            .select(ADDITIONAL_DETAILS_SELECT)
+            .single();
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        return withCastValue(data);
+    }
+    async remove(additionalDetailsId) {
+        const { error } = await this.supabase
+            .from('additional_details')
+            .delete()
+            .eq('mms_id', additionalDetailsId)
+            .eq('organization_id', this.auth.organization_id);
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+    }
+}
+exports.AdditionalDetailsResource = AdditionalDetailsResource;
+//# sourceMappingURL=index.js.map

package/dist/additional-details/index.js.map

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

package/dist/additional-details/values.d.ts

@@ -0,0 +1,11 @@
+import { AdditionalDetailsTypes } from '@managemint-solutions/entities/additional-details/enum';
+/**
+ * The `value` column is `text`, so every stored value comes back as a string. This casts it
+ * back to the JS shape the row's `type` promises. Non-strings and null/undefined pass through.
+ */
+export declare const castValueByType: (type: AdditionalDetailsTypes, value: unknown) => unknown;
+/**
+ * What gets written to the `text` column. The generated Insert/Update requires `value: string`;
+ * `String()` reproduces the JSON → text coercion PostgREST used to do for number/boolean/string.
+ */
+export declare const serializeValue: (value: string | number | boolean | Date | URL) => string;

package/dist/additional-details/values.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeValue = exports.castValueByType = void 0;
+const enum_1 = require("@managemint-solutions/entities/additional-details/enum");
+/**
+ * The `value` column is `text`, so every stored value comes back as a string. This casts it
+ * back to the JS shape the row's `type` promises. Non-strings and null/undefined pass through.
+ */
+const castValueByType = (type, value) => {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    if (typeof value !== 'string') {
+        return value;
+    }
+    switch (type) {
+        case enum_1.AdditionalDetailsTypes.Number:
+            return Number(value);
+        case enum_1.AdditionalDetailsTypes.Boolean:
+            return value.toLowerCase() === 'true';
+        case enum_1.AdditionalDetailsTypes.DATE:
+            return new Date(value);
+        case enum_1.AdditionalDetailsTypes.URL:
+            return new URL(value);
+        case enum_1.AdditionalDetailsTypes.Text:
+        default:
+            return value;
+    }
+};
+exports.castValueByType = castValueByType;
+/**
+ * What gets written to the `text` column. The generated Insert/Update requires `value: string`;
+ * `String()` reproduces the JSON → text coercion PostgREST used to do for number/boolean/string.
+ */
+const serializeValue = (value) => value instanceof Date ? value.toISOString() : String(value);
+exports.serializeValue = serializeValue;
+//# sourceMappingURL=values.js.map

package/dist/additional-details/values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../../src/additional-details/values.ts"],"names":[],"mappings":";;;AAAA,iFAAgG;AAEhG;;;GAGG;AACI,MAAM,eAAe,GAAG,CAAC,IAA4B,EAAE,KAAc,EAAW,EAAE;IACvF,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,6BAAsB,CAAC,MAAM;YAChC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,KAAK,6BAAsB,CAAC,OAAO;YACjC,OAAO,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;QACxC,KAAK,6BAAsB,CAAC,IAAI;YAC9B,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,KAAK,6BAAsB,CAAC,GAAG;YAC7B,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QACxB,KAAK,6BAAsB,CAAC,IAAI,CAAC;QACjC;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC,CAAC;AAtBW,QAAA,eAAe,mBAsB1B;AAEF;;;GAGG;AACI,MAAM,cAAc,GAAG,CAAC,KAA6C,EAAU,EAAE,CACtF,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AADjD,QAAA,cAAc,kBACmC"}

package/dist/client.d.ts

@@ -1,6 +1,7 @@
 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 { StatusesResource } from './statuses';
 export type TypedSupabaseClient = SupabaseJsClient<Database>;
 export type SupabaseClientConfig = {
@@ -12,6 +13,7 @@ export declare class SupabaseClient {
     readonly supabase: TypedSupabaseClient;
     readonly auth: AuthContext;
     readonly statuses: StatusesResource;
+    readonly additionalDetails: AdditionalDetailsResource;
     constructor(config: SupabaseClientConfig);
 }
 export declare const createSupabaseClient: (config: SupabaseClientConfig) => SupabaseClient;

package/dist/client.js

@@ -3,11 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 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 statuses_1 = require("./statuses");
 class SupabaseClient {
     supabase; // escape hatch for not-yet-migrated queries
     auth;
     statuses;
+    additionalDetails;
     constructor(config) {
         this.auth = (0, auth_1.decodeAuthContext)(config.accessToken);
         this.supabase = (0, supabase_js_1.createClient)(config.url, config.key, {
@@ -15,6 +17,7 @@ class SupabaseClient {
             auth: { persistSession: false, autoRefreshToken: false },
         });
         this.statuses = new statuses_1.StatusesResource(this.supabase, this.auth);
+        this.additionalDetails = new additional_details_1.AdditionalDetailsResource(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,yCAA8C;AAU9C,MAAa,cAAc;IAChB,QAAQ,CAAsB,CAAC,4CAA4C;IAC3E,IAAI,CAAc;IAClB,QAAQ,CAAmB;IAEpC,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;IACjE,CAAC;CACF;AAbD,wCAaC;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,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"}

package/dist/index.d.ts

@@ -2,4 +2,5 @@ export * from './client';
 export * from './auth';
 export * from './errors';
 export * from './statuses';
+export * from './additional-details';
 export type { Database, Tables, TablesInsert, TablesUpdate, Json } from './database.types';

package/dist/index.js

@@ -18,4 +18,5 @@ __exportStar(require("./client"), exports);
 __exportStar(require("./auth"), exports);
 __exportStar(require("./errors"), exports);
 __exportStar(require("./statuses"), exports);
+__exportStar(require("./additional-details"), 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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,yCAAuB;AACvB,2CAAyB;AACzB,6CAA2B;AAC3B,uDAAqC"}

package/package.json

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