@beorchid-llc/thrivo-contracts 0.6.0 → 0.8.0

package/dist/subscriptions.d.ts

@@ -11,14 +11,14 @@ export declare const subscriptionPlanInfoSchema: z.ZodObject<{
     priceLabel: z.ZodString;
     billingPeriodLabel: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    priceLabel: string;
     plan: "monthly" | "annual";
     productId: string;
+    priceLabel: string;
     billingPeriodLabel: string;
 }, {
-    priceLabel: string;
     plan: "monthly" | "annual";
     productId: string;
+    priceLabel: string;
     billingPeriodLabel: string;
 }>;
 export type SubscriptionPlanInfo = z.infer<typeof subscriptionPlanInfoSchema>;
@@ -39,48 +39,48 @@ export declare const subscriptionStateSchema: z.ZodObject<{
         priceLabel: z.ZodString;
         billingPeriodLabel: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        priceLabel: string;
         plan: "monthly" | "annual";
         productId: string;
+        priceLabel: string;
         billingPeriodLabel: string;
     }, {
-        priceLabel: string;
         plan: "monthly" | "annual";
         productId: string;
+        priceLabel: string;
         billingPeriodLabel: string;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     status: "active" | "trialing" | "canceled" | "expired" | "none";
-    priceLabel: string | null;
-    renewsAt: string | null;
-    cancelAtPeriodEnd: boolean;
-    trialDays: number;
     plan: "monthly" | "annual" | null;
     productId: string | null;
+    priceLabel: string | null;
     entitlement: "free" | "premium";
+    renewsAt: string | null;
     accessEndsAt: string | null;
+    cancelAtPeriodEnd: boolean;
     trialUsed: boolean;
+    trialDays: number;
     plans: {
-        priceLabel: string;
         plan: "monthly" | "annual";
         productId: string;
+        priceLabel: string;
         billingPeriodLabel: string;
     }[];
 }, {
     status: "active" | "trialing" | "canceled" | "expired" | "none";
-    priceLabel: string | null;
-    renewsAt: string | null;
-    cancelAtPeriodEnd: boolean;
-    trialDays: number;
     plan: "monthly" | "annual" | null;
     productId: string | null;
+    priceLabel: string | null;
     entitlement: "free" | "premium";
+    renewsAt: string | null;
     accessEndsAt: string | null;
+    cancelAtPeriodEnd: boolean;
     trialUsed: boolean;
+    trialDays: number;
     plans: {
-        priceLabel: string;
         plan: "monthly" | "annual";
         productId: string;
+        priceLabel: string;
         billingPeriodLabel: string;
     }[];
 }>;
@@ -105,86 +105,86 @@ export declare const subscriptionResponseSchema: z.ZodObject<{
                 priceLabel: z.ZodString;
                 billingPeriodLabel: z.ZodString;
             }, "strip", z.ZodTypeAny, {
-                priceLabel: string;
                 plan: "monthly" | "annual";
                 productId: string;
+                priceLabel: string;
                 billingPeriodLabel: string;
             }, {
-                priceLabel: string;
                 plan: "monthly" | "annual";
                 productId: string;
+                priceLabel: string;
                 billingPeriodLabel: string;
             }>, "many">;
         }, "strip", z.ZodTypeAny, {
             status: "active" | "trialing" | "canceled" | "expired" | "none";
-            priceLabel: string | null;
-            renewsAt: string | null;
-            cancelAtPeriodEnd: boolean;
-            trialDays: number;
             plan: "monthly" | "annual" | null;
             productId: string | null;
+            priceLabel: string | null;
             entitlement: "free" | "premium";
+            renewsAt: string | null;
             accessEndsAt: string | null;
+            cancelAtPeriodEnd: boolean;
             trialUsed: boolean;
+            trialDays: number;
             plans: {
-                priceLabel: string;
                 plan: "monthly" | "annual";
                 productId: string;
+                priceLabel: string;
                 billingPeriodLabel: string;
             }[];
         }, {
             status: "active" | "trialing" | "canceled" | "expired" | "none";
-            priceLabel: string | null;
-            renewsAt: string | null;
-            cancelAtPeriodEnd: boolean;
-            trialDays: number;
             plan: "monthly" | "annual" | null;
             productId: string | null;
+            priceLabel: string | null;
             entitlement: "free" | "premium";
+            renewsAt: string | null;
             accessEndsAt: string | null;
+            cancelAtPeriodEnd: boolean;
             trialUsed: boolean;
+            trialDays: number;
             plans: {
-                priceLabel: string;
                 plan: "monthly" | "annual";
                 productId: string;
+                priceLabel: string;
                 billingPeriodLabel: string;
             }[];
         }>;
     }, "strip", z.ZodTypeAny, {
         subscription: {
             status: "active" | "trialing" | "canceled" | "expired" | "none";
-            priceLabel: string | null;
-            renewsAt: string | null;
-            cancelAtPeriodEnd: boolean;
-            trialDays: number;
             plan: "monthly" | "annual" | null;
             productId: string | null;
+            priceLabel: string | null;
             entitlement: "free" | "premium";
+            renewsAt: string | null;
             accessEndsAt: string | null;
+            cancelAtPeriodEnd: boolean;
             trialUsed: boolean;
+            trialDays: number;
             plans: {
-                priceLabel: string;
                 plan: "monthly" | "annual";
                 productId: string;
+                priceLabel: string;
                 billingPeriodLabel: string;
             }[];
         };
     }, {
         subscription: {
             status: "active" | "trialing" | "canceled" | "expired" | "none";
-            priceLabel: string | null;
-            renewsAt: string | null;
-            cancelAtPeriodEnd: boolean;
-            trialDays: number;
             plan: "monthly" | "annual" | null;
             productId: string | null;
+            priceLabel: string | null;
             entitlement: "free" | "premium";
+            renewsAt: string | null;
             accessEndsAt: string | null;
+            cancelAtPeriodEnd: boolean;
             trialUsed: boolean;
+            trialDays: number;
             plans: {
-                priceLabel: string;
                 plan: "monthly" | "annual";
                 productId: string;
+                priceLabel: string;
                 billingPeriodLabel: string;
             }[];
         };
@@ -198,19 +198,19 @@ export declare const subscriptionResponseSchema: z.ZodObject<{
     data: {
         subscription: {
             status: "active" | "trialing" | "canceled" | "expired" | "none";
-            priceLabel: string | null;
-            renewsAt: string | null;
-            cancelAtPeriodEnd: boolean;
-            trialDays: number;
             plan: "monthly" | "annual" | null;
             productId: string | null;
+            priceLabel: string | null;
             entitlement: "free" | "premium";
+            renewsAt: string | null;
             accessEndsAt: string | null;
+            cancelAtPeriodEnd: boolean;
             trialUsed: boolean;
+            trialDays: number;
             plans: {
-                priceLabel: string;
                 plan: "monthly" | "annual";
                 productId: string;
+                priceLabel: string;
                 billingPeriodLabel: string;
             }[];
         };
@@ -222,19 +222,19 @@ export declare const subscriptionResponseSchema: z.ZodObject<{
     data: {
         subscription: {
             status: "active" | "trialing" | "canceled" | "expired" | "none";
-            priceLabel: string | null;
-            renewsAt: string | null;
-            cancelAtPeriodEnd: boolean;
-            trialDays: number;
             plan: "monthly" | "annual" | null;
             productId: string | null;
+            priceLabel: string | null;
             entitlement: "free" | "premium";
+            renewsAt: string | null;
             accessEndsAt: string | null;
+            cancelAtPeriodEnd: boolean;
             trialUsed: boolean;
+            trialDays: number;
             plans: {
-                priceLabel: string;
                 plan: "monthly" | "annual";
                 productId: string;
+                priceLabel: string;
                 billingPeriodLabel: string;
             }[];
         };

package/dist/uploads.d.ts

@@ -0,0 +1,194 @@
+import { z } from "zod";
+/**
+ * Generic presigned-upload contract. Clients ask for a presigned PUT URL, upload
+ * the bytes straight to R2, then confirm. `intent` keeps one flow reusable across
+ * upload kinds — `avatar` ships now; `progress_photo`/`meal_photo` are reserved
+ * for the roadmap features and rejected by the service until wired up.
+ */
+export declare const uploadIntentSchema: z.ZodEnum<["avatar", "progress_photo", "meal_photo"]>;
+export type UploadIntent = z.infer<typeof uploadIntentSchema>;
+export declare const uploadStatusSchema: z.ZodEnum<["pending", "uploaded", "verified", "failed", "expired"]>;
+export type UploadStatus = z.infer<typeof uploadStatusSchema>;
+/** Image formats accepted for image intents (avatar/photos). */
+export declare const imageExtensionSchema: z.ZodEnum<["jpg", "jpeg", "png", "webp", "heic"]>;
+export type ImageExtension = z.infer<typeof imageExtensionSchema>;
+export declare const requestUploadPayloadSchema: z.ZodObject<{
+    intent: z.ZodEnum<["avatar", "progress_photo", "meal_photo"]>;
+    fileExtension: z.ZodEnum<["jpg", "jpeg", "png", "webp", "heic"]>;
+}, "strip", z.ZodTypeAny, {
+    intent: "avatar" | "progress_photo" | "meal_photo";
+    fileExtension: "jpg" | "jpeg" | "png" | "webp" | "heic";
+}, {
+    intent: "avatar" | "progress_photo" | "meal_photo";
+    fileExtension: "jpg" | "jpeg" | "png" | "webp" | "heic";
+}>;
+export type RequestUploadPayload = z.infer<typeof requestUploadPayloadSchema>;
+export declare const requestUploadResultSchema: z.ZodObject<{
+    uploadId: z.ZodString;
+    /** Presigned PUT URL — the client uploads the file bytes here. */
+    uploadUrl: z.ZodString;
+    /** Content-Type the client MUST send on the PUT so the signature matches. */
+    contentType: z.ZodString;
+    key: z.ZodString;
+    /** Public read URL the object will live at once verified. */
+    publicUrl: z.ZodString;
+    /**
+     * Server-owned max upload size in bytes for this intent. The client SHOULD
+     * reject larger files before uploading; the server re-checks on verify, so a
+     * tampered client can't bypass it.
+     */
+    maxBytes: z.ZodNumber;
+    expiresAt: z.ZodDate;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    uploadId: string;
+    uploadUrl: string;
+    contentType: string;
+    publicUrl: string;
+    maxBytes: number;
+    expiresAt: Date;
+}, {
+    key: string;
+    uploadId: string;
+    uploadUrl: string;
+    contentType: string;
+    publicUrl: string;
+    maxBytes: number;
+    expiresAt: Date;
+}>;
+export type RequestUploadResult = z.infer<typeof requestUploadResultSchema>;
+export declare const requestUploadResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        uploadId: z.ZodString;
+        /** Presigned PUT URL — the client uploads the file bytes here. */
+        uploadUrl: z.ZodString;
+        /** Content-Type the client MUST send on the PUT so the signature matches. */
+        contentType: z.ZodString;
+        key: z.ZodString;
+        /** Public read URL the object will live at once verified. */
+        publicUrl: z.ZodString;
+        /**
+         * Server-owned max upload size in bytes for this intent. The client SHOULD
+         * reject larger files before uploading; the server re-checks on verify, so a
+         * tampered client can't bypass it.
+         */
+        maxBytes: z.ZodNumber;
+        expiresAt: z.ZodDate;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        uploadId: string;
+        uploadUrl: string;
+        contentType: string;
+        publicUrl: string;
+        maxBytes: number;
+        expiresAt: Date;
+    }, {
+        key: string;
+        uploadId: string;
+        uploadUrl: string;
+        contentType: string;
+        publicUrl: string;
+        maxBytes: number;
+        expiresAt: Date;
+    }>;
+    responseCode: z.ZodNumber;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    success: true;
+    responseCode: number;
+    data: {
+        key: string;
+        uploadId: string;
+        uploadUrl: string;
+        contentType: string;
+        publicUrl: string;
+        maxBytes: number;
+        expiresAt: Date;
+    };
+}, {
+    message: string;
+    success: true;
+    responseCode: number;
+    data: {
+        key: string;
+        uploadId: string;
+        uploadUrl: string;
+        contentType: string;
+        publicUrl: string;
+        maxBytes: number;
+        expiresAt: Date;
+    };
+}>;
+export declare const verifyUploadResultSchema: z.ZodObject<{
+    uploadId: z.ZodString;
+    status: z.ZodEnum<["pending", "uploaded", "verified", "failed", "expired"]>;
+    publicUrl: z.ZodString;
+    size: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    status: "failed" | "expired" | "pending" | "uploaded" | "verified";
+    uploadId: string;
+    publicUrl: string;
+    size: number | null;
+}, {
+    status: "failed" | "expired" | "pending" | "uploaded" | "verified";
+    uploadId: string;
+    publicUrl: string;
+    size: number | null;
+}>;
+export type VerifyUploadResult = z.infer<typeof verifyUploadResultSchema>;
+export declare const verifyUploadResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        uploadId: z.ZodString;
+        status: z.ZodEnum<["pending", "uploaded", "verified", "failed", "expired"]>;
+        publicUrl: z.ZodString;
+        size: z.ZodNullable<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        status: "failed" | "expired" | "pending" | "uploaded" | "verified";
+        uploadId: string;
+        publicUrl: string;
+        size: number | null;
+    }, {
+        status: "failed" | "expired" | "pending" | "uploaded" | "verified";
+        uploadId: string;
+        publicUrl: string;
+        size: number | null;
+    }>;
+    responseCode: z.ZodNumber;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    success: true;
+    responseCode: number;
+    data: {
+        status: "failed" | "expired" | "pending" | "uploaded" | "verified";
+        uploadId: string;
+        publicUrl: string;
+        size: number | null;
+    };
+}, {
+    message: string;
+    success: true;
+    responseCode: number;
+    data: {
+        status: "failed" | "expired" | "pending" | "uploaded" | "verified";
+        uploadId: string;
+        publicUrl: string;
+        size: number | null;
+    };
+}>;
+export declare const uploadRoutes: {
+    requestUpload: {
+        method: "POST";
+        path: "/api/v1/uploads/presigned-url";
+        auth: "user";
+    };
+    verifyUpload: {
+        method: "POST";
+        path: "/api/v1/uploads/:id/verify";
+        auth: "user";
+    };
+};
+//# sourceMappingURL=uploads.d.ts.map

package/dist/uploads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["../src/uploads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,uDAAqD,CAAC;AACrF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,kBAAkB,qEAAmE,CAAC;AACnG,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,gEAAgE;AAChE,eAAO,MAAM,oBAAoB,mDAAiD,CAAC;AACnF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,0BAA0B;;;;;;;;;EAGrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,yBAAyB;;IAEpC,kEAAkE;;IAElE,6EAA6E;;;IAG7E,6DAA6D;;IAE7D;;;;OAIG;;;;;;;;;;;;;;;;;;;EAGH,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,eAAO,MAAM,2BAA2B;;;;QAhBtC,kEAAkE;;QAElE,6EAA6E;;;QAG7E,6DAA6D;;QAE7D;;;;WAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKiF,CAAC;AAEvF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;EAKnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA6C,CAAC;AAErF,eAAO,MAAM,YAAY;;;;;;;;;;;CAWgB,CAAC"}

package/dist/uploads.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { apiSuccessSchema } from "./common";
+/**
+ * Generic presigned-upload contract. Clients ask for a presigned PUT URL, upload
+ * the bytes straight to R2, then confirm. `intent` keeps one flow reusable across
+ * upload kinds — `avatar` ships now; `progress_photo`/`meal_photo` are reserved
+ * for the roadmap features and rejected by the service until wired up.
+ */
+export const uploadIntentSchema = z.enum(["avatar", "progress_photo", "meal_photo"]);
+export const uploadStatusSchema = z.enum(["pending", "uploaded", "verified", "failed", "expired"]);
+/** Image formats accepted for image intents (avatar/photos). */
+export const imageExtensionSchema = z.enum(["jpg", "jpeg", "png", "webp", "heic"]);
+export const requestUploadPayloadSchema = z.object({
+    intent: uploadIntentSchema,
+    fileExtension: imageExtensionSchema,
+});
+export const requestUploadResultSchema = z.object({
+    uploadId: z.string().uuid(),
+    /** Presigned PUT URL — the client uploads the file bytes here. */
+    uploadUrl: z.string().url(),
+    /** Content-Type the client MUST send on the PUT so the signature matches. */
+    contentType: z.string(),
+    key: z.string(),
+    /** Public read URL the object will live at once verified. */
+    publicUrl: z.string().url(),
+    /**
+     * Server-owned max upload size in bytes for this intent. The client SHOULD
+     * reject larger files before uploading; the server re-checks on verify, so a
+     * tampered client can't bypass it.
+     */
+    maxBytes: z.number().int().positive(),
+    expiresAt: z.coerce.date(),
+});
+export const requestUploadResponseSchema = apiSuccessSchema(requestUploadResultSchema);
+export const verifyUploadResultSchema = z.object({
+    uploadId: z.string().uuid(),
+    status: uploadStatusSchema,
+    publicUrl: z.string().url(),
+    size: z.number().int().nullable(),
+});
+export const verifyUploadResponseSchema = apiSuccessSchema(verifyUploadResultSchema);
+export const uploadRoutes = {
+    requestUpload: {
+        method: "POST",
+        path: "/api/v1/uploads/presigned-url",
+        auth: "user",
+    },
+    verifyUpload: {
+        method: "POST",
+        path: "/api/v1/uploads/:id/verify",
+        auth: "user",
+    },
+};
+//# sourceMappingURL=uploads.js.map

package/dist/uploads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.js","sourceRoot":"","sources":["../src/uploads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAsB,MAAM,UAAU,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,gBAAgB,EAAE,YAAY,CAAC,CAAC,CAAC;AAGrF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;AAGnG,gEAAgE;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAGnF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,MAAM,EAAE,kBAAkB;IAC1B,aAAa,EAAE,oBAAoB;CACpC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,kEAAkE;IAClE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC3B,6EAA6E;IAC7E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,6DAA6D;IAC7D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC3B;;;;OAIG;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,gBAAgB,CAAC,yBAAyB,CAAC,CAAC;AAEvF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,MAAM,EAAE,kBAAkB;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,gBAAgB,CAAC,wBAAwB,CAAC,CAAC;AAErF,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,aAAa,EAAE;QACb,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,+BAA+B;QACrC,IAAI,EAAE,MAAM;KACb;IACD,YAAY,EAAE;QACZ,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,4BAA4B;QAClC,IAAI,EAAE,MAAM;KACb;CACsC,CAAC"}