electric-coop-api 0.0.1

package/jsr.json

@@ -0,0 +1,27 @@
+
+
+{
+  "name": "electric-coop-api",
+  "version": "0.0.1",
+  "exports": {
+    ".": "./src/index.ts",    
+    "./models/errors": "./src/models/errors/index.ts",    
+    "./models": "./src/models/index.ts",    
+    "./models/operations": "./src/models/operations/index.ts",
+    "./lib/config": "./src/lib/config.ts",
+    "./lib/http": "./src/lib/http.ts",
+    "./lib/retries": "./src/lib/retries.ts",
+    "./lib/sdks": "./src/lib/sdks.ts",
+    "./types": "./src/types/index.ts"
+  },
+  "publish": {
+    "include": [
+      "LICENSE",
+      "README.md",
+      "RUNTIMES.md",
+      "USAGE.md",
+      "jsr.json",
+      "src/**/*.ts"
+    ]
+  }
+}

package/openapi.json

@@ -0,0 +1 @@
+{"openapi":"3.0.0","paths":{"/api/v1/auth/login":{"post":{"operationId":"AuthController_login","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginDto"}}}},"responses":{"200":{"description":"Login response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/AuthResponseDto"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"}},"summary":"Login consumer user","tags":["Auth"]}},"/api/v1/auth/admin/login":{"post":{"operationId":"AuthController_adminLogin","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminLoginDto"}}}},"responses":{"200":{"description":"Admin login response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/AuthResponseDto"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"summary":"Login admin/staff user","tags":["Auth"]}},"/api/v1/auth/refresh":{"post":{"operationId":"AuthController_refresh","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefreshTokenDto"}}}},"responses":{"200":{"description":"Refresh tokens","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/RefreshTokenResponseDto"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"}},"summary":"Refresh access token","tags":["Auth"]}},"/api/v1/auth/logout":{"post":{"operationId":"AuthController_logout","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LogoutDto"}}}},"responses":{"200":{"description":"Logout response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/MessageResponseDto"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Logout current user","tags":["Auth"]}},"/api/v1/auth/admin/revoke-user/{id}":{"post":{"operationId":"AuthController_revokeUser","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"User tokens revoked","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/MessageResponseDto"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Revoke all tokens for a user (admin)","tags":["Auth"]}},"/api/v1/auth/admin/revoke-tenant/{id}":{"post":{"operationId":"AuthController_revokeTenant","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Tenant tokens revoked","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/MessageResponseDto"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Revoke all tokens for a tenant (admin)","tags":["Auth"]}},"/api/v1/bills":{"get":{"operationId":"BillsController_findAll","parameters":[{"name":"page","required":false,"in":"query","schema":{"minimum":1,"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"minimum":1,"maximum":100,"default":10,"type":"number"}},{"name":"status","required":false,"in":"query","schema":{"$ref":"#/components/schemas/BillStatusEnum"}},{"name":"billingPeriod","required":false,"in":"query","schema":{"example":"2026-01","type":"string"}},{"name":"search","required":false,"in":"query","schema":{"example":"Juan Dela Cruz","type":"string"}},{"name":"accountNumber","required":false,"in":"query","schema":{"example":"ACC-001","type":"string"}}],"responses":{"200":{"description":"Paginated bills","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/PaginatedResponseDto"},{"properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Bill"}}}}]}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Get paginated bills","tags":["Bills"]},"post":{"operationId":"BillsController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBillDto"}}}},"responses":{"200":{"description":"Created bill","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/Bill"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Create bill","tags":["Bills"]}},"/api/v1/bills/current":{"get":{"operationId":"BillsController_getCurrent","parameters":[],"responses":{"200":{"description":"Current bill","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/Bill"}}}}}},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Get current bill","tags":["Bills"]}},"/api/v1/bills/payment-history":{"get":{"operationId":"BillsController_getPaymentHistory","parameters":[],"responses":{"200":{"description":"Payment history","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Bill"}}}}}}},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Get payment history","tags":["Bills"]}},"/api/v1/bills/{id}":{"get":{"operationId":"BillsController_findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Bill details","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/Bill"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Get bill by id","tags":["Bills"]}},"/api/v1/bills/bulk":{"post":{"operationId":"BillsController_createBulk","parameters":[],"responses":{"200":{"description":"Created bills","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Bill"}}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Create bills in bulk","tags":["Bills"]}},"/api/v1/bills/import":{"post":{"operationId":"BillsController_importCsv","parameters":[],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}}}},"responses":{"200":{"description":"Import summary","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/BillsImportResultDto"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Import bills from CSV","tags":["Bills"]}},"/api/v1/bills/template/csv":{"get":{"operationId":"BillsController_downloadCsvTemplate","parameters":[],"responses":{"200":{"description":"CSV template file","content":{"text/csv":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Download CSV template","tags":["Bills"]}},"/api/v1/bills/{id}/pdf":{"get":{"operationId":"BillsController_downloadPdf","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Bill PDF file","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Download bill PDF","tags":["Bills"]}},"/api/v1/admin/bills":{"get":{"operationId":"AdminBillsController_findAll","parameters":[{"name":"page","required":false,"in":"query","schema":{"minimum":1,"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"minimum":1,"maximum":100,"default":10,"type":"number"}},{"name":"status","required":false,"in":"query","schema":{"$ref":"#/components/schemas/BillStatusEnum"}},{"name":"billingPeriod","required":false,"in":"query","schema":{"example":"2026-01","type":"string"}},{"name":"search","required":false,"in":"query","schema":{"example":"Juan Dela Cruz","type":"string"}},{"name":"accountNumber","required":false,"in":"query","schema":{"example":"ACC-001","type":"string"}},{"name":"consumerId","required":false,"in":"query","schema":{"format":"uuid","example":"7f63b8a2-2a4a-4f4d-9e0f-6f9f7b6e0f1a","type":"string"}}],"responses":{"200":{"description":"Paginated bills","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/PaginatedResponseDto"},{"properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Bill"}}}}]}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Get paginated bills (admin)","tags":["Admin Bills"]},"post":{"operationId":"AdminBillsController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBillDto"}}}},"responses":{"200":{"description":"Created bill","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/Bill"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Create bill (admin)","tags":["Admin Bills"]}},"/api/v1/admin/bills/{id}":{"get":{"operationId":"AdminBillsController_findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Bill details","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/Bill"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Get bill by id (admin)","tags":["Admin Bills"]},"put":{"operationId":"AdminBillsController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateBillDto"}}}},"responses":{"200":{"description":"Updated bill","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/Bill"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Update bill (admin)","tags":["Admin Bills"]},"delete":{"operationId":"AdminBillsController_delete","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Bill deleted","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/MessageResponseDto"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Delete bill (admin)","tags":["Admin Bills"]}},"/api/v1/admin/bills/import":{"post":{"operationId":"AdminBillsController_importCsv","parameters":[],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}}}},"responses":{"200":{"description":"Import summary","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/BillsImportResultDto"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Import bills from CSV (admin)","tags":["Admin Bills"]}},"/api/v1/consumers/profile":{"get":{"operationId":"ConsumersController_getProfile","parameters":[],"responses":{"200":{"description":"Consumer profile","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/Consumer"}}}}}},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Get consumer profile","tags":["Consumers"]}},"/api/v1/consumers/accounts":{"get":{"operationId":"ConsumersController_getAccounts","parameters":[],"responses":{"200":{"description":"Consumer accounts","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/AccountListDto"}}}}}},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Get consumer accounts","tags":["Consumers"]}},"/api/v1/consumers/accounts/{accountNumber}":{"get":{"operationId":"ConsumersController_getAccount","parameters":[{"name":"accountNumber","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Consumer account","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/AccountDto"}}}}}},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Get consumer account by number","tags":["Consumers"]}},"/api/v1/admin/consumers":{"post":{"operationId":"AdminConsumersController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateConsumerDto"}}}},"responses":{"200":{"description":"Create consumer","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/Consumer"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Create consumer","tags":["Admin Consumers"]},"get":{"operationId":"AdminConsumersController_findAll","parameters":[{"name":"page","required":false,"in":"query","schema":{"minimum":1,"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"minimum":1,"maximum":100,"default":10,"type":"number"}},{"name":"search","required":false,"in":"query","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"$ref":"#/components/schemas/ConsumerStatusEnum"}},{"name":"sortBy","required":false,"in":"query","schema":{"type":"string","enum":["accountNumber","name","email","createdAt"]}},{"name":"order","required":false,"in":"query","schema":{"type":"string","enum":["asc","desc","ASC","DESC"]}}],"responses":{"200":{"description":"Paginated consumers","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/PaginatedResponseDto"},{"properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Consumer"}}}}]}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Get paginated consumers","tags":["Admin Consumers"]}},"/api/v1/admin/consumers/unbilled/{billingPeriod}":{"get":{"operationId":"AdminConsumersController_getUnbilledConsumers","parameters":[{"name":"billingPeriod","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Get unbilled consumers by billing period","tags":["Admin Consumers"]}},"/api/v1/admin/consumers/{id}":{"get":{"operationId":"AdminConsumersController_findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Get consumer by id","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/Consumer"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Get consumer by id","tags":["Admin Consumers"]},"patch":{"operationId":"AdminConsumersController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateConsumerDto"}}}},"responses":{"200":{"description":"Update consumer","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/Consumer"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Update consumer","tags":["Admin Consumers"]},"delete":{"operationId":"AdminConsumersController_remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Delete consumer"},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Delete consumer","tags":["Admin Consumers"]}},"/api/v1/rates/current":{"get":{"operationId":"RatesController_getCurrentRates","parameters":[],"responses":{"200":{"description":""},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Get current rates","tags":["Rates"]}},"/api/v1/rates/current/{consumerType}":{"get":{"operationId":"RatesController_getCurrentRatesByType","parameters":[{"name":"consumerType","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Get current rates by consumer type","tags":["Rates"]}},"/api/v1/rates/history/{consumerType}":{"get":{"operationId":"RatesController_getRateHistory","parameters":[{"name":"consumerType","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Get rate history","tags":["Rates"]}},"/api/v1/rates/adjustments":{"get":{"operationId":"RatesController_getAdjustments","parameters":[{"name":"status","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"List rate adjustments","tags":["Rates"]},"post":{"operationId":"RatesController_createAdjustment","parameters":[],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Create rate adjustment","tags":["Rates"]}},"/api/v1/rates/adjustments/{id}/approve":{"put":{"operationId":"RatesController_approveAdjustment","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Approve rate adjustment","tags":["Rates"]}},"/api/v1/rates/adjustments/{id}/reject":{"put":{"operationId":"RatesController_rejectAdjustment","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Reject rate adjustment","tags":["Rates"]}},"/api/v1/rates/adjustments/{id}/reapply":{"post":{"operationId":"RatesController_reapplyAdjustment","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Reapply approved rate adjustment","tags":["Rates"]}},"/api/v1/rates/display":{"get":{"operationId":"RateDisplayController_getStructure","parameters":[{"name":"consumerType","required":true,"in":"query","schema":{"type":"string"}},{"name":"hasNetMetering","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Get rate display structure","tags":["Rate Display"]},"put":{"operationId":"RateDisplayController_updateStructure","parameters":[],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Update rate display structure","tags":["Rate Display"]},"delete":{"operationId":"RateDisplayController_deleteStructure","parameters":[{"name":"consumerType","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Delete rate display structure","tags":["Rate Display"]}},"/api/v1/rates/display/versions":{"get":{"operationId":"RateDisplayController_getAllVersions","parameters":[{"name":"consumerType","required":true,"in":"query","schema":{"type":"string"}},{"name":"hasNetMetering","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"List rate display versions","tags":["Rate Display"]},"post":{"operationId":"RateDisplayController_createVersion","parameters":[],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Create rate display version","tags":["Rate Display"]}},"/api/v1/rates/display/versions/{id}":{"get":{"operationId":"RateDisplayController_getVersion","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Get rate display version","tags":["Rate Display"]},"delete":{"operationId":"RateDisplayController_deleteVersion","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Delete rate display version","tags":["Rate Display"]}},"/api/v1/rates/display/versions/{id}/activate":{"put":{"operationId":"RateDisplayController_activateVersion","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Activate rate display version","tags":["Rate Display"]}},"/api/v1/rates/display/initialize":{"post":{"operationId":"RateDisplayController_initializeDefault","parameters":[],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Initialize rate display structure","tags":["Rate Display"]}},"/api/v1/complaints":{"post":{"operationId":"ComplaintsController_create","parameters":[],"responses":{"200":{"description":"Create complaint","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/Complaint"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Create complaint","tags":["Complaints"]},"get":{"operationId":"ComplaintsController_findAll","parameters":[{"name":"page","required":false,"in":"query","schema":{"minimum":1,"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"minimum":1,"maximum":100,"default":10,"type":"number"}},{"name":"status","required":false,"in":"query","schema":{"$ref":"#/components/schemas/ComplaintStatusEnum"}},{"name":"type","required":false,"in":"query","schema":{"$ref":"#/components/schemas/ComplaintTypeEnum"}},{"name":"priority","required":false,"in":"query","schema":{"$ref":"#/components/schemas/ComplaintPriorityEnum"}},{"name":"search","required":false,"in":"query","schema":{"type":"string"}},{"name":"accountNumber","required":false,"in":"query","schema":{"example":"ACC-001","type":"string"}},{"name":"consumerId","required":false,"in":"query","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"Paginated complaints","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/PaginatedResponseDto"},{"properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/PaginatedResponseDto"}}}}]}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"List complaints","tags":["Complaints"]}},"/api/v1/complaints/{id}":{"get":{"operationId":"ComplaintsController_findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Get complaint by id","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/Complaint"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Get complaint by id","tags":["Complaints"]},"patch":{"operationId":"ComplaintsController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateComplaintDto"}}}},"responses":{"200":{"description":"Update complaint","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/Complaint"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Update complaint","tags":["Complaints"]}},"/api/v1/admin/complaints":{"get":{"operationId":"AdminComplaintsController_findAll","parameters":[{"name":"page","required":false,"in":"query","schema":{"minimum":1,"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"minimum":1,"maximum":100,"default":10,"type":"number"}},{"name":"status","required":false,"in":"query","schema":{"$ref":"#/components/schemas/ComplaintStatusEnum"}},{"name":"type","required":false,"in":"query","schema":{"$ref":"#/components/schemas/ComplaintTypeEnum"}},{"name":"priority","required":false,"in":"query","schema":{"$ref":"#/components/schemas/ComplaintPriorityEnum"}},{"name":"search","required":false,"in":"query","schema":{"type":"string"}},{"name":"accountNumber","required":false,"in":"query","schema":{"example":"ACC-001","type":"string"}},{"name":"consumerId","required":false,"in":"query","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"Paginated complaints","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/PaginatedResponseDto"},{"properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Complaint"}}}}]}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Get complaints (admin)","tags":["Admin Complaints"]}},"/api/v1/admin/complaints/stats":{"get":{"operationId":"AdminComplaintsController_getStats","parameters":[],"responses":{"200":{"description":"Complaint stats","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/ComplaintStatsDto"}}}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Get complaint stats","tags":["Admin Complaints"]}},"/api/v1/admin/complaints/{id}":{"get":{"operationId":"AdminComplaintsController_findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Get complaint by id (admin)","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/Complaint"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Get complaint by id (admin)","tags":["Admin Complaints"]},"patch":{"operationId":"AdminComplaintsController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateComplaintDto"}}}},"responses":{"200":{"description":"Update complaint (admin)","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/Complaint"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Update complaint (admin)","tags":["Admin Complaints"]}},"/api/v1/admin/complaints/{id}/status":{"patch":{"operationId":"AdminComplaintsController_updateStatus","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateComplaintDto"}}}},"responses":{"200":{"description":"Update complaint status (admin)","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/Complaint"}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Update complaint status (admin)","tags":["Admin Complaints"]}},"/api/v1/notifications":{"get":{"operationId":"NotificationsController_findAll","parameters":[{"name":"unreadOnly","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"List notifications","tags":["Notifications"]}},"/api/v1/notifications/unread-count":{"get":{"operationId":"NotificationsController_getUnreadCount","parameters":[],"responses":{"200":{"description":""},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Get unread notification count","tags":["Notifications"]}},"/api/v1/notifications/{id}/read":{"patch":{"operationId":"NotificationsController_markAsRead","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Mark notification as read","tags":["Notifications"]}},"/api/v1/notifications/mark-all-read":{"patch":{"operationId":"NotificationsController_markAllAsRead","parameters":[],"responses":{"200":{"description":""},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Mark all notifications as read","tags":["Notifications"]}},"/api/v1/admin/dashboard":{"get":{"operationId":"AdminController_getDashboard","parameters":[],"responses":{"200":{"description":""},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Get admin dashboard summary","tags":["Admin"]}},"/api/v1/dashboard/stats":{"get":{"operationId":"DashboardController_getStats","parameters":[],"responses":{"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Get dashboard stats","tags":["Dashboard"]}},"/api/v1/admin/users":{"post":{"operationId":"UsersController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUserDto"}}}},"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Create user","tags":["Users"]},"get":{"operationId":"UsersController_findAll","parameters":[{"name":"page","required":false,"in":"query","schema":{"minimum":1,"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"minimum":1,"maximum":100,"default":10,"type":"number"}},{"name":"search","required":false,"in":"query","schema":{"type":"string"}},{"name":"role","required":false,"in":"query","schema":{"$ref":"#/components/schemas/UserRoleEnum"}},{"name":"department","required":false,"in":"query","schema":{"$ref":"#/components/schemas/UserDepartmentEnum"}}],"responses":{"200":{"description":"Paginated staff users","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/PaginatedResponseDto"},{"properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/User"}}}}]}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Get paginated staff users","tags":["Users"]}},"/api/v1/admin/users/staff":{"get":{"operationId":"UsersController_getStaffUsers","parameters":[{"name":"page","required":false,"in":"query","schema":{"minimum":1,"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"minimum":1,"maximum":100,"default":10,"type":"number"}},{"name":"search","required":false,"in":"query","schema":{"type":"string"}},{"name":"department","required":false,"in":"query","schema":{"$ref":"#/components/schemas/UserDepartmentEnum"}}],"responses":{"200":{"description":"Paginated staff users","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/PaginatedResponseDto"},{"properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/User"}}}}]}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Get paginated staff users","tags":["Users"]}},"/api/v1/admin/users/{id}":{"get":{"operationId":"UsersController_findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Get user by id","tags":["Users"]},"patch":{"operationId":"UsersController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateUserDto"}}}},"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Update user","tags":["Users"]},"delete":{"operationId":"UsersController_remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Delete user","tags":["Users"]}},"/api/v1/admin/users/{id}/consumer-accounts":{"get":{"operationId":"UsersController_getUserConsumerAccounts","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Get user consumer accounts","tags":["Users"]},"post":{"operationId":"UsersController_createConsumerAccount","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Create consumer account for user","tags":["Users"]}},"/api/v1/admin/users/{id}/consumer-accounts/link":{"post":{"operationId":"UsersController_linkConsumerAccount","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Link consumer account to user","tags":["Users"]}},"/api/v1/admin/users/{id}/consumer-accounts/{accountNumber}":{"delete":{"operationId":"UsersController_unlinkConsumerAccount","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"accountNumber","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Unlink consumer account from user","tags":["Users"]}},"/api/v1/consumer/service-requests":{"post":{"operationId":"ConsumerServiceRequestsController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateServiceRequestDto"}}}},"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Create service request (consumer)","tags":["Consumer Service Requests"]},"get":{"operationId":"ConsumerServiceRequestsController_findAll","parameters":[],"responses":{"200":{"description":""},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"List service requests (consumer)","tags":["Consumer Service Requests"]}},"/api/v1/consumer/service-requests/{id}":{"get":{"operationId":"ConsumerServiceRequestsController_findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Get service request by id (consumer)","tags":["Consumer Service Requests"]}},"/api/v1/consumer/service-requests/{id}/cancel":{"patch":{"operationId":"ConsumerServiceRequestsController_cancel","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"Unauthorized"}},"security":[{"bearer":[]}],"summary":"Cancel service request (consumer)","tags":["Consumer Service Requests"]}},"/api/v1/admin/service-requests":{"get":{"operationId":"AdminServiceRequestsController_findAll","parameters":[{"name":"status","required":false,"in":"query","schema":{"$ref":"#/components/schemas/ServiceRequestStatusEnum"}},{"name":"consumerId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"List service requests (admin)","tags":["Admin Service Requests"]}},"/api/v1/admin/service-requests/stats":{"get":{"operationId":"AdminServiceRequestsController_getStats","parameters":[],"responses":{"200":{"description":""},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Get service request stats","tags":["Admin Service Requests"]}},"/api/v1/admin/service-requests/{id}":{"get":{"operationId":"AdminServiceRequestsController_findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Get service request by id (admin)","tags":["Admin Service Requests"]},"patch":{"operationId":"AdminServiceRequestsController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateServiceRequestDto"}}}},"responses":{"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Update service request (admin)","tags":["Admin Service Requests"]}},"/api/v1/meters/{meterNumber}":{"get":{"operationId":"MetersController_findByMeterNumber","parameters":[{"name":"meterNumber","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Find consumer by meter number","tags":["Meters"]}},"/api/v1/meters/{meterNumber}/reading-history":{"get":{"operationId":"MetersController_getReadingHistory","parameters":[{"name":"meterNumber","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"security":[{"bearer":[]}],"summary":"Get meter reading history","tags":["Meters"]}}},"info":{"title":"Electric Cooperative Consumer Portal API","description":"Multi-tenant SaaS platform for Philippine electric cooperatives","version":"1.0","contact":{}},"tags":[{"name":"Auth","description":"Authentication endpoints"},{"name":"Bills","description":"Bill management"},{"name":"Complaints","description":"Complaint/service request management"},{"name":"Consumers","description":"Consumer management"},{"name":"Admin","description":"Admin dashboard"}],"servers":[],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"AuthConsumerAccountDto":{"type":"object","properties":{"accountNumber":{"type":"string"},"name":{"type":"string"},"address":{"type":"string"},"consumerType":{"type":"string"},"isPrimary":{"type":"boolean"}},"required":["accountNumber","name","address","consumerType","isPrimary"]},"AuthConsumerDto":{"type":"object","properties":{"id":{"type":"string"},"accountNumber":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"mobile":{"type":"string"},"role":{"type":"string"},"department":{"type":"string"},"permissions":{"type":"array","items":{"type":"string"}},"accounts":{"type":"array","items":{"$ref":"#/components/schemas/AuthConsumerAccountDto"}}},"required":["id","accountNumber","name","role"]},"AuthTenantDto":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"subdomain":{"type":"string"}},"required":["id","name","subdomain"]},"AuthResponseDto":{"type":"object","properties":{"accessToken":{"type":"string"},"refreshToken":{"type":"string"},"consumer":{"$ref":"#/components/schemas/AuthConsumerDto"},"tenant":{"$ref":"#/components/schemas/AuthTenantDto"}},"required":["accessToken","refreshToken","consumer","tenant"]},"LoginDto":{"type":"object","properties":{"email":{"type":"string","format":"email","example":"user@example.com"},"password":{"type":"string","minLength":1,"example":"P@ssw0rd!"}},"required":["email","password"]},"AdminLoginDto":{"type":"object","properties":{"username":{"type":"string","example":"admin@example.com"},"password":{"type":"string","minLength":1,"example":"P@ssw0rd!"}},"required":["username","password"]},"RefreshTokenResponseDto":{"type":"object","properties":{"accessToken":{"type":"string"},"refreshToken":{"type":"string"}},"required":["accessToken","refreshToken"]},"RefreshTokenDto":{"type":"object","properties":{"refreshToken":{"type":"string","example":"refresh_token_value"}},"required":["refreshToken"]},"MessageResponseDto":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"LogoutDto":{"type":"object","properties":{"refreshToken":{"type":"string","example":"refresh_token_value"}}},"PaginationMetaDto":{"type":"object","properties":{"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"},"totalPages":{"type":"number"}},"required":["page","limit","total","totalPages"]},"PaginatedResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object"}},"meta":{"$ref":"#/components/schemas/PaginationMetaDto"}},"required":["data","meta"]},"BillStatusEnum":{"type":"string","enum":["unpaid","partial","paid","overdue"]},"Bill":{"type":"object","properties":{"status":{"allOf":[{"$ref":"#/components/schemas/BillStatusEnum"}]}},"required":["status"]},"CreateBillDto":{"type":"object","properties":{"consumerId":{"type":"string","format":"uuid"},"billingPeriod":{"type":"string","example":"2026-01"},"dueDate":{"type":"string","format":"date"},"readingDate":{"type":"string","format":"date"},"previousReading":{"type":"number","example":1000},"currentReading":{"type":"number","example":1150},"consumption":{"type":"number","example":150}},"required":["consumerId","billingPeriod","dueDate","previousReading","currentReading","consumption"]},"BillsImportResultDto":{"type":"object","properties":{"imported":{"type":"number"},"failed":{"type":"number"},"errors":{"type":"array","items":{"type":"string"}}},"required":["imported","failed","errors"]},"UpdateBillDto":{"type":"object","properties":{"status":{"allOf":[{"$ref":"#/components/schemas/BillStatusEnum"}]}}},"ConsumerTypeEnum":{"type":"string","enum":["residential","commercial","industrial","agricultural","public_building","street_lighting"]},"ConsumerRoleEnum":{"type":"string","enum":["consumer","admin","staff"]},"ConsumerStatusEnum":{"type":"string","enum":["active","inactive","disconnected","suspended"]},"ConsumerMetadataDto":{"type":"object","properties":{"meterNumber":{"type":"string","example":"MTR-000123"}}},"Consumer":{"type":"object","properties":{"consumerType":{"allOf":[{"$ref":"#/components/schemas/ConsumerTypeEnum"}]},"role":{"allOf":[{"$ref":"#/components/schemas/ConsumerRoleEnum"}]},"status":{"allOf":[{"$ref":"#/components/schemas/ConsumerStatusEnum"}]},"metadata":{"additionalProperties":true,"allOf":[{"$ref":"#/components/schemas/ConsumerMetadataDto"}]}},"required":["consumerType","role","status"]},"AccountDto":{"type":"object","properties":{"accountNumber":{"type":"string","example":"ACC-001"},"consumerType":{"type":"string","example":"RESIDENTIAL"},"name":{"type":"string","example":"Juan Dela Cruz"},"address":{"type":"string","example":"Sample Address"},"status":{"type":"string","example":"ACTIVE"},"isPrimary":{"type":"boolean","example":true}},"required":["accountNumber","consumerType","name","address","status","isPrimary"]},"AccountListDto":{"type":"object","properties":{"accounts":{"type":"array","items":{"$ref":"#/components/schemas/AccountDto"}},"primaryAccount":{"$ref":"#/components/schemas/AccountDto"}},"required":["accounts","primaryAccount"]},"CreateConsumerDto":{"type":"object","properties":{"accountNumber":{"type":"string","example":"ACC-001"},"name":{"type":"string","example":"Juan Dela Cruz"},"consumerType":{"allOf":[{"$ref":"#/components/schemas/ConsumerTypeEnum"}]},"phone":{"type":"string","example":"+639171234567"},"address":{"type":"string","example":"Sample Address"},"hasNetMetering":{"type":"boolean","example":false},"meterNumber":{"type":"string","example":"MTR-0001"},"birthdate":{"type":"string","example":"1990-01-31"},"status":{"allOf":[{"$ref":"#/components/schemas/ConsumerStatusEnum"}]},"forceReassign":{"type":"boolean","example":false}},"required":["name"]},"UpdateConsumerDto":{"type":"object","properties":{"accountNumber":{"type":"string","example":"ACC-001"},"name":{"type":"string","example":"Juan Dela Cruz"},"consumerType":{"allOf":[{"$ref":"#/components/schemas/ConsumerTypeEnum"}]},"phone":{"type":"string","example":"+639171234567"},"address":{"type":"string","example":"Sample Address"},"hasNetMetering":{"type":"boolean","example":false},"meterNumber":{"type":"string","example":"MTR-0001"},"birthdate":{"type":"string","example":"1990-01-31"},"status":{"allOf":[{"$ref":"#/components/schemas/ConsumerStatusEnum"}]},"forceReassign":{"type":"boolean","example":false}}},"TenantStatusEnum":{"type":"string","enum":["active","inactive","suspended"]},"Tenant":{"type":"object","properties":{"status":{"allOf":[{"$ref":"#/components/schemas/TenantStatusEnum"}]}},"required":["status"]},"ComplaintTypeEnum":{"type":"string","enum":["outage","billing","service_request","technical","other"]},"ComplaintStatusEnum":{"type":"string","enum":["open","in_progress","resolved","closed"]},"ComplaintPriorityEnum":{"type":"string","enum":["low","medium","high","urgent"]},"UserRoleEnum":{"type":"string","enum":["general_manager","department_manager","staff","consumer"]},"UserDepartmentEnum":{"type":"string","enum":["management","field_operations","engineering","billing","customer_service"]},"UserPermissionEnum":{"type":"string","enum":["*","consumers.view","consumers.create","consumers.edit","users.view","bills.view","bills.create","bills.*","payments.view","payments.create","payments.*","collections.*","field.view","field.update","field.*","meters.read","meters.view","meters.*","outages.view","outages.*","work_orders.view","work_orders.*","service.disconnect","service.reconnect","complaints.*","inquiries.*","service_requests.*","engineering.*","technical.view","technical.*","billing.*","reports.*","analytics.*"]},"UserStatusEnum":{"type":"string","enum":["active","inactive","suspended"]},"User":{"type":"object","properties":{"tenantId":{"type":"string","format":"uuid"},"name":{"type":"string","example":"Juan Dela Cruz"},"email":{"type":"string","example":"juan@example.com"},"phone":{"type":"string","example":"+639171234567","nullable":true},"role":{"allOf":[{"$ref":"#/components/schemas/UserRoleEnum"}]},"department":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/UserDepartmentEnum"}]},"permissions":{"type":"array","items":{"$ref":"#/components/schemas/UserPermissionEnum"}},"status":{"allOf":[{"$ref":"#/components/schemas/UserStatusEnum"}]},"metadata":{"type":"object"},"lastLogoutAt":{"type":"object"}},"required":["tenantId","name","email","role","permissions","status"]},"Complaint":{"type":"object","properties":{"tenantId":{"type":"string","format":"uuid"},"tenant":{"$ref":"#/components/schemas/Tenant"},"consumerId":{"type":"string","format":"uuid"},"consumer":{"$ref":"#/components/schemas/Consumer"},"ticketNumber":{"type":"string","example":"CMP-2025-000123"},"type":{"allOf":[{"$ref":"#/components/schemas/ComplaintTypeEnum"}]},"subject":{"type":"string","example":"Service interruption"},"description":{"type":"string","example":"There is a power outage in my area."},"photos":{"example":["https://example.com/photo1.jpg"],"type":"array","items":{"type":"string"}},"status":{"allOf":[{"$ref":"#/components/schemas/ComplaintStatusEnum"}]},"priority":{"allOf":[{"$ref":"#/components/schemas/ComplaintPriorityEnum"}]},"assignedTo":{"type":"object","format":"uuid"},"assignedUser":{"$ref":"#/components/schemas/User"},"resolvedAt":{"type":"string","format":"date-time"},"resolutionNotes":{"type":"object","example":"Issue resolved after transformer replacement."},"adminNotes":{"type":"object","example":"Escalated to field team."},"metadata":{"type":"object","additionalProperties":true}},"required":["tenantId","consumerId","ticketNumber","type","subject","description","status","priority"]},"UpdateComplaintDto":{"type":"object","properties":{"status":{"allOf":[{"$ref":"#/components/schemas/ComplaintStatusEnum"}]},"assignedTo":{"type":"string","format":"uuid","example":"7f63b8a2-2a4a-4f4d-9e0f-6f9f7b6e0f1a"},"resolutionNotes":{"type":"string","example":"Resolved after inspection."},"adminNotes":{"type":"string","example":"Assigned to field team."},"priority":{"allOf":[{"$ref":"#/components/schemas/ComplaintPriorityEnum"}]}}},"ComplaintStatsDto":{"type":"object","properties":{"open":{"type":"number","example":12},"inProgress":{"type":"number","example":5},"resolved":{"type":"number","example":20},"closed":{"type":"number","example":3},"total":{"type":"number","example":40},"avgResolutionTime":{"type":"number","example":18,"description":"Average resolution time in hours."},"resolvedToday":{"type":"number","example":2},"resolutionRate":{"type":"number","example":50,"description":"Resolved percentage (0-100)."}},"required":["open","inProgress","resolved","closed","total","avgResolutionTime","resolvedToday","resolutionRate"]},"CreateUserDto":{"type":"object","properties":{"name":{"type":"string","example":"Juan Dela Cruz"},"email":{"type":"string","format":"email","example":"user@example.com"},"phone":{"type":"string","example":"+639171234567"},"role":{"allOf":[{"$ref":"#/components/schemas/UserRoleEnum"}]},"department":{"allOf":[{"$ref":"#/components/schemas/UserDepartmentEnum"}]},"status":{"allOf":[{"$ref":"#/components/schemas/UserStatusEnum"}]},"metadata":{"type":"object","additionalProperties":true,"example":{"address":"Sample Address","notes":"Optional metadata"}}},"required":["name","email","role"]},"UpdateUserDto":{"type":"object","properties":{"name":{"type":"string","example":"Juan Dela Cruz"},"email":{"type":"string","format":"email","example":"user@example.com"},"phone":{"type":"string","example":"+639171234567"},"password":{"type":"string","minLength":1,"example":"P@ssw0rd!"},"role":{"allOf":[{"$ref":"#/components/schemas/UserRoleEnum"}]},"department":{"allOf":[{"$ref":"#/components/schemas/UserDepartmentEnum"}]},"status":{"allOf":[{"$ref":"#/components/schemas/UserStatusEnum"}]}}},"ServiceRequestTypeEnum":{"type":"string","enum":["new_connection","service_transfer","reconnection","meter_upgrade","load_change","name_change","disconnection"]},"ServiceRequestPriorityEnum":{"type":"string","enum":["low","normal","high","urgent"]},"CreateServiceRequestDto":{"type":"object","properties":{"consumerId":{"type":"string","format":"uuid"},"type":{"allOf":[{"$ref":"#/components/schemas/ServiceRequestTypeEnum"}]},"priority":{"allOf":[{"$ref":"#/components/schemas/ServiceRequestPriorityEnum"}]},"subject":{"type":"string","example":"Service connection request"},"description":{"type":"string","example":"Requesting new service connection for address."},"metadata":{"type":"object","additionalProperties":true},"documentUrls":{"type":"array","items":{"type":"string"}}},"required":["consumerId","type","subject","description"]},"ServiceRequestStatusEnum":{"type":"string","enum":["pending","under_review","approved","scheduled","in_progress","completed","rejected","cancelled"]},"UpdateServiceRequestDto":{"type":"object","properties":{"status":{"allOf":[{"$ref":"#/components/schemas/ServiceRequestStatusEnum"}]},"priority":{"allOf":[{"$ref":"#/components/schemas/ServiceRequestPriorityEnum"}]},"assignedTo":{"type":"string","format":"uuid"},"scheduledDate":{"type":"string","format":"date-time"},"adminNotes":{"type":"string","example":"Assigned to team A."},"rejectionReason":{"type":"string","example":"Missing documents."},"completionNotes":{"type":"string","example":"Completed successfully."}}}}}}

package/package.json

@@ -0,0 +1,128 @@
+{
+  "name": "electric-coop-api",
+  "version": "0.0.1",
+  "author": "Speakeasy",
+  "main": "./dist/commonjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/commonjs/index.d.ts",
+  "type": "module",
+  "tshy": {
+    "sourceDialects": [
+      "electric-coop-api/source"
+    ],
+    "exports": {
+      ".": "./src/index.ts",
+      "./package.json": "./package.json",
+      "./types": "./src/types/index.ts",
+      "./models/errors": "./src/models/errors/index.ts",
+      "./models": "./src/models/index.ts",
+      "./models/operations": "./src/models/operations/index.ts",
+      "./*.js": "./src/*.ts",
+      "./*": "./src/*.ts"
+    }
+  },
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/caninojories/electric-coop-api.git"
+  },
+  "scripts": {
+    "lint": "eslint --cache --max-warnings=0 src",
+    "build": "tshy",
+    "prepublishOnly": "npm run build",
+    "openapi:generate": "curl -s http://localhost:3000/api/docs-json -o openapi.json",
+    "sdk:generate": "npm run openapi:generate && speakeasy run --output console --skip-compile"
+  },
+  "peerDependencies": {},
+  "devDependencies": {
+    "@eslint/js": "^9.19.0",
+    "eslint": "^9.19.0",
+    "globals": "^15.14.0",
+    "tshy": "^2.0.0",
+    "typescript": "~5.8.3",
+    "typescript-eslint": "^8.26.0"
+  },
+  "dependencies": {
+    "zod": "^3.25.65 || ^4.0.0"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "electric-coop-api/source": "./src/index.ts",
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/commonjs/index.d.ts",
+        "default": "./dist/commonjs/index.js"
+      }
+    },
+    "./package.json": "./package.json",
+    "./types": {
+      "import": {
+        "electric-coop-api/source": "./src/types/index.ts",
+        "types": "./dist/esm/types/index.d.ts",
+        "default": "./dist/esm/types/index.js"
+      },
+      "require": {
+        "types": "./dist/commonjs/types/index.d.ts",
+        "default": "./dist/commonjs/types/index.js"
+      }
+    },
+    "./models/errors": {
+      "import": {
+        "electric-coop-api/source": "./src/models/errors/index.ts",
+        "types": "./dist/esm/models/errors/index.d.ts",
+        "default": "./dist/esm/models/errors/index.js"
+      },
+      "require": {
+        "types": "./dist/commonjs/models/errors/index.d.ts",
+        "default": "./dist/commonjs/models/errors/index.js"
+      }
+    },
+    "./models": {
+      "import": {
+        "electric-coop-api/source": "./src/models/index.ts",
+        "types": "./dist/esm/models/index.d.ts",
+        "default": "./dist/esm/models/index.js"
+      },
+      "require": {
+        "types": "./dist/commonjs/models/index.d.ts",
+        "default": "./dist/commonjs/models/index.js"
+      }
+    },
+    "./models/operations": {
+      "import": {
+        "electric-coop-api/source": "./src/models/operations/index.ts",
+        "types": "./dist/esm/models/operations/index.d.ts",
+        "default": "./dist/esm/models/operations/index.js"
+      },
+      "require": {
+        "types": "./dist/commonjs/models/operations/index.d.ts",
+        "default": "./dist/commonjs/models/operations/index.js"
+      }
+    },
+    "./*.js": {
+      "import": {
+        "electric-coop-api/source": "./src/*.ts",
+        "types": "./dist/esm/*.d.ts",
+        "default": "./dist/esm/*.js"
+      },
+      "require": {
+        "types": "./dist/commonjs/*.d.ts",
+        "default": "./dist/commonjs/*.js"
+      }
+    },
+    "./*": {
+      "import": {
+        "electric-coop-api/source": "./src/*.ts",
+        "types": "./dist/esm/*.d.ts",
+        "default": "./dist/esm/*.js"
+      },
+      "require": {
+        "types": "./dist/commonjs/*.d.ts",
+        "default": "./dist/commonjs/*.js"
+      }
+    }
+  }
+}

package/src/core.ts

@@ -0,0 +1,13 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { ClientSDK } from "./lib/sdks.js";
+
+/**
+ * A minimal client to use when calling standalone SDK functions. Typically, an
+ * instance of this class would be instantiated once at the start of an
+ * application and passed around through some dependency injection mechanism  to
+ * parts of an application that need to make SDK calls.
+ */
+export class SDKCore extends ClientSDK {}

package/src/funcs/adminAdminControllerGetDashboard.ts

@@ -0,0 +1,139 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { SDKCore } from "../core.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKError } from "../models/errors/sdkerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Get admin dashboard summary
+ */
+export function adminAdminControllerGetDashboard(
+  client: SDKCore,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    void,
+    | SDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    options,
+  ));
+}
+
+async function $do(
+  client: SDKCore,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      void,
+      | SDKError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const path = pathToFunc("/api/v1/admin/dashboard")();
+
+  const headers = new Headers(compactMap({
+    Accept: "*/*",
+  }));
+
+  const secConfig = await extractSecurity(client._options.bearer);
+  const securityInput = secConfig == null ? {} : { bearer: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "AdminController_getDashboard",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.bearer,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "GET",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    errorCodes: ["401", "403", "4XX", "5XX"],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const [result] = await M.match<
+    void,
+    | SDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.nil(200, z.void()),
+    M.fail([401, 403, "4XX"]),
+    M.fail("5XX"),
+  )(response, req);
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}