lockally 0.2.0 → 0.3.1

data/spec/api/mailboxes_api_spec.rb

@@ -44,157 +44,157 @@ describe 'MailboxesApi' do
     end
   end
 
-  # unit tests for list_shared_members
-  # List shared mailbox members
-  # @param email 
+  # unit tests for create_mailbox
+  # Create a mailbox
+  # Creates a mailbox on a tenant-verified domain. If `password` is omitted, lockally generates a 16-char password and returns it in the response — shown once.  **Gate.** The mailbox's domain must already be registered AND verified for this tenant (via `/v1/domains` + `/v1/domains/{domain}/verify`).  **Idempotent.** Re-posting the same email returns the existing mailbox UNTOUCHED — password is NOT regenerated. To change a password, use PATCH instead. 
+  # @param create_mailbox_request 
   # @param [Hash] opts the optional parameters
-  # @return [ListSharedMembers200Response]
-  describe 'list_shared_members test' do
+  # @return [Mailbox]
+  describe 'create_mailbox test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for remove_shared_member
-  # Remove a shared mailbox member
+  # unit tests for delete_mailbox
+  # Soft-delete a mailbox
+  # Sets `soft_deleted_at = now()` and `hard_delete_after = now() + 90d` per design D25. A background sweep (planned) will hard-delete after the window. The mailbox is also disabled immediately. 
   # @param email 
-  # @param member_email 
   # @param [Hash] opts the optional parameters
   # @return [nil]
-  describe 'remove_shared_member test' do
+  describe 'delete_mailbox test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_mailboxes_email_delete
-  # Soft-delete a mailbox
-  # Sets `soft_deleted_at = now()` and `hard_delete_after = now() + 90d` per design D25. A background sweep (planned) will hard-delete after the window. The mailbox is also disabled immediately. 
+  # unit tests for delete_vacation_responder
+  # Remove the vacation responder
+  # Idempotent — 204 whether or not a row existed.
   # @param email 
   # @param [Hash] opts the optional parameters
   # @return [nil]
-  describe 'v1_mailboxes_email_delete test' do
+  describe 'delete_vacation_responder test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_mailboxes_email_export_download_get
+  # unit tests for download_mailbox_export
   # Download a previously-issued mailbox export
   # Public endpoint (no Authorization header). Validates the one-shot token from the URL, marks it used, and streams an mbox file. Second GET with the same token returns 404 — tokens are single-use. 
   # @param email 
   # @param token 
   # @param [Hash] opts the optional parameters
   # @return [File]
-  describe 'v1_mailboxes_email_export_download_get test' do
+  describe 'download_mailbox_export test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_mailboxes_email_export_post
+  # unit tests for export_mailbox
   # Request a mailbox export
   # Issues a one-shot \"presigned\" download URL for the mailbox's content in mbox format. The URL works without an Authorization header — the token in the query string is the authz. TTL is 5 minutes; the token is consumed on first GET.  **v1 caveat:** the synthesized mbox only contains outbound mail (from `lockally.messages`). v2 swaps in Stalwart's export primitive for full inbox + folder structure + flags. The endpoint contract stays unchanged.  **Scope changed:** this used to accept `mailboxes:read`. It takes any mailbox in the tenant and returns that mailbox's mail, so it now requires `tenant:admin`, matching `POST /v1/ediscovery/export`. A key scoped `mailboxes:read` gets 403 and has to be reissued; admin console sessions are unaffected. 
   # @param email 
   # @param [Hash] opts the optional parameters
-  # @return [V1MailboxesEmailExportPost201Response]
-  describe 'v1_mailboxes_email_export_post test' do
+  # @return [ExportMailbox201Response]
+  describe 'export_mailbox test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_mailboxes_email_get
+  # unit tests for get_mailbox
   # Get a mailbox
   # @param email 
   # @param [Hash] opts the optional parameters
   # @return [Mailbox]
-  describe 'v1_mailboxes_email_get test' do
+  describe 'get_mailbox test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_mailboxes_email_patch
-  # Update a mailbox
-  # Supply at least one of `password`, `quota_bytes`, `disabled`. Returns the updated mailbox. 
+  # unit tests for get_vacation_responder
+  # Get the vacation responder
+  # Returns the stored vacation rule or 404 if none is set.
   # @param email 
-  # @param v1_mailboxes_email_patch_request 
   # @param [Hash] opts the optional parameters
-  # @return [Mailbox]
-  describe 'v1_mailboxes_email_patch test' do
+  # @return [VacationResponder]
+  describe 'get_vacation_responder test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_mailboxes_email_vacation_delete
-  # Remove the vacation responder
-  # Idempotent — 204 whether or not a row existed.
-  # @param email 
+  # unit tests for list_mailboxes
+  # List mailboxes
+  # Returns mailboxes under the calling tenant — active and soft-deleted. `?limit=N` between 1 and 200 (default 50). 
   # @param [Hash] opts the optional parameters
-  # @return [nil]
-  describe 'v1_mailboxes_email_vacation_delete test' do
+  # @option opts [Integer] :limit 
+  # @return [ListMailboxes200Response]
+  describe 'list_mailboxes test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_mailboxes_email_vacation_get
-  # Get the vacation responder
-  # Returns the stored vacation rule or 404 if none is set.
+  # unit tests for list_shared_members
+  # List shared mailbox members
   # @param email 
   # @param [Hash] opts the optional parameters
-  # @return [VacationResponder]
-  describe 'v1_mailboxes_email_vacation_get test' do
+  # @return [ListSharedMembers200Response]
+  describe 'list_shared_members test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_mailboxes_email_vacation_put
-  # Set the vacation responder
-  # Upsert — same endpoint creates or replaces the rule. Clears `synced_at`; the rule is staged on lockally until a sync worker pushes it to the mail server. 
-  # @param email 
-  # @param v1_mailboxes_email_vacation_put_request 
+  # unit tests for list_vacation_responders
+  # List all vacation responders
+  # Returns every vacation responder for the calling tenant.
   # @param [Hash] opts the optional parameters
-  # @return [VacationResponder]
-  describe 'v1_mailboxes_email_vacation_put test' do
+  # @return [ListVacationResponders200Response]
+  describe 'list_vacation_responders test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_mailboxes_get
-  # List mailboxes
-  # Returns mailboxes under the calling tenant — active and soft-deleted. `?limit=N` between 1 and 200 (default 50). 
+  # unit tests for remove_shared_member
+  # Remove a shared mailbox member
+  # @param email 
+  # @param member_email 
   # @param [Hash] opts the optional parameters
-  # @option opts [Integer] :limit 
-  # @return [V1MailboxesGet200Response]
-  describe 'v1_mailboxes_get test' do
+  # @return [nil]
+  describe 'remove_shared_member test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_mailboxes_post
-  # Create a mailbox
-  # Creates a mailbox on a tenant-verified domain. If `password` is omitted, lockally generates a 16-char password and returns it in the response — shown once.  **Gate.** The mailbox's domain must already be registered AND verified for this tenant (via `/v1/domains` + `/v1/domains/{domain}/verify`).  **Idempotent.** Re-posting the same email returns the existing mailbox UNTOUCHED — password is NOT regenerated. To change a password, use PATCH instead. 
-  # @param v1_mailboxes_post_request 
+  # unit tests for set_vacation_responder
+  # Set the vacation responder
+  # Upsert — same endpoint creates or replaces the rule. Clears `synced_at`; the rule is staged on lockally until a sync worker pushes it to the mail server. 
+  # @param email 
+  # @param set_vacation_responder_request 
   # @param [Hash] opts the optional parameters
-  # @return [Mailbox]
-  describe 'v1_mailboxes_post test' do
+  # @return [VacationResponder]
+  describe 'set_vacation_responder test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_vacation_get
-  # List all vacation responders
-  # Returns every vacation responder for the calling tenant.
+  # unit tests for update_mailbox
+  # Update a mailbox
+  # Supply at least one of `password`, `quota_bytes`, `disabled`. Returns the updated mailbox. 
+  # @param email 
+  # @param update_mailbox_request 
   # @param [Hash] opts the optional parameters
-  # @return [V1VacationGet200Response]
-  describe 'v1_vacation_get test' do
+  # @return [Mailbox]
+  describe 'update_mailbox test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end

data/spec/api/send_api_spec.rb

@@ -32,47 +32,30 @@ describe 'SendApi' do
     end
   end
 
-  # unit tests for v1_messages_get
-  # List outbound messages
-  # Returns recent outbound messages for the calling tenant, sorted newest first. Backs the send-status pill in the SvelteKit /sends view and the outbound search box. 
-  # @param [Hash] opts the optional parameters
-  # @option opts [String] :status 
-  # @option opts [String] :sender Exact match against the `from` mailbox.
-  # @option opts [String] :q Free-text search across subject + sender.
-  # @option opts [Time] :since Only messages queued at or after this RFC 3339 instant.
-  # @option opts [String] :cursor queued_at of the prior page boundary. Pass back the `next_cursor` returned by the previous call.
-  # @option opts [Integer] :limit 
-  # @return [V1MessagesGet200Response]
-  describe 'v1_messages_get test' do
-    it 'should work' do
-      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
-    end
-  end
-
-  # unit tests for v1_messages_id_delete
+  # unit tests for cancel_message
   # Cancel a scheduled send
   # Cancels a still-scheduled message (future queued_at). Already sending/sent → 409.
   # @param id 
   # @param [Hash] opts the optional parameters
   # @return [nil]
-  describe 'v1_messages_id_delete test' do
+  describe 'cancel_message test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_messages_id_get
+  # unit tests for get_message
   # Get message status
   # @param id 
   # @param [Hash] opts the optional parameters
   # @return [MessageDetail]
-  describe 'v1_messages_id_get test' do
+  describe 'get_message test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_messages_stats_get
+  # unit tests for get_message_stats
   # Aggregate delivery stats
   # Counts by delivery outcome (delivered/bounced/deferred/complaint) plus rates over a window, from the delivery-event store. Privacy-first: this reflects what receiving servers reported, NOT whether a human opened the mail — Lockally does no open/click tracking. 
   # @param [Hash] opts the optional parameters
@@ -80,33 +63,50 @@ describe 'SendApi' do
   # @option opts [Time] :to Window end (default now).
   # @option opts [String] :domain Filter by sender domain.
   # @return [MessageStats]
-  describe 'v1_messages_stats_get test' do
+  describe 'get_message_stats test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_send_batch_post
-  # Send a batch of emails
-  # Sends up to 500 messages in one call. Each is validated and enqueued independently — a bad message fails only its own slot (partial success, HTTP 200). One `Idempotency-Key` header covers the batch; per-message keys are derived as `<key>:<index>`. 
-  # @param idempotency_key 
-  # @param v1_send_batch_post_request 
+  # unit tests for list_messages
+  # List outbound messages
+  # Returns recent outbound messages for the calling tenant, sorted newest first. Backs the send-status pill in the SvelteKit /sends view and the outbound search box. 
   # @param [Hash] opts the optional parameters
-  # @return [V1SendBatchPost200Response]
-  describe 'v1_send_batch_post test' do
+  # @option opts [String] :status 
+  # @option opts [String] :sender Exact match against the `from` mailbox.
+  # @option opts [String] :q Free-text search across subject + sender.
+  # @option opts [Time] :since Only messages queued at or after this RFC 3339 instant.
+  # @option opts [String] :cursor queued_at of the prior page boundary. Pass back the `next_cursor` returned by the previous call.
+  # @option opts [Integer] :limit 
+  # @return [ListMessages200Response]
+  describe 'list_messages test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_send_post
+  # unit tests for send_email
   # Send an email
-  # Submits an email for delivery via lockally. Returns 202 immediately once the message is accepted into lockally's queue; the actual SMTP submission to the recipient is async. Track delivery via `GET /v1/messages/{id}` or webhook subscriptions for `delivery.delivered` / `delivery.bounced` / `delivery.complaint`.  **Idempotency-Key required.** Per design L7 — any unique string per send, 24-hour dedupe window. Repeated calls with the same key return byte-exact the original response and do NOT create a duplicate message.  **Sender authorisation.** `from` must be a non-disabled mailbox owned by the calling tenant on a verified domain. Sending from aliases is not yet supported.  **Rate cap.** Per-tenant `rate_cap_per_min` (returned on `/v1/tenant`) is enforced — 429 with `Retry-After: 60` once tripped.  **Recipient warning.** Over 25 total recipients (To+Cc+Bcc) sets a `warning` field in the response — large fan-outs queue noticeably at scale. Hard cap is 100/send.  **Not every success is a 202.** Check the status code, not just the body. A `200` means nothing was queued: either every recipient was already suppressed, or the call used a test key and the send was simulated. Both are successes, and neither produces a real delivery. See the `200` response below.  **Warm-up headers.** While the platform is in its outbound warm-up ramp, accepted sends carry `X-Warmup-Day`, `X-Warmup-Daily-Cap` and `X-Warmup-Used-Today`. They describe a platform-wide cap shared by every tenant, not your own allowance, and they disappear once the ramp finishes. Hitting the cap returns 429. 
+  # Submits an email for delivery via lockally. Returns 202 immediately once the message is accepted into lockally's queue; the actual SMTP submission to the recipient is async. Track delivery via `GET /v1/messages/{id}` or webhook subscriptions for `delivery.delivered` / `delivery.bounced` / `delivery.complaint`.  **Idempotency-Key required.** Per design L7 — any unique string per send, 24-hour dedupe window. Repeated calls with the same key return byte-exact the original response and do NOT create a duplicate message.  **Sender authorisation.** `from` must be an address the calling tenant owns on a verified domain. A mailbox always qualifies. On business and combined accounts an **alias** qualifies too, so a send-only address such as `no-reply@` need not be a billed seat. An alias on an unverified domain, or one belonging to another account, is refused with `403`. A catch-all creates no aliases and so grants no sending rights.  **Rate cap.** Per-tenant `rate_cap_per_min` (returned on `/v1/tenant`) is enforced — 429 with `Retry-After: 60` once tripped.  **Recipient warning.** Over 25 total recipients (To+Cc+Bcc) sets a `warning` field in the response — large fan-outs queue noticeably at scale. Hard cap is 100/send.  **Not every success is a 202.** Check the status code, not just the body. A `200` means nothing was queued: either every recipient was already suppressed, or the call used a test key and the send was simulated. Both are successes, and neither produces a real delivery. See the `200` response below.  **Warm-up headers.** While the platform is in its outbound warm-up ramp, accepted sends carry `X-Warmup-Day`, `X-Warmup-Daily-Cap` and `X-Warmup-Used-Today`. They describe a platform-wide cap shared by every tenant, not your own allowance, and they disappear once the ramp finishes. Hitting the cap returns 429. 
+  # @param idempotency_key 
+  # @param send_email_request 
+  # @param [Hash] opts the optional parameters
+  # @return [SendEmail200Response]
+  describe 'send_email test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for send_email_batch
+  # Send a batch of emails
+  # Sends up to 500 messages in one call. Each is validated and enqueued independently — a bad message fails only its own slot (partial success, HTTP 200). One `Idempotency-Key` header covers the batch; per-message keys are derived as `<key>:<index>`. 
   # @param idempotency_key 
-  # @param v1_send_post_request 
+  # @param send_email_batch_request 
   # @param [Hash] opts the optional parameters
-  # @return [V1SendPost200Response]
-  describe 'v1_send_post test' do
+  # @return [SendEmailBatch200Response]
+  describe 'send_email_batch test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end

data/spec/api/signup_api_spec.rb

@@ -36,7 +36,7 @@ describe 'SignupApi' do
   # Sign up a new tenant
   # @param signup_request 
   # @param [Hash] opts the optional parameters
-  # @return [V1AdminLoginPost200Response]
+  # @return [AdminLogin200Response]
   describe 'signup test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/api/suppressions_api_spec.rb

@@ -32,47 +32,47 @@ describe 'SuppressionsApi' do
     end
   end
 
-  # unit tests for v1_suppressions_email_delete
+  # unit tests for create_suppression
+  # Add a suppression
+  # @param create_suppression_request 
+  # @param [Hash] opts the optional parameters
+  # @return [Suppression]
+  describe 'create_suppression test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for delete_suppression
   # Remove a suppression
   # @param email 
   # @param [Hash] opts the optional parameters
   # @return [nil]
-  describe 'v1_suppressions_email_delete test' do
+  describe 'delete_suppression test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_suppressions_email_get
+  # unit tests for get_suppression
   # Check whether an address is suppressed
   # @param email 
   # @param [Hash] opts the optional parameters
   # @return [Suppression]
-  describe 'v1_suppressions_email_get test' do
+  describe 'get_suppression test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_suppressions_get
+  # unit tests for list_suppressions
   # List suppressed recipients
   # @param [Hash] opts the optional parameters
   # @option opts [String] :reason 
   # @option opts [String] :cursor 
   # @option opts [Integer] :limit 
-  # @return [V1SuppressionsGet200Response]
-  describe 'v1_suppressions_get test' do
-    it 'should work' do
-      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
-    end
-  end
-
-  # unit tests for v1_suppressions_post
-  # Add a suppression
-  # @param v1_suppressions_post_request 
-  # @param [Hash] opts the optional parameters
-  # @return [Suppression]
-  describe 'v1_suppressions_post test' do
+  # @return [ListSuppressions200Response]
+  describe 'list_suppressions test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end

data/spec/api/templates_api_spec.rb

@@ -32,56 +32,56 @@ describe 'TemplatesApi' do
     end
   end
 
-  # unit tests for v1_templates_get
-  # List templates
+  # unit tests for create_template
+  # Create a template
+  # @param template_input 
   # @param [Hash] opts the optional parameters
-  # @return [V1TemplatesGet200Response]
-  describe 'v1_templates_get test' do
+  # @return [Template]
+  describe 'create_template test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_templates_id_delete
+  # unit tests for delete_template
   # Delete a template
   # @param id 
   # @param [Hash] opts the optional parameters
   # @return [nil]
-  describe 'v1_templates_id_delete test' do
+  describe 'delete_template test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_templates_id_get
+  # unit tests for get_template
   # Get a template
   # @param id 
   # @param [Hash] opts the optional parameters
   # @return [Template]
-  describe 'v1_templates_id_get test' do
+  describe 'get_template test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_templates_id_put
-  # Update a template
-  # @param id 
-  # @param template_input 
+  # unit tests for list_templates
+  # List templates
   # @param [Hash] opts the optional parameters
-  # @return [Template]
-  describe 'v1_templates_id_put test' do
+  # @return [ListTemplates200Response]
+  describe 'list_templates test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_templates_post
-  # Create a template
+  # unit tests for update_template
+  # Update a template
+  # @param id 
   # @param template_input 
   # @param [Hash] opts the optional parameters
   # @return [Template]
-  describe 'v1_templates_post test' do
+  describe 'update_template test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end

data/spec/api/tenant_api_spec.rb

@@ -32,23 +32,23 @@ describe 'TenantApi' do
     end
   end
 
-  # unit tests for v1_tenant_get
+  # unit tests for get_tenant
   # Get the calling tenant
   # Returns the tenant the presented API key belongs to.
   # @param [Hash] opts the optional parameters
   # @return [Tenant]
-  describe 'v1_tenant_get test' do
+  describe 'get_tenant test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_usage_get
+  # unit tests for get_usage
   # Usage snapshot
   # Returns the tenant's current usage + cap consumption. Designed for poll-based alerting on the integrator side (e.g. \"warn when daily quota is 80% used\"). Refreshed live from Postgres — there is no cache, so callers should poll at most once per minute. 
   # @param [Hash] opts the optional parameters
-  # @return [V1UsageGet200Response]
-  describe 'v1_usage_get test' do
+  # @return [GetUsage200Response]
+  describe 'get_usage test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end

data/spec/api/test_api_spec.rb

@@ -32,12 +32,12 @@ describe 'TestApi' do
     end
   end
 
-  # unit tests for v1_test_inbound_post
+  # unit tests for simulate_inbound_email
   # Simulate an inbound email (test keys only)
   # Runs a synthetic message through the REAL indexing pipeline — thread adoption, deterministic extraction (incl. injection_risk), and the message.received webhook — so the whole agent loop is testable without a real domain or MTA. Requires an lk_test_* key (create with {\"test\": true} on POST /v1/api-keys). Body: {mailbox, from, subject, text, in_reply_to?, references?}.
   # @param [Hash] opts the optional parameters
-  # @return [Object]
-  describe 'v1_test_inbound_post test' do
+  # @return [SimulatedInbound]
+  describe 'simulate_inbound_email test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end

data/spec/api/webhooks_api_spec.rb

@@ -32,49 +32,49 @@ describe 'WebhooksApi' do
     end
   end
 
-  # unit tests for v1_webhooks_get
-  # List webhooks
-  # Returns the calling tenant's webhook subscriptions. Never returns the signing secret — only metadata. 
+  # unit tests for create_webhook
+  # Create a webhook
+  # Subscribes a URL to one or more event types. Returns the `signing_secret` ONCE in the response — store it immediately. The dispatcher signs every outbound POST per design L3:      X-Lockally-Signature: t=<unix>,v1=<hex(hmac_sha256(secret, t + \".\" + body))>  Verify on your end using HMAC-SHA256 with a 5-minute timestamp window (replay protection). A reference verifier ships in [internal/webhook](https://github.com/ucheigwedinma/lockally/blob/main/internal/webhook/sign.go).  Event names: see the [event catalogue](https://github.com/ucheigwedinma/lockally/blob/main/docs/v1-design.md#64-webhook-event-catalogue-v1). 
+  # @param create_webhook_request 
   # @param [Hash] opts the optional parameters
-  # @return [V1WebhooksGet200Response]
-  describe 'v1_webhooks_get test' do
+  # @return [Webhook]
+  describe 'create_webhook test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_webhooks_id_delete
+  # unit tests for delete_webhook
   # Delete a webhook
   # Hard-delete; cascades to `webhook_deliveries` history.
   # @param id 
   # @param [Hash] opts the optional parameters
   # @return [nil]
-  describe 'v1_webhooks_id_delete test' do
+  describe 'delete_webhook test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_webhooks_id_patch
-  # Update a webhook
-  # Supply at least one of `url`, `events`, `paused`. Setting `paused` to `false` ALSO resets `consecutive_failures` to 0 — re-arms the 50-failure auto-pause counter. 
-  # @param id 
-  # @param v1_webhooks_id_patch_request 
+  # unit tests for list_webhooks
+  # List webhooks
+  # Returns the calling tenant's webhook subscriptions. Never returns the signing secret — only metadata. 
   # @param [Hash] opts the optional parameters
-  # @return [Webhook]
-  describe 'v1_webhooks_id_patch test' do
+  # @return [ListWebhooks200Response]
+  describe 'list_webhooks test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_webhooks_post
-  # Create a webhook
-  # Subscribes a URL to one or more event types. Returns the `signing_secret` ONCE in the response — store it immediately. The dispatcher signs every outbound POST per design L3:      X-Lockally-Signature: t=<unix>,v1=<hex(hmac_sha256(secret, t + \".\" + body))>  Verify on your end using HMAC-SHA256 with a 5-minute timestamp window (replay protection). A reference verifier ships in [internal/webhook](https://github.com/ucheigwedinma/lockally/blob/main/internal/webhook/sign.go).  Event names: see the [event catalogue](https://github.com/ucheigwedinma/lockally/blob/main/docs/v1-design.md#64-webhook-event-catalogue-v1). 
-  # @param v1_webhooks_post_request 
+  # unit tests for update_webhook
+  # Update a webhook
+  # Supply at least one of `url`, `events`, `paused`. Setting `paused` to `false` ALSO resets `consecutive_failures` to 0 — re-arms the 50-failure auto-pause counter. 
+  # @param id 
+  # @param update_webhook_request 
   # @param [Hash] opts the optional parameters
   # @return [Webhook]
-  describe 'v1_webhooks_post test' do
+  describe 'update_webhook test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end

data/spec/models/{v1_admin_login_post200_response_spec.rb → admin_login200_response_spec.rb}

@@ -14,16 +14,16 @@ require 'spec_helper'
 require 'json'
 require 'date'
 
-# Unit tests for Lockally::V1AdminLoginPost200Response
+# Unit tests for Lockally::AdminLogin200Response
 # Automatically generated by openapi-generator (https://openapi-generator.tech)
 # Please update as you see appropriate
-describe Lockally::V1AdminLoginPost200Response do
-  #let(:instance) { Lockally::V1AdminLoginPost200Response.new }
+describe Lockally::AdminLogin200Response do
+  #let(:instance) { Lockally::AdminLogin200Response.new }
 
-  describe 'test an instance of V1AdminLoginPost200Response' do
-    it 'should create an instance of V1AdminLoginPost200Response' do
+  describe 'test an instance of AdminLogin200Response' do
+    it 'should create an instance of AdminLogin200Response' do
       # uncomment below to test the instance creation
-      #expect(instance).to be_instance_of(Lockally::V1AdminLoginPost200Response)
+      #expect(instance).to be_instance_of(Lockally::AdminLogin200Response)
     end
   end