lockally 0.1.0

data/spec/api/mailboxes_api_spec.rb

@@ -0,0 +1,203 @@
+=begin
+#lockally control plane
+
+#The lockally control plane lets integrators and direct customers manage everything except actual mail data flow (which uses standard JMAP / IMAP / SMTP-submission against the data plane endpoints).  **Authentication.** All `/v1/*` endpoints require a Bearer API key in the `Authorization` header. Keys are formatted `lk_live_<8-char-prefix>_<32-char-secret>`. Generate the first key for a tenant via `cmd/seed`; subsequent keys via `POST /v1/api-keys`.  **Errors.** Failures return [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457) `application/problem+json` documents.  **Scopes.** Each endpoint requires a specific scope on the presented key. Insufficient scope returns `403` with the required scope name in `detail`. 
+
+The version of the OpenAPI document: 0.1.0
+Contact: support@lockally.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for Lockally::MailboxesApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'MailboxesApi' do
+  before do
+    # run before each test
+    @api_instance = Lockally::MailboxesApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of MailboxesApi' do
+    it 'should create an instance of MailboxesApi' do
+      expect(@api_instance).to be_instance_of(Lockally::MailboxesApi)
+    end
+  end
+
+  # unit tests for add_shared_member
+  # Add a shared mailbox member
+  # @param email 
+  # @param add_shared_member_request 
+  # @param [Hash] opts the optional parameters
+  # @return [SharedMember]
+  describe 'add_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 list_shared_members
+  # List shared mailbox members
+  # @param email 
+  # @param [Hash] opts the optional parameters
+  # @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 remove_shared_member
+  # Remove a shared mailbox member
+  # @param email 
+  # @param member_email 
+  # @param [Hash] opts the optional parameters
+  # @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_email_delete
+  # Soft-delete a mailbox
+  # Sets &#x60;soft_deleted_at &#x3D; now()&#x60; and &#x60;hard_delete_after &#x3D; now() + 90d&#x60; per design D25. A background sweep (planned) will hard-delete after the window. The mailbox is also disabled immediately. 
+  # @param email 
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'v1_mailboxes_email_delete 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
+  # 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
+    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
+  # Request a mailbox export
+  # Issues a one-shot \&quot;presigned\&quot; download URL for the mailbox&#39;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 &#x60;lockally.messages&#x60;). v2 swaps in Stalwart&#39;s export primitive for full inbox + folder structure + flags. The endpoint contract stays unchanged. 
+  # @param email 
+  # @param [Hash] opts the optional parameters
+  # @return [V1MailboxesEmailExportPost201Response]
+  describe 'v1_mailboxes_email_export_post 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
+  # Get a mailbox
+  # @param email 
+  # @param [Hash] opts the optional parameters
+  # @return [Mailbox]
+  describe 'v1_mailboxes_email_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_mailboxes_email_patch
+  # Update a mailbox
+  # Supply at least one of &#x60;password&#x60;, &#x60;quota_bytes&#x60;, &#x60;disabled&#x60;. Returns the updated mailbox. 
+  # @param email 
+  # @param v1_mailboxes_email_patch_request 
+  # @param [Hash] opts the optional parameters
+  # @return [Mailbox]
+  describe 'v1_mailboxes_email_patch 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 
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'v1_mailboxes_email_vacation_delete 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.
+  # @param email 
+  # @param [Hash] opts the optional parameters
+  # @return [VacationResponder]
+  describe 'v1_mailboxes_email_vacation_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_mailboxes_email_vacation_put
+  # Set the vacation responder
+  # Upsert — same endpoint creates or replaces the rule. Clears &#x60;synced_at&#x60;; 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 
+  # @param [Hash] opts the optional parameters
+  # @return [VacationResponder]
+  describe 'v1_mailboxes_email_vacation_put 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. &#x60;?limit&#x3D;N&#x60; between 1 and 200 (default 50). 
+  # @param [Hash] opts the optional parameters
+  # @option opts [Integer] :limit 
+  # @return [V1MailboxesGet200Response]
+  describe 'v1_mailboxes_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_mailboxes_post
+  # Create a mailbox
+  # Creates a mailbox on a tenant-verified domain. If &#x60;password&#x60; is omitted, lockally generates a 16-char password and returns it in the response — shown once.  **Gate.** The mailbox&#39;s domain must already be registered AND verified for this tenant (via &#x60;/v1/domains&#x60; + &#x60;/v1/domains/{domain}/verify&#x60;).  **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 
+  # @param [Hash] opts the optional parameters
+  # @return [Mailbox]
+  describe 'v1_mailboxes_post 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.
+  # @param [Hash] opts the optional parameters
+  # @return [V1VacationGet200Response]
+  describe 'v1_vacation_get test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/api/migrations_api_spec.rb

@@ -0,0 +1,268 @@
+=begin
+#lockally control plane
+
+#The lockally control plane lets integrators and direct customers manage everything except actual mail data flow (which uses standard JMAP / IMAP / SMTP-submission against the data plane endpoints).  **Authentication.** All `/v1/*` endpoints require a Bearer API key in the `Authorization` header. Keys are formatted `lk_live_<8-char-prefix>_<32-char-secret>`. Generate the first key for a tenant via `cmd/seed`; subsequent keys via `POST /v1/api-keys`.  **Errors.** Failures return [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457) `application/problem+json` documents.  **Scopes.** Each endpoint requires a specific scope on the presented key. Insufficient scope returns `403` with the required scope name in `detail`. 
+
+The version of the OpenAPI document: 0.1.0
+Contact: support@lockally.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for Lockally::MigrationsApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'MigrationsApi' do
+  before do
+    # run before each test
+    @api_instance = Lockally::MigrationsApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of MigrationsApi' do
+    it 'should create an instance of MigrationsApi' do
+      expect(@api_instance).to be_instance_of(Lockally::MigrationsApi)
+    end
+  end
+
+  # unit tests for cancel_migration
+  # Cancel a running migration
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [DiscoverMigration202Response]
+  describe 'cancel_migration 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 check_migration_dns
+  # Check DNS readiness for cutover
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [Object]
+  describe 'check_migration_dns 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 create_migration
+  # Create a migration
+  # @param create_migration_request 
+  # @param [Hash] opts the optional parameters
+  # @return [Migration]
+  describe 'create_migration 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 create_migration_credential
+  # Store a migration credential
+  # @param create_migration_credential_request 
+  # @param [Hash] opts the optional parameters
+  # @return [MigrationCredential]
+  describe 'create_migration_credential 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_migration
+  # Delete a migration
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'delete_migration 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_migration_credential
+  # Delete a migration credential
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'delete_migration_credential 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 delta_sync_migration
+  # Run a delta sync
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [StartMigration202Response]
+  describe 'delta_sync_migration 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 discover_migration
+  # Discover source mailboxes
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [DiscoverMigration202Response]
+  describe 'discover_migration 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 final_sync_migration
+  # Run the final sync before cutover
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [StartMigration202Response]
+  describe 'final_sync_migration 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 get_migration
+  # Get a migration
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [Migration]
+  describe 'get_migration 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 get_migration_progress
+  # Get migration progress
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [MigrationProgress]
+  describe 'get_migration_progress 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 list_migration_credentials
+  # List migration credentials
+  # @param [Hash] opts the optional parameters
+  # @return [ListMigrationCredentials200Response]
+  describe 'list_migration_credentials 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 list_migration_events
+  # List migration events
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [ListMigrationEvents200Response]
+  describe 'list_migration_events 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 list_migration_mailboxes
+  # List migration mailboxes
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [ListMigrationMailboxes200Response]
+  describe 'list_migration_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 list_migrations
+  # List migrations
+  # @param [Hash] opts the optional parameters
+  # @return [ListMigrations200Response]
+  describe 'list_migrations 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 map_migration
+  # Map source to destination mailboxes
+  # @param id 
+  # @param map_migration_request 
+  # @param [Hash] opts the optional parameters
+  # @return [DiscoverMigration202Response]
+  describe 'map_migration 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 retry_migration
+  # Retry a failed or cancelled migration
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [DiscoverMigration202Response]
+  describe 'retry_migration 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 start_migration
+  # Start the migration
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [StartMigration202Response]
+  describe 'start_migration 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 update_migration
+  # Update a migration
+  # @param id 
+  # @param update_migration_request 
+  # @param [Hash] opts the optional parameters
+  # @return [Migration]
+  describe 'update_migration 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 update_migration_mailbox
+  # Update a migration mailbox
+  # @param id 
+  # @param mbx_id 
+  # @param update_migration_mailbox_request 
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'update_migration_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 validate_migration
+  # Validate migrated data
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [StartMigration202Response]
+  describe 'validate_migration test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/api/resources_api_spec.rb

@@ -0,0 +1,90 @@
+=begin
+#lockally control plane
+
+#The lockally control plane lets integrators and direct customers manage everything except actual mail data flow (which uses standard JMAP / IMAP / SMTP-submission against the data plane endpoints).  **Authentication.** All `/v1/*` endpoints require a Bearer API key in the `Authorization` header. Keys are formatted `lk_live_<8-char-prefix>_<32-char-secret>`. Generate the first key for a tenant via `cmd/seed`; subsequent keys via `POST /v1/api-keys`.  **Errors.** Failures return [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457) `application/problem+json` documents.  **Scopes.** Each endpoint requires a specific scope on the presented key. Insufficient scope returns `403` with the required scope name in `detail`. 
+
+The version of the OpenAPI document: 0.1.0
+Contact: support@lockally.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for Lockally::ResourcesApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'ResourcesApi' do
+  before do
+    # run before each test
+    @api_instance = Lockally::ResourcesApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of ResourcesApi' do
+    it 'should create an instance of ResourcesApi' do
+      expect(@api_instance).to be_instance_of(Lockally::ResourcesApi)
+    end
+  end
+
+  # unit tests for create_resource
+  # Create a resource
+  # @param create_resource_request 
+  # @param [Hash] opts the optional parameters
+  # @return [Resource]
+  describe 'create_resource 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_resource
+  # Delete a resource
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'delete_resource 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 get_resource
+  # Get a resource
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [Resource]
+  describe 'get_resource 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 list_resources
+  # List resources
+  # @param [Hash] opts the optional parameters
+  # @return [ListResources200Response]
+  describe 'list_resources 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 update_resource
+  # Update a resource
+  # @param id 
+  # @param update_resource_request 
+  # @param [Hash] opts the optional parameters
+  # @return [Resource]
+  describe 'update_resource test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/api/send_api_spec.rb

@@ -0,0 +1,115 @@
+=begin
+#lockally control plane
+
+#The lockally control plane lets integrators and direct customers manage everything except actual mail data flow (which uses standard JMAP / IMAP / SMTP-submission against the data plane endpoints).  **Authentication.** All `/v1/*` endpoints require a Bearer API key in the `Authorization` header. Keys are formatted `lk_live_<8-char-prefix>_<32-char-secret>`. Generate the first key for a tenant via `cmd/seed`; subsequent keys via `POST /v1/api-keys`.  **Errors.** Failures return [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457) `application/problem+json` documents.  **Scopes.** Each endpoint requires a specific scope on the presented key. Insufficient scope returns `403` with the required scope name in `detail`. 
+
+The version of the OpenAPI document: 0.1.0
+Contact: support@lockally.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for Lockally::SendApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'SendApi' do
+  before do
+    # run before each test
+    @api_instance = Lockally::SendApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of SendApi' do
+    it 'should create an instance of SendApi' do
+      expect(@api_instance).to be_instance_of(Lockally::SendApi)
+    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 &#x60;from&#x60; 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 &#x60;next_cursor&#x60; 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
+  # 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
+    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
+  # Get message status
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [Message]
+  describe 'v1_messages_id_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_stats_get
+  # 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
+  # @option opts [Time] :from Window start (default 7 days ago).
+  # @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
+    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 &#x60;Idempotency-Key&#x60; header covers the batch; per-message keys are derived as &#x60;&lt;key&gt;:&lt;index&gt;&#x60;. 
+  # @param idempotency_key 
+  # @param v1_send_batch_post_request 
+  # @param [Hash] opts the optional parameters
+  # @return [V1SendBatchPost200Response]
+  describe 'v1_send_batch_post 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
+  # Send an email
+  # Submits an email for delivery via lockally. Returns 202 immediately once the message is accepted into lockally&#39;s queue; the actual SMTP submission to the recipient is async. Track delivery via &#x60;GET /v1/messages/{id}&#x60; or webhook subscriptions for &#x60;delivery.delivered&#x60; / &#x60;delivery.bounced&#x60; / &#x60;delivery.complaint&#x60;.  **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.** &#x60;from&#x60; 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 &#x60;rate_cap_per_min&#x60; (returned on &#x60;/v1/tenant&#x60;) is enforced — 429 with &#x60;Retry-After: 60&#x60; once tripped.  **Recipient warning.** Over 25 total recipients (To+Cc+Bcc) sets a &#x60;warning&#x60; field in the response — large fan-outs queue noticeably at scale. Hard cap is 100/send. 
+  # @param idempotency_key 
+  # @param v1_send_post_request 
+  # @param [Hash] opts the optional parameters
+  # @return [V1SendPost202Response]
+  describe 'v1_send_post test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end