spaps-sdk 1.6.1 → 1.6.3

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as spaps_types from 'spaps-types';
-import { ResourceType, Entitlement, CreateProductRequest, Product, UpdateProductRequest, CreatePriceRequest, Price, ProductSyncResult, CryptoReconcileRequest, CreateSecureMessageRequest, SecureMessage, AuthResponse, User as User$1, CreateCryptoInvoiceRequest, CryptoInvoiceStatusSnapshot, CheckoutSession, DayrateAvailabilityResponse, DayrateBookingRequest, DayrateBookingResponse, DayrateMultiBookingRequest, DayrateMultiBookingResponse, Subscription, UsageBalance, VerifyCryptoWebhookSignatureOptions } from 'spaps-types';
-export { AdminPermission, AdminRole, AdminUser, ApiResponse, AuthResponse, CheckoutSession, CreateCryptoInvoiceRequest, CreatePriceRequest, CreateProductRequest, CreateSecureMessageInput, CreateSecureMessageRequest, CryptoInvoice, CryptoInvoiceResponse, CryptoInvoiceStatusSnapshot, CryptoReconcileRequest, DayrateAvailabilityResponse, DayrateAvailableSlot, DayrateBookingRequest, DayrateBookingResponse, DayrateDayOfWeek, DayrateMultiBookingRequest, DayrateMultiBookingResponse, DayratePriceBreakdown, DayrateSlotType, Entitlement, Price, Product, ProductSyncResult, ResourceType, SecureMessage, SecureMessageOutput, Subscription, TokenPair, UpdateProductRequest, UsageBalance, User, UserProfile, UserRole, UserWallet, VerifyCryptoWebhookSignatureOptions, createSecureMessageRequestSchema, secureMessageMetadataSchema, secureMessageSchema } from 'spaps-types';
+import { ResourceType, Entitlement, CreateProductRequest, Product, UpdateProductRequest, CreatePriceRequest, Price, ProductSyncResult, CryptoReconcileRequest, CreateSecureMessageRequest, SecureMessage, IssueReportStatusResult, IssueReportStatus, IssueReportListResult, IssueReport, CreateIssueReportRequest, UpdateIssueReportRequest, ReplyIssueReportRequest, AuthResponse, User as User$1, CreateCryptoInvoiceRequest, CryptoInvoiceStatusSnapshot, CheckoutSession, DayrateAvailabilityResponse, DayrateBookingRequest, DayrateBookingResponse, DayrateMultiBookingRequest, DayrateMultiBookingResponse, Subscription, UsageBalance, VerifyCryptoWebhookSignatureOptions } from 'spaps-types';
+export { AdminPermission, AdminRole, AdminUser, ApiResponse, AuthResponse, CheckoutSession, CreateCryptoInvoiceRequest, CreateIssueReportRequest, CreatePriceRequest, CreateProductRequest, CreateSecureMessageInput, CreateSecureMessageRequest, CryptoInvoice, CryptoInvoiceResponse, CryptoInvoiceStatusSnapshot, CryptoReconcileRequest, DayrateAvailabilityResponse, DayrateAvailableSlot, DayrateBookingRequest, DayrateBookingResponse, DayrateDayOfWeek, DayrateMultiBookingRequest, DayrateMultiBookingResponse, DayratePriceBreakdown, DayrateSlotType, Entitlement, IssueReport, IssueReportListResult, IssueReportStatus, IssueReportStatusResult, IssueReportTarget, LinkedIssueReportCase, Price, Product, ProductSyncResult, ReplyIssueReportRequest, ResourceType, SecureMessage, SecureMessageOutput, Subscription, TokenPair, UpdateIssueReportRequest, UpdateProductRequest, UsageBalance, User, UserProfile, UserRole, UserWallet, VerifyCryptoWebhookSignatureOptions, createSecureMessageRequestSchema, secureMessageMetadataSchema, secureMessageSchema } from 'spaps-types';
 
 /**
  * Permission checking utilities for SPAPS SDK
@@ -344,6 +344,11 @@ interface EntitlementCheckResult {
     /** The matching entitlement, if any */
     entitlement?: Entitlement;
 }
+interface IssueReportListParams {
+    status?: IssueReportStatus;
+    limit?: number;
+    offset?: number;
+}
 
 declare class SPAPSClient<SecureMessageMetadata extends Record<string, any> = Record<string, any>> {
     private client;
@@ -429,6 +434,35 @@ declare class SPAPSClient<SecureMessageMetadata extends Record<string, any> = Re
          */
         listByResource: (resourceType: ResourceType, resourceId?: string) => Promise<Entitlement[]>;
     };
+    /**
+     * Issue reporting namespace for authenticated end-user issue flows.
+     */
+    issueReporting: {
+        /**
+         * Return canonical issue-report summary for the shared floating entrypoint.
+         */
+        getStatus: () => Promise<IssueReportStatusResult>;
+        /**
+         * List the caller's issue reports inside the active application scope.
+         */
+        list: (params?: IssueReportListParams) => Promise<IssueReportListResult>;
+        /**
+         * Hydrate one canonical issue report by ID.
+         */
+        get: (issueReportId: string) => Promise<IssueReport>;
+        /**
+         * Create a new canonical issue report.
+         */
+        create: (payload: CreateIssueReportRequest) => Promise<IssueReport>;
+        /**
+         * Update the note for an unresolved issue report.
+         */
+        update: (issueReportId: string, payload: UpdateIssueReportRequest) => Promise<IssueReport>;
+        /**
+         * Reply to a resolved or ignored issue report and reopen the linked case.
+         */
+        reply: (issueReportId: string, payload: ReplyIssueReportRequest) => Promise<IssueReport>;
+    };
     constructor(config?: SPAPSConfig);
     /** Raw API request helper that returns an ApiResponse-like shape */
     request<T = any>(method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH', url: string, data?: any, requiresAuth?: boolean): Promise<{
@@ -895,4 +929,4 @@ declare function createServerClient(secretKey: string, options?: Omit<SPAPSConfi
  */
 declare function detectKeyType(key: string): ApiKeyType | null;
 
-export { type AdminConfig, type ApiKeyType, type CheckoutLineItem, type CheckoutLineItemPriceData, type CreateCheckoutSessionPayload, DEFAULT_ADMIN_ACCOUNTS, type EmailSendOptions, type EmailSendResult, type EmailTemplate, type EmailTemplatePreview, type EntitlementCheckResult, type EntitlementListParams, type FeatureContext, type FeatureDefinition, FeatureEvaluator, type PermissionCheckResult, PermissionChecker, RoleHierarchy, SPAPSClient as SPAPS, SPAPSClient, type SPAPSConfig, type TemplateVariable, TokenManager, WalletUtils, WebSocketAuthHelper, type WebSocketAuthHelperConfig, canAccessAdmin, createBrowserClient, createPermissionChecker, createServerClient, SPAPSClient as default, defaultPermissionChecker, detectKeyType, getRoleAwareErrorMessage, getUserDisplay, getUserRole, hasPermission, isAdminAccount, verifyCryptoWebhookSignature };
+export { type AdminConfig, type ApiKeyType, type CheckoutLineItem, type CheckoutLineItemPriceData, type CreateCheckoutSessionPayload, DEFAULT_ADMIN_ACCOUNTS, type EmailSendOptions, type EmailSendResult, type EmailTemplate, type EmailTemplatePreview, type EntitlementCheckResult, type EntitlementListParams, type FeatureContext, type FeatureDefinition, FeatureEvaluator, type IssueReportListParams, type PermissionCheckResult, PermissionChecker, RoleHierarchy, SPAPSClient as SPAPS, SPAPSClient, type SPAPSConfig, type TemplateVariable, TokenManager, WalletUtils, WebSocketAuthHelper, type WebSocketAuthHelperConfig, canAccessAdmin, createBrowserClient, createPermissionChecker, createServerClient, SPAPSClient as default, defaultPermissionChecker, detectKeyType, getRoleAwareErrorMessage, getUserDisplay, getUserRole, hasPermission, isAdminAccount, verifyCryptoWebhookSignature };

package/dist/index.js

@@ -630,6 +630,79 @@ var SPAPSClient = class {
       return payload;
     }
   };
+  /**
+   * Issue reporting namespace for authenticated end-user issue flows.
+   */
+  issueReporting = {
+    /**
+     * Return canonical issue-report summary for the shared floating entrypoint.
+     */
+    getStatus: async () => {
+      const res = await this.client.get(
+        "/api/v1/issue-reports/status",
+        this.accessToken ? { headers: { Authorization: `Bearer ${this.accessToken}` } } : void 0
+      );
+      return this.unwrapApiResponse(res, "Failed to get issue report status");
+    },
+    /**
+     * List the caller's issue reports inside the active application scope.
+     */
+    list: async (params) => {
+      const q = new URLSearchParams();
+      if (params?.status) q.append("status", params.status);
+      if (params?.limit !== void 0) q.append("limit", String(params.limit));
+      if (params?.offset !== void 0) q.append("offset", String(params.offset));
+      const qs = q.toString();
+      const res = await this.client.get(
+        `/api/v1/issue-reports${qs ? `?${qs}` : ""}`,
+        this.accessToken ? { headers: { Authorization: `Bearer ${this.accessToken}` } } : void 0
+      );
+      return this.unwrapApiResponse(res, "Failed to list issue reports");
+    },
+    /**
+     * Hydrate one canonical issue report by ID.
+     */
+    get: async (issueReportId) => {
+      const res = await this.client.get(
+        `/api/v1/issue-reports/${issueReportId}`,
+        this.accessToken ? { headers: { Authorization: `Bearer ${this.accessToken}` } } : void 0
+      );
+      return this.unwrapApiResponse(res, "Failed to get issue report");
+    },
+    /**
+     * Create a new canonical issue report.
+     */
+    create: async (payload) => {
+      const res = await this.client.post(
+        "/api/v1/issue-reports",
+        payload,
+        this.accessToken ? { headers: { Authorization: `Bearer ${this.accessToken}` } } : void 0
+      );
+      return this.unwrapApiResponse(res, "Failed to create issue report");
+    },
+    /**
+     * Update the note for an unresolved issue report.
+     */
+    update: async (issueReportId, payload) => {
+      const res = await this.client.patch(
+        `/api/v1/issue-reports/${issueReportId}`,
+        payload,
+        this.accessToken ? { headers: { Authorization: `Bearer ${this.accessToken}` } } : void 0
+      );
+      return this.unwrapApiResponse(res, "Failed to update issue report");
+    },
+    /**
+     * Reply to a resolved or ignored issue report and reopen the linked case.
+     */
+    reply: async (issueReportId, payload) => {
+      const res = await this.client.post(
+        `/api/v1/issue-reports/${issueReportId}/replies`,
+        payload,
+        this.accessToken ? { headers: { Authorization: `Bearer ${this.accessToken}` } } : void 0
+      );
+      return this.unwrapApiResponse(res, "Failed to reply to issue report");
+    }
+  };
   constructor(config = {}) {
     const apiUrl = config.apiUrl || process.env.SPAPS_API_URL || process.env.NEXT_PUBLIC_SPAPS_API_URL;
     const isBrowser = typeof window !== "undefined";

package/dist/index.mjs

@@ -600,6 +600,79 @@ var SPAPSClient = class {
       return payload;
     }
   };
+  /**
+   * Issue reporting namespace for authenticated end-user issue flows.
+   */
+  issueReporting = {
+    /**
+     * Return canonical issue-report summary for the shared floating entrypoint.
+     */
+    getStatus: async () => {
+      const res = await this.client.get(
+        "/api/v1/issue-reports/status",
+        this.accessToken ? { headers: { Authorization: `Bearer ${this.accessToken}` } } : void 0
+      );
+      return this.unwrapApiResponse(res, "Failed to get issue report status");
+    },
+    /**
+     * List the caller's issue reports inside the active application scope.
+     */
+    list: async (params) => {
+      const q = new URLSearchParams();
+      if (params?.status) q.append("status", params.status);
+      if (params?.limit !== void 0) q.append("limit", String(params.limit));
+      if (params?.offset !== void 0) q.append("offset", String(params.offset));
+      const qs = q.toString();
+      const res = await this.client.get(
+        `/api/v1/issue-reports${qs ? `?${qs}` : ""}`,
+        this.accessToken ? { headers: { Authorization: `Bearer ${this.accessToken}` } } : void 0
+      );
+      return this.unwrapApiResponse(res, "Failed to list issue reports");
+    },
+    /**
+     * Hydrate one canonical issue report by ID.
+     */
+    get: async (issueReportId) => {
+      const res = await this.client.get(
+        `/api/v1/issue-reports/${issueReportId}`,
+        this.accessToken ? { headers: { Authorization: `Bearer ${this.accessToken}` } } : void 0
+      );
+      return this.unwrapApiResponse(res, "Failed to get issue report");
+    },
+    /**
+     * Create a new canonical issue report.
+     */
+    create: async (payload) => {
+      const res = await this.client.post(
+        "/api/v1/issue-reports",
+        payload,
+        this.accessToken ? { headers: { Authorization: `Bearer ${this.accessToken}` } } : void 0
+      );
+      return this.unwrapApiResponse(res, "Failed to create issue report");
+    },
+    /**
+     * Update the note for an unresolved issue report.
+     */
+    update: async (issueReportId, payload) => {
+      const res = await this.client.patch(
+        `/api/v1/issue-reports/${issueReportId}`,
+        payload,
+        this.accessToken ? { headers: { Authorization: `Bearer ${this.accessToken}` } } : void 0
+      );
+      return this.unwrapApiResponse(res, "Failed to update issue report");
+    },
+    /**
+     * Reply to a resolved or ignored issue report and reopen the linked case.
+     */
+    reply: async (issueReportId, payload) => {
+      const res = await this.client.post(
+        `/api/v1/issue-reports/${issueReportId}/replies`,
+        payload,
+        this.accessToken ? { headers: { Authorization: `Bearer ${this.accessToken}` } } : void 0
+      );
+      return this.unwrapApiResponse(res, "Failed to reply to issue report");
+    }
+  };
   constructor(config = {}) {
     const apiUrl = config.apiUrl || process.env.SPAPS_API_URL || process.env.NEXT_PUBLIC_SPAPS_API_URL;
     const isBrowser = typeof window !== "undefined";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spaps-sdk",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "description": "Sweet Potato Authentication & Payment Service SDK - Zero-config client with built-in permission checking, role-based access control, and dayrate scheduling",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -20,6 +20,8 @@
     "build": "tsup --tsconfig tsconfig.json src/index.ts --format cjs,esm --dts --clean",
     "dev": "tsup --tsconfig tsconfig.json src/index.ts --format cjs,esm --dts --watch",
     "test": "vitest run",
+    "test:readme": "vitest run test/readme-snippets.test.ts",
+    "typecheck:readme": "tsc -p tsconfig.readme.json --noEmit",
     "smoke-test": "npm run build && node smoke-test.js",
     "prepublishOnly": "npm run build && npm run smoke-test"
   },
@@ -36,10 +38,10 @@
     "scheduling"
   ],
   "author": "buildooor",
-  "license": "UNLICENSED",
+  "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/build000r"
+    "url": "https://github.com/build000r/sweet-potato"
   },
   "homepage": "https://www.buildooor.com/services",
   "bugs": {
@@ -66,7 +68,9 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md",
+    "PERMISSIONS.md"
   ],
   "publishConfig": {
     "access": "public",