@deepintel-ltd/buildlink-api-contracts 0.2.25 → 0.2.26

package/contracts/client-progress.d.ts

@@ -0,0 +1,493 @@
+import { z } from 'zod';
+export declare const clientProgressContract: {
+    getClientProgress: {
+        pathParams: z.ZodObject<{
+            projectId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            projectId: string;
+        }, {
+            projectId: string;
+        }>;
+        summary: "Diaspora/client read-only progress deck (rates shaped by clientSeesRates)";
+        method: "GET";
+        path: "/projects/:projectId/client-progress";
+        responses: {
+            200: z.ZodObject<{
+                data: z.ZodObject<{
+                    type: z.ZodLiteral<"client-progress">;
+                    id: z.ZodString;
+                    attributes: z.ZodObject<{
+                        projectId: z.ZodString;
+                        projectName: z.ZodString;
+                        progressPct: z.ZodNumber;
+                        clientSeesRates: z.ZodBoolean;
+                        totals: z.ZodObject<{
+                            certified: z.ZodNumber;
+                            released: z.ZodNumber;
+                            paid: z.ZodNumber;
+                            boqTotal: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                        }, "strip", z.ZodTypeAny, {
+                            certified: number;
+                            released: number;
+                            paid: number;
+                            boqTotal?: number | null | undefined;
+                        }, {
+                            certified: number;
+                            released: number;
+                            paid: number;
+                            boqTotal?: number | null | undefined;
+                        }>;
+                        recentPhotos: z.ZodArray<z.ZodObject<{
+                            url: z.ZodString;
+                            caption: z.ZodOptional<z.ZodString>;
+                            capturedAt: z.ZodOptional<z.ZodString>;
+                            logDate: z.ZodOptional<z.ZodString>;
+                        }, "strip", z.ZodTypeAny, {
+                            url: string;
+                            caption?: string | undefined;
+                            capturedAt?: string | undefined;
+                            logDate?: string | undefined;
+                        }, {
+                            url: string;
+                            caption?: string | undefined;
+                            capturedAt?: string | undefined;
+                            logDate?: string | undefined;
+                        }>, "many">;
+                        valuationTimeline: z.ZodArray<z.ZodObject<{
+                            id: z.ZodString;
+                            certificateNumber: z.ZodString;
+                            status: z.ZodString;
+                            periodEnd: z.ZodString;
+                            grossAmount: z.ZodOptional<z.ZodNumber>;
+                            netPayable: z.ZodOptional<z.ZodNumber>;
+                            certifiedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            releasedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            paidAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        }, "strip", z.ZodTypeAny, {
+                            id: string;
+                            status: string;
+                            certificateNumber: string;
+                            periodEnd: string;
+                            paidAt?: string | null | undefined;
+                            grossAmount?: number | undefined;
+                            netPayable?: number | undefined;
+                            certifiedAt?: string | null | undefined;
+                            releasedAt?: string | null | undefined;
+                        }, {
+                            id: string;
+                            status: string;
+                            certificateNumber: string;
+                            periodEnd: string;
+                            paidAt?: string | null | undefined;
+                            grossAmount?: number | undefined;
+                            netPayable?: number | undefined;
+                            certifiedAt?: string | null | undefined;
+                            releasedAt?: string | null | undefined;
+                        }>, "many">;
+                        proofShareLinks: z.ZodArray<z.ZodObject<{
+                            packId: z.ZodString;
+                            title: z.ZodString;
+                            token: z.ZodOptional<z.ZodString>;
+                            sharePath: z.ZodOptional<z.ZodString>;
+                        }, "strip", z.ZodTypeAny, {
+                            title: string;
+                            packId: string;
+                            token?: string | undefined;
+                            sharePath?: string | undefined;
+                        }, {
+                            title: string;
+                            packId: string;
+                            token?: string | undefined;
+                            sharePath?: string | undefined;
+                        }>, "many">;
+                    }, "strip", z.ZodTypeAny, {
+                        projectId: string;
+                        projectName: string;
+                        progressPct: number;
+                        clientSeesRates: boolean;
+                        totals: {
+                            certified: number;
+                            released: number;
+                            paid: number;
+                            boqTotal?: number | null | undefined;
+                        };
+                        recentPhotos: {
+                            url: string;
+                            caption?: string | undefined;
+                            capturedAt?: string | undefined;
+                            logDate?: string | undefined;
+                        }[];
+                        valuationTimeline: {
+                            id: string;
+                            status: string;
+                            certificateNumber: string;
+                            periodEnd: string;
+                            paidAt?: string | null | undefined;
+                            grossAmount?: number | undefined;
+                            netPayable?: number | undefined;
+                            certifiedAt?: string | null | undefined;
+                            releasedAt?: string | null | undefined;
+                        }[];
+                        proofShareLinks: {
+                            title: string;
+                            packId: string;
+                            token?: string | undefined;
+                            sharePath?: string | undefined;
+                        }[];
+                    }, {
+                        projectId: string;
+                        projectName: string;
+                        progressPct: number;
+                        clientSeesRates: boolean;
+                        totals: {
+                            certified: number;
+                            released: number;
+                            paid: number;
+                            boqTotal?: number | null | undefined;
+                        };
+                        recentPhotos: {
+                            url: string;
+                            caption?: string | undefined;
+                            capturedAt?: string | undefined;
+                            logDate?: string | undefined;
+                        }[];
+                        valuationTimeline: {
+                            id: string;
+                            status: string;
+                            certificateNumber: string;
+                            periodEnd: string;
+                            paidAt?: string | null | undefined;
+                            grossAmount?: number | undefined;
+                            netPayable?: number | undefined;
+                            certifiedAt?: string | null | undefined;
+                            releasedAt?: string | null | undefined;
+                        }[];
+                        proofShareLinks: {
+                            title: string;
+                            packId: string;
+                            token?: string | undefined;
+                            sharePath?: string | undefined;
+                        }[];
+                    }>;
+                }, "strip", z.ZodTypeAny, {
+                    id: string;
+                    type: "client-progress";
+                    attributes: {
+                        projectId: string;
+                        projectName: string;
+                        progressPct: number;
+                        clientSeesRates: boolean;
+                        totals: {
+                            certified: number;
+                            released: number;
+                            paid: number;
+                            boqTotal?: number | null | undefined;
+                        };
+                        recentPhotos: {
+                            url: string;
+                            caption?: string | undefined;
+                            capturedAt?: string | undefined;
+                            logDate?: string | undefined;
+                        }[];
+                        valuationTimeline: {
+                            id: string;
+                            status: string;
+                            certificateNumber: string;
+                            periodEnd: string;
+                            paidAt?: string | null | undefined;
+                            grossAmount?: number | undefined;
+                            netPayable?: number | undefined;
+                            certifiedAt?: string | null | undefined;
+                            releasedAt?: string | null | undefined;
+                        }[];
+                        proofShareLinks: {
+                            title: string;
+                            packId: string;
+                            token?: string | undefined;
+                            sharePath?: string | undefined;
+                        }[];
+                    };
+                }, {
+                    id: string;
+                    type: "client-progress";
+                    attributes: {
+                        projectId: string;
+                        projectName: string;
+                        progressPct: number;
+                        clientSeesRates: boolean;
+                        totals: {
+                            certified: number;
+                            released: number;
+                            paid: number;
+                            boqTotal?: number | null | undefined;
+                        };
+                        recentPhotos: {
+                            url: string;
+                            caption?: string | undefined;
+                            capturedAt?: string | undefined;
+                            logDate?: string | undefined;
+                        }[];
+                        valuationTimeline: {
+                            id: string;
+                            status: string;
+                            certificateNumber: string;
+                            periodEnd: string;
+                            paidAt?: string | null | undefined;
+                            grossAmount?: number | undefined;
+                            netPayable?: number | undefined;
+                            certifiedAt?: string | null | undefined;
+                            releasedAt?: string | null | undefined;
+                        }[];
+                        proofShareLinks: {
+                            title: string;
+                            packId: string;
+                            token?: string | undefined;
+                            sharePath?: string | undefined;
+                        }[];
+                    };
+                }>;
+                meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                links: z.ZodOptional<z.ZodObject<{
+                    self: z.ZodString;
+                    first: z.ZodOptional<z.ZodString>;
+                    last: z.ZodOptional<z.ZodString>;
+                    prev: z.ZodOptional<z.ZodString>;
+                    next: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    self: string;
+                    first?: string | undefined;
+                    last?: string | undefined;
+                    prev?: string | undefined;
+                    next?: string | undefined;
+                }, {
+                    self: string;
+                    first?: string | undefined;
+                    last?: string | undefined;
+                    prev?: string | undefined;
+                    next?: string | undefined;
+                }>>;
+                errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    status: z.ZodString;
+                    title: z.ZodString;
+                    detail: z.ZodOptional<z.ZodString>;
+                    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, "strip", z.ZodTypeAny, {
+                    status: string;
+                    title: string;
+                    detail?: string | undefined;
+                    meta?: Record<string, unknown> | undefined;
+                }, {
+                    status: string;
+                    title: string;
+                    detail?: string | undefined;
+                    meta?: Record<string, unknown> | undefined;
+                }>, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                data: {
+                    id: string;
+                    type: "client-progress";
+                    attributes: {
+                        projectId: string;
+                        projectName: string;
+                        progressPct: number;
+                        clientSeesRates: boolean;
+                        totals: {
+                            certified: number;
+                            released: number;
+                            paid: number;
+                            boqTotal?: number | null | undefined;
+                        };
+                        recentPhotos: {
+                            url: string;
+                            caption?: string | undefined;
+                            capturedAt?: string | undefined;
+                            logDate?: string | undefined;
+                        }[];
+                        valuationTimeline: {
+                            id: string;
+                            status: string;
+                            certificateNumber: string;
+                            periodEnd: string;
+                            paidAt?: string | null | undefined;
+                            grossAmount?: number | undefined;
+                            netPayable?: number | undefined;
+                            certifiedAt?: string | null | undefined;
+                            releasedAt?: string | null | undefined;
+                        }[];
+                        proofShareLinks: {
+                            title: string;
+                            packId: string;
+                            token?: string | undefined;
+                            sharePath?: string | undefined;
+                        }[];
+                    };
+                };
+                meta?: Record<string, unknown> | undefined;
+                links?: {
+                    self: string;
+                    first?: string | undefined;
+                    last?: string | undefined;
+                    prev?: string | undefined;
+                    next?: string | undefined;
+                } | undefined;
+                errors?: {
+                    status: string;
+                    title: string;
+                    detail?: string | undefined;
+                    meta?: Record<string, unknown> | undefined;
+                }[] | undefined;
+            }, {
+                data: {
+                    id: string;
+                    type: "client-progress";
+                    attributes: {
+                        projectId: string;
+                        projectName: string;
+                        progressPct: number;
+                        clientSeesRates: boolean;
+                        totals: {
+                            certified: number;
+                            released: number;
+                            paid: number;
+                            boqTotal?: number | null | undefined;
+                        };
+                        recentPhotos: {
+                            url: string;
+                            caption?: string | undefined;
+                            capturedAt?: string | undefined;
+                            logDate?: string | undefined;
+                        }[];
+                        valuationTimeline: {
+                            id: string;
+                            status: string;
+                            certificateNumber: string;
+                            periodEnd: string;
+                            paidAt?: string | null | undefined;
+                            grossAmount?: number | undefined;
+                            netPayable?: number | undefined;
+                            certifiedAt?: string | null | undefined;
+                            releasedAt?: string | null | undefined;
+                        }[];
+                        proofShareLinks: {
+                            title: string;
+                            packId: string;
+                            token?: string | undefined;
+                            sharePath?: string | undefined;
+                        }[];
+                    };
+                };
+                meta?: Record<string, unknown> | undefined;
+                links?: {
+                    self: string;
+                    first?: string | undefined;
+                    last?: string | undefined;
+                    prev?: string | undefined;
+                    next?: string | undefined;
+                } | undefined;
+                errors?: {
+                    status: string;
+                    title: string;
+                    detail?: string | undefined;
+                    meta?: Record<string, unknown> | undefined;
+                }[] | undefined;
+            }>;
+            401: z.ZodObject<{
+                errors: z.ZodArray<z.ZodObject<{
+                    status: z.ZodString;
+                    title: z.ZodString;
+                    detail: z.ZodOptional<z.ZodString>;
+                    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, "strip", z.ZodTypeAny, {
+                    status: string;
+                    title: string;
+                    detail?: string | undefined;
+                    meta?: Record<string, unknown> | undefined;
+                }, {
+                    status: string;
+                    title: string;
+                    detail?: string | undefined;
+                    meta?: Record<string, unknown> | undefined;
+                }>, "many">;
+            }, "strip", z.ZodTypeAny, {
+                errors: {
+                    status: string;
+                    title: string;
+                    detail?: string | undefined;
+                    meta?: Record<string, unknown> | undefined;
+                }[];
+            }, {
+                errors: {
+                    status: string;
+                    title: string;
+                    detail?: string | undefined;
+                    meta?: Record<string, unknown> | undefined;
+                }[];
+            }>;
+            403: z.ZodObject<{
+                errors: z.ZodArray<z.ZodObject<{
+                    status: z.ZodString;
+                    title: z.ZodString;
+                    detail: z.ZodOptional<z.ZodString>;
+                    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, "strip", z.ZodTypeAny, {
+                    status: string;
+                    title: string;
+                    detail?: string | undefined;
+                    meta?: Record<string, unknown> | undefined;
+                }, {
+                    status: string;
+                    title: string;
+                    detail?: string | undefined;
+                    meta?: Record<string, unknown> | undefined;
+                }>, "many">;
+            }, "strip", z.ZodTypeAny, {
+                errors: {
+                    status: string;
+                    title: string;
+                    detail?: string | undefined;
+                    meta?: Record<string, unknown> | undefined;
+                }[];
+            }, {
+                errors: {
+                    status: string;
+                    title: string;
+                    detail?: string | undefined;
+                    meta?: Record<string, unknown> | undefined;
+                }[];
+            }>;
+            404: z.ZodObject<{
+                errors: z.ZodArray<z.ZodObject<{
+                    status: z.ZodString;
+                    title: z.ZodString;
+                    detail: z.ZodOptional<z.ZodString>;
+                    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, "strip", z.ZodTypeAny, {
+                    status: string;
+                    title: string;
+                    detail?: string | undefined;
+                    meta?: Record<string, unknown> | undefined;
+                }, {
+                    status: string;
+                    title: string;
+                    detail?: string | undefined;
+                    meta?: Record<string, unknown> | undefined;
+                }>, "many">;
+            }, "strip", z.ZodTypeAny, {
+                errors: {
+                    status: string;
+                    title: string;
+                    detail?: string | undefined;
+                    meta?: Record<string, unknown> | undefined;
+                }[];
+            }, {
+                errors: {
+                    status: string;
+                    title: string;
+                    detail?: string | undefined;
+                    meta?: Record<string, unknown> | undefined;
+                }[];
+            }>;
+        };
+    };
+};
+//# sourceMappingURL=client-progress.d.ts.map

package/contracts/client-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-progress.d.ts","sourceRoot":"","sources":["../../../src/contracts/client-progress.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAajC,CAAC"}

package/contracts/client-progress.js

@@ -0,0 +1,20 @@
+import { initContract } from '@ts-rest/core';
+import { z } from 'zod';
+import { ClientProgressResourceSchema } from '../schemas/client-progress';
+import { CuidSchema, JsonApiErrorResponseSchema, JsonApiResponseSchema } from '../schemas/common';
+const c = initContract();
+export const clientProgressContract = c.router({
+    getClientProgress: {
+        method: 'GET',
+        path: '/projects/:projectId/client-progress',
+        pathParams: z.object({ projectId: CuidSchema }),
+        responses: {
+            200: JsonApiResponseSchema(ClientProgressResourceSchema),
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+        },
+        summary: 'Diaspora/client read-only progress deck (rates shaped by clientSeesRates)',
+    },
+});
+//# sourceMappingURL=client-progress.js.map

package/contracts/client-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-progress.js","sourceRoot":"","sources":["../../../src/contracts/client-progress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAElG,MAAM,CAAC,GAAG,YAAY,EAAE,CAAC;AAEzB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,iBAAiB,EAAE;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,sCAAsC;QAC5C,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;QAC/C,SAAS,EAAE;YACT,GAAG,EAAE,qBAAqB,CAAC,4BAA4B,CAAC;YACxD,GAAG,EAAE,0BAA0B;YAC/B,GAAG,EAAE,0BAA0B;YAC/B,GAAG,EAAE,0BAA0B;SAChC;QACD,OAAO,EAAE,2EAA2E;KACrF;CACF,CAAC,CAAC"}