@porulle/core 0.7.0 → 0.8.0

package/dist/interfaces/rest/schemas/admin-staff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-staff.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/rest/schemas/admin-staff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAe,MAAM,mBAAmB,CAAC;AAGnD,eAAO,MAAM,qBAAqB;;;iBAGF,CAAC;AAEjC,eAAO,MAAM,qBAAqB;;;iBAGF,CAAC;AAEjC,eAAO,MAAM,yBAAyB;;iBAEF,CAAC;AAQrC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CASzB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAY3B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAY3B,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CASpC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAS9B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAa/B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAU3B,CAAC"}

package/dist/interfaces/rest/schemas/admin-staff.js

@@ -0,0 +1,98 @@
+import { z, createRoute } from "@hono/zod-openapi";
+import { errorResponses } from "./shared.js";
+export const CreateStaffBodySchema = z.object({
+    userId: z.string().min(1).openapi({ example: "user_abc123", description: "Better Auth user id of an existing user" }),
+    role: z.string().min(1).openapi({ example: "manager" }),
+}).openapi("CreateStaffRequest");
+export const InviteStaffBodySchema = z.object({
+    email: z.email().openapi({ example: "newhire@example.com" }),
+    role: z.string().min(1).openapi({ example: "manager" }),
+}).openapi("InviteStaffRequest");
+export const UpdateStaffRoleBodySchema = z.object({
+    role: z.string().min(1).openapi({ example: "admin" }),
+}).openapi("UpdateStaffRoleRequest");
+const MemberIdParam = z.object({
+    id: z.string().min(1).openapi({ example: "mem_abc123" }),
+});
+const DataResponse = z.object({ data: z.any() }).openapi("AdminStaffResponse");
+export const listStaffRoute = createRoute({
+    method: "get",
+    path: "/staff",
+    tags: ["Admin"],
+    summary: "List staff members with their roles",
+    responses: {
+        200: { content: { "application/json": { schema: DataResponse } }, description: "Staff members" },
+        ...errorResponses,
+    },
+});
+export const createStaffRoute = createRoute({
+    method: "post",
+    path: "/staff",
+    tags: ["Admin"],
+    summary: "Add an existing user as a staff member with a role",
+    request: {
+        body: { content: { "application/json": { schema: CreateStaffBodySchema } }, required: true },
+    },
+    responses: {
+        201: { content: { "application/json": { schema: DataResponse } }, description: "Staff member created." },
+        ...errorResponses,
+    },
+});
+export const inviteStaffRoute = createRoute({
+    method: "post",
+    path: "/staff/invitations",
+    tags: ["Admin"],
+    summary: "Invite a teammate by email with a role",
+    request: {
+        body: { content: { "application/json": { schema: InviteStaffBodySchema } }, required: true },
+    },
+    responses: {
+        201: { content: { "application/json": { schema: DataResponse } }, description: "Invitation created." },
+        ...errorResponses,
+    },
+});
+export const listStaffInvitationsRoute = createRoute({
+    method: "get",
+    path: "/staff/invitations",
+    tags: ["Admin"],
+    summary: "List pending staff invitations",
+    responses: {
+        200: { content: { "application/json": { schema: DataResponse } }, description: "Invitations" },
+        ...errorResponses,
+    },
+});
+export const listStaffRolesRoute = createRoute({
+    method: "get",
+    path: "/staff/roles",
+    tags: ["Admin"],
+    summary: "Role → permission mapping staff roles resolve to",
+    responses: {
+        200: { content: { "application/json": { schema: DataResponse } }, description: "Roles" },
+        ...errorResponses,
+    },
+});
+export const updateStaffRoleRoute = createRoute({
+    method: "patch",
+    path: "/staff/{id}",
+    tags: ["Admin"],
+    summary: "Change a staff member's role",
+    request: {
+        params: MemberIdParam,
+        body: { content: { "application/json": { schema: UpdateStaffRoleBodySchema } }, required: true },
+    },
+    responses: {
+        200: { content: { "application/json": { schema: DataResponse } }, description: "Role updated." },
+        ...errorResponses,
+    },
+});
+export const revokeStaffRoute = createRoute({
+    method: "delete",
+    path: "/staff/{id}",
+    tags: ["Admin"],
+    summary: "Revoke a staff member's membership",
+    request: { params: MemberIdParam },
+    responses: {
+        200: { content: { "application/json": { schema: DataResponse } }, description: "Membership revoked." },
+        ...errorResponses,
+    },
+});

package/dist/interfaces/rest/schemas/analytics.d.ts

@@ -0,0 +1,252 @@
+import { z } from "@hono/zod-openapi";
+export declare const listReportsRoute: {
+    method: "get";
+    path: "/reports";
+    tags: string[];
+    summary: string;
+    responses: {
+        400: {
+            readonly content: {
+                readonly "application/json": {
+                    readonly schema: z.ZodObject<{
+                        error: z.ZodObject<{
+                            code: z.ZodString;
+                            message: z.ZodString;
+                            details: z.ZodOptional<z.ZodObject<{
+                                issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                    path: z.ZodString;
+                                    message: z.ZodString;
+                                    code: z.ZodString;
+                                }, z.core.$strip>>>;
+                            }, z.core.$strip>>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>;
+                };
+            };
+            readonly description: "Business logic error.";
+        };
+        401: {
+            readonly content: {
+                readonly "application/json": {
+                    readonly schema: z.ZodObject<{
+                        error: z.ZodObject<{
+                            code: z.ZodString;
+                            message: z.ZodString;
+                            details: z.ZodOptional<z.ZodObject<{
+                                issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                    path: z.ZodString;
+                                    message: z.ZodString;
+                                    code: z.ZodString;
+                                }, z.core.$strip>>>;
+                            }, z.core.$strip>>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>;
+                };
+            };
+            readonly description: "Authentication required.";
+        };
+        403: {
+            readonly content: {
+                readonly "application/json": {
+                    readonly schema: z.ZodObject<{
+                        error: z.ZodObject<{
+                            code: z.ZodString;
+                            message: z.ZodString;
+                            details: z.ZodOptional<z.ZodObject<{
+                                issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                    path: z.ZodString;
+                                    message: z.ZodString;
+                                    code: z.ZodString;
+                                }, z.core.$strip>>>;
+                            }, z.core.$strip>>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>;
+                };
+            };
+            readonly description: "Insufficient permissions.";
+        };
+        404: {
+            readonly content: {
+                readonly "application/json": {
+                    readonly schema: z.ZodObject<{
+                        error: z.ZodObject<{
+                            code: z.ZodString;
+                            message: z.ZodString;
+                            details: z.ZodOptional<z.ZodObject<{
+                                issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                    path: z.ZodString;
+                                    message: z.ZodString;
+                                    code: z.ZodString;
+                                }, z.core.$strip>>>;
+                            }, z.core.$strip>>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>;
+                };
+            };
+            readonly description: "Resource not found.";
+        };
+        422: {
+            readonly content: {
+                readonly "application/json": {
+                    readonly schema: z.ZodObject<{
+                        error: z.ZodObject<{
+                            code: z.ZodString;
+                            message: z.ZodString;
+                            details: z.ZodOptional<z.ZodObject<{
+                                issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                    path: z.ZodString;
+                                    message: z.ZodString;
+                                    code: z.ZodString;
+                                }, z.core.$strip>>>;
+                            }, z.core.$strip>>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>;
+                };
+            };
+            readonly description: "Validation error.";
+        };
+        200: {
+            content: {
+                "application/json": {
+                    schema: z.ZodObject<{
+                        data: z.ZodAny;
+                    }, z.core.$strip>;
+                };
+            };
+            description: string;
+        };
+    };
+} & {
+    getRoutingPath(): "/reports";
+};
+export declare const getReportRoute: {
+    method: "get";
+    path: "/reports/{name}";
+    tags: string[];
+    summary: string;
+    request: {
+        params: z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$strip>;
+        query: z.ZodObject<{
+            date: z.ZodOptional<z.ZodString>;
+            from: z.ZodOptional<z.ZodString>;
+            to: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    };
+    responses: {
+        400: {
+            readonly content: {
+                readonly "application/json": {
+                    readonly schema: z.ZodObject<{
+                        error: z.ZodObject<{
+                            code: z.ZodString;
+                            message: z.ZodString;
+                            details: z.ZodOptional<z.ZodObject<{
+                                issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                    path: z.ZodString;
+                                    message: z.ZodString;
+                                    code: z.ZodString;
+                                }, z.core.$strip>>>;
+                            }, z.core.$strip>>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>;
+                };
+            };
+            readonly description: "Business logic error.";
+        };
+        401: {
+            readonly content: {
+                readonly "application/json": {
+                    readonly schema: z.ZodObject<{
+                        error: z.ZodObject<{
+                            code: z.ZodString;
+                            message: z.ZodString;
+                            details: z.ZodOptional<z.ZodObject<{
+                                issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                    path: z.ZodString;
+                                    message: z.ZodString;
+                                    code: z.ZodString;
+                                }, z.core.$strip>>>;
+                            }, z.core.$strip>>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>;
+                };
+            };
+            readonly description: "Authentication required.";
+        };
+        403: {
+            readonly content: {
+                readonly "application/json": {
+                    readonly schema: z.ZodObject<{
+                        error: z.ZodObject<{
+                            code: z.ZodString;
+                            message: z.ZodString;
+                            details: z.ZodOptional<z.ZodObject<{
+                                issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                    path: z.ZodString;
+                                    message: z.ZodString;
+                                    code: z.ZodString;
+                                }, z.core.$strip>>>;
+                            }, z.core.$strip>>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>;
+                };
+            };
+            readonly description: "Insufficient permissions.";
+        };
+        404: {
+            readonly content: {
+                readonly "application/json": {
+                    readonly schema: z.ZodObject<{
+                        error: z.ZodObject<{
+                            code: z.ZodString;
+                            message: z.ZodString;
+                            details: z.ZodOptional<z.ZodObject<{
+                                issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                    path: z.ZodString;
+                                    message: z.ZodString;
+                                    code: z.ZodString;
+                                }, z.core.$strip>>>;
+                            }, z.core.$strip>>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>;
+                };
+            };
+            readonly description: "Resource not found.";
+        };
+        422: {
+            readonly content: {
+                readonly "application/json": {
+                    readonly schema: z.ZodObject<{
+                        error: z.ZodObject<{
+                            code: z.ZodString;
+                            message: z.ZodString;
+                            details: z.ZodOptional<z.ZodObject<{
+                                issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                    path: z.ZodString;
+                                    message: z.ZodString;
+                                    code: z.ZodString;
+                                }, z.core.$strip>>>;
+                            }, z.core.$strip>>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>;
+                };
+            };
+            readonly description: "Validation error.";
+        };
+        200: {
+            content: {
+                "application/json": {
+                    schema: z.ZodObject<{
+                        data: z.ZodAny;
+                    }, z.core.$strip>;
+                };
+            };
+            description: string;
+        };
+    };
+} & {
+    getRoutingPath(): "/reports/:name";
+};
+//# sourceMappingURL=analytics.d.ts.map

package/dist/interfaces/rest/schemas/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/rest/schemas/analytics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAe,MAAM,mBAAmB,CAAC;AAiBnD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAS3B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAUzB,CAAC"}

package/dist/interfaces/rest/schemas/analytics.js

@@ -0,0 +1,33 @@
+import { z, createRoute } from "@hono/zod-openapi";
+import { errorResponses } from "./shared.js";
+const DATE = /^\d{4}-\d{2}-\d{2}$/;
+const ReportParamsSchema = z.object({
+    name: z.string().regex(/^[a-z][a-z0-9-]*$/).openapi({ example: "daily-journal" }),
+});
+const ReportQuerySchema = z.object({
+    date: z.string().regex(DATE).optional().openapi({ description: "Local calendar date (single-day reports)." }),
+    from: z.string().regex(DATE).optional().openapi({ description: "Local range start, inclusive." }),
+    to: z.string().regex(DATE).optional().openapi({ description: "Local range end, inclusive." }),
+});
+const DataResponse = z.object({ data: z.any() }).openapi("AnalyticsReportResponse");
+export const listReportsRoute = createRoute({
+    method: "get",
+    path: "/reports",
+    tags: ["Analytics"],
+    summary: "List the canned retail reports",
+    responses: {
+        200: { content: { "application/json": { schema: DataResponse } }, description: "Available reports." },
+        ...errorResponses,
+    },
+});
+export const getReportRoute = createRoute({
+    method: "get",
+    path: "/reports/{name}",
+    tags: ["Analytics"],
+    summary: "Run a canned retail report (calendar math in the store's timezone)",
+    request: { params: ReportParamsSchema, query: ReportQuerySchema },
+    responses: {
+        200: { content: { "application/json": { schema: DataResponse } }, description: "Report result." },
+        ...errorResponses,
+    },
+});