cloudflare-d1 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7eb82310f834d6fd83eeb8b8e4052315bcdddc5b70fe894d98007c4bf7005d5f
+  data.tar.gz: 16c64ec2ec8950f765eb40b2b6a96ae6b58f773ed9ef3d52f144b246d8ef019f
+SHA512:
+  metadata.gz: 5f33ff459fc46e04ea5d144e90fbef6634d64be28aff140a1db19d004767d3e5c30e4e91ede644af8ef299a6a0475babd01d4524e1263a6b3065c21c1da2469b
+  data.tar.gz: b0274d888eab689656d4cbd1b3a4f96cd2ff4593a42c1fb4b7f03121f399785fc84070a1c55cc2aa01626cde43b8bc056b85f8401605a097cc402f055d5298ab

data/.claude/d1.yaml

@@ -0,0 +1,560 @@
+openapi: 3.0.0
+info:
+  title: Cloudflare D1 API
+  version: 1.0.0
+  description: Cloudflare D1 Database API for managing SQLite databases at the edge
+
+servers:
+  - url: https://api.cloudflare.com/client/v4
+    description: Cloudflare API v4
+
+security:
+  - api_token: []
+  - api_key: []
+
+components:
+  securitySchemes:
+    api_token:
+      type: http
+      scheme: bearer
+      description: API Token authentication
+    api_key:
+      type: apiKey
+      in: header
+      name: X-Auth-Key
+      description: API Key authentication (requires X-Auth-Email header)
+
+  schemas:
+    Database:
+      type: object
+      properties:
+        uuid:
+          type: string
+          format: uuid
+          description: Database unique identifier
+        name:
+          type: string
+          description: Database name
+        version:
+          type: string
+          description: Database version
+        created_at:
+          type: string
+          format: date-time
+          description: Creation timestamp
+        file_size:
+          type: integer
+          description: Database file size in bytes
+        num_tables:
+          type: integer
+          description: Number of tables in the database
+      required:
+        - name
+
+    DatabaseList:
+      type: object
+      properties:
+        result:
+          type: array
+          items:
+            $ref: "#/components/schemas/Database"
+        success:
+          type: boolean
+        errors:
+          type: array
+          items:
+            type: object
+        messages:
+          type: array
+          items:
+            type: object
+
+    CreateDatabaseRequest:
+      type: object
+      properties:
+        name:
+          type: string
+          description: Name for the new database
+      required:
+        - name
+
+    UpdateDatabaseRequest:
+      type: object
+      properties:
+        name:
+          type: string
+          description: New name for the database
+
+    QueryRequest:
+      type: object
+      properties:
+        sql:
+          type: string
+          description: SQL query to execute
+        params:
+          type: array
+          items: {}
+          description: Optional parameters for parameterized queries
+      required:
+        - sql
+
+    QueryResponse:
+      type: object
+      properties:
+        success:
+          type: boolean
+        result:
+          type: array
+          items:
+            type: object
+        meta:
+          type: object
+          properties:
+            changed_db:
+              type: boolean
+            changes:
+              type: integer
+            duration:
+              type: number
+            last_row_id:
+              type: integer
+            rows_read:
+              type: integer
+            rows_written:
+              type: integer
+            size_after:
+              type: integer
+        errors:
+          type: array
+          items:
+            type: object
+        messages:
+          type: array
+          items:
+            type: object
+
+    RawQueryResponse:
+      type: object
+      properties:
+        success:
+          type: boolean
+        result:
+          type: array
+          items:
+            type: array
+          description: Results as arrays instead of objects
+        meta:
+          type: object
+        errors:
+          type: array
+          items:
+            type: object
+        messages:
+          type: array
+          items:
+            type: object
+
+    ErrorResponse:
+      type: object
+      properties:
+        success:
+          type: boolean
+          example: false
+        errors:
+          type: array
+          items:
+            type: object
+            properties:
+              code:
+                type: integer
+              message:
+                type: string
+        messages:
+          type: array
+          items:
+            type: object
+        result:
+          nullable: true
+
+  parameters:
+    AccountId:
+      name: account_id
+      in: path
+      required: true
+      schema:
+        type: string
+      description: Cloudflare account identifier
+
+    DatabaseId:
+      name: database_id
+      in: path
+      required: true
+      schema:
+        type: string
+      description: Database identifier (UUID)
+
+paths:
+  /accounts/{account_id}/d1/database:
+    get:
+      summary: List Databases
+      description: Retrieve a list of all D1 databases in the account
+      operationId: listDatabases
+      tags:
+        - D1 Database
+      parameters:
+        - $ref: "#/components/parameters/AccountId"
+        - name: name
+          in: query
+          schema:
+            type: string
+          description: Filter databases by name
+        - name: page
+          in: query
+          schema:
+            type: integer
+            default: 1
+          description: Page number for pagination
+        - name: per_page
+          in: query
+          schema:
+            type: integer
+            default: 20
+            maximum: 100
+          description: Number of items per page
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/DatabaseList"
+        "400":
+          description: Bad request
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+        "401":
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+
+    post:
+      summary: Create Database
+      description: Create a new D1 database
+      operationId: createDatabase
+      tags:
+        - D1 Database
+      parameters:
+        - $ref: "#/components/parameters/AccountId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateDatabaseRequest"
+      responses:
+        "200":
+          description: Database created successfully
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  result:
+                    $ref: "#/components/schemas/Database"
+                  errors:
+                    type: array
+                    items:
+                      type: object
+                  messages:
+                    type: array
+                    items:
+                      type: object
+        "400":
+          description: Bad request
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+
+  /accounts/{account_id}/d1/database/{database_id}:
+    get:
+      summary: Get Database
+      description: Retrieve details of a specific D1 database
+      operationId: getDatabase
+      tags:
+        - D1 Database
+      parameters:
+        - $ref: "#/components/parameters/AccountId"
+        - $ref: "#/components/parameters/DatabaseId"
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  result:
+                    $ref: "#/components/schemas/Database"
+                  errors:
+                    type: array
+                    items:
+                      type: object
+                  messages:
+                    type: array
+                    items:
+                      type: object
+        "404":
+          description: Database not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+
+    put:
+      summary: Update Database
+      description: Update a D1 database (full update)
+      operationId: updateDatabase
+      tags:
+        - D1 Database
+      parameters:
+        - $ref: "#/components/parameters/AccountId"
+        - $ref: "#/components/parameters/DatabaseId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/UpdateDatabaseRequest"
+      responses:
+        "200":
+          description: Database updated successfully
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  result:
+                    $ref: "#/components/schemas/Database"
+
+    patch:
+      summary: Partial Update Database
+      description: Partially update a D1 database
+      operationId: patchDatabase
+      tags:
+        - D1 Database
+      parameters:
+        - $ref: "#/components/parameters/AccountId"
+        - $ref: "#/components/parameters/DatabaseId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/UpdateDatabaseRequest"
+      responses:
+        "200":
+          description: Database updated successfully
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  result:
+                    $ref: "#/components/schemas/Database"
+
+    delete:
+      summary: Delete Database
+      description: Delete a D1 database
+      operationId: deleteDatabase
+      tags:
+        - D1 Database
+      parameters:
+        - $ref: "#/components/parameters/AccountId"
+        - $ref: "#/components/parameters/DatabaseId"
+      responses:
+        "200":
+          description: Database deleted successfully
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  result:
+                    nullable: true
+        "404":
+          description: Database not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+
+  /accounts/{account_id}/d1/database/{database_id}/query:
+    post:
+      summary: Query Database
+      description: Execute SQL queries against a D1 database
+      operationId: queryDatabase
+      tags:
+        - D1 Database
+      parameters:
+        - $ref: "#/components/parameters/AccountId"
+        - $ref: "#/components/parameters/DatabaseId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/QueryRequest"
+            examples:
+              simple_query:
+                summary: Simple SELECT query
+                value:
+                  sql: "SELECT * FROM users"
+              parameterized_query:
+                summary: Parameterized query
+                value:
+                  sql: "SELECT * FROM users WHERE id = ?"
+                  params: [1]
+      responses:
+        "200":
+          description: Query executed successfully
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/QueryResponse"
+        "400":
+          description: Bad request or SQL error
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+
+  /accounts/{account_id}/d1/database/{database_id}/raw:
+    post:
+      summary: Raw Query Database
+      description: Execute SQL queries and return results as arrays instead of objects
+      operationId: rawQueryDatabase
+      tags:
+        - D1 Database
+      parameters:
+        - $ref: "#/components/parameters/AccountId"
+        - $ref: "#/components/parameters/DatabaseId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/QueryRequest"
+      responses:
+        "200":
+          description: Query executed successfully
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/RawQueryResponse"
+
+  /accounts/{account_id}/d1/database/{database_id}/export:
+    post:
+      summary: Export Database as SQL
+      description: Export the entire database as SQL dump
+      operationId: exportDatabase
+      tags:
+        - D1 Database
+      parameters:
+        - $ref: "#/components/parameters/AccountId"
+        - $ref: "#/components/parameters/DatabaseId"
+      requestBody:
+        required: false
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                output_format:
+                  type: string
+                  enum: [sql]
+                  default: sql
+      responses:
+        "200":
+          description: Export successful
+          content:
+            application/sql:
+              schema:
+                type: string
+                description: SQL dump of the database
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  result:
+                    type: string
+                    description: SQL dump content
+
+  /accounts/{account_id}/d1/database/{database_id}/import:
+    post:
+      summary: Import SQL into Database
+      description: Import SQL statements into a D1 database
+      operationId: importDatabase
+      tags:
+        - D1 Database
+      parameters:
+        - $ref: "#/components/parameters/AccountId"
+        - $ref: "#/components/parameters/DatabaseId"
+      requestBody:
+        required: true
+        content:
+          application/sql:
+            schema:
+              type: string
+              description: SQL statements to import
+          multipart/form-data:
+            schema:
+              type: object
+              properties:
+                file:
+                  type: string
+                  format: binary
+                  description: SQL file to import
+      responses:
+        "200":
+          description: Import successful
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  result:
+                    type: object
+                    properties:
+                      meta:
+                        type: object
+                      at_line:
+                        type: integer
+                      warnings:
+                        type: array
+                        items:
+                          type: string
+        "400":
+          description: Import failed
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"