Merge branch 'main' into Devon/Call-Flow-resource

Author: Devon-White

.cursor/rules/docs.mdc

@@ -61,7 +61,7 @@ description: "Brief page description" # for SEO
 - **Titles**: Avoid gerunds in titles when practical ('Install package' rather than 'Installing the package')
 - **Sentence case**: Apply sentence case to card titles, tab titles, and pseudo-headers
 - **Pseudo-headers**: Titles made with simple bolded text (either on their own line or in lists with colons) should use sentence case
-- **Semantic line breaks**: Follow the SemBr specification by putting line breaks 
+- **Semantic line breaks**: Follow the SemBr specification by putting line breaks before and after major clauses. Links should occupy their own complete line. 
 
 ### Header formatting
 - Use sentence case for all headers (capitalize only the first word and proper nouns)
@@ -159,6 +159,15 @@ export const products = [
 - Provide alt text for custom images
 - Ensure proper focus management for interactive elements
 
+## Development and build commands
+
+### Package manager
+**This project uses Yarn, not npm.** Always use `yarn` for all package management commands.
+- Build: `yarn --cwd website build`
+- Develop: `yarn --cwd website start` (for local preview)
+- Install: `yarn install`
+- Do NOT use: `npm install`, `npm run`, `npx` - use `yarn` equivalents instead
+
 ## Quality assurance
 
 ### Content review checklist

.github/PULL_REQUEST_TEMPLATE/other.md

@@ -38,7 +38,7 @@ Why is this change required? What problem does it solve?
 
 ## Checklist:
 
-- [ ] My changes follow the [style guidelines](https://github.com/signalwire/signalwire-docs/wiki/Style-Guidelines) of this project
+- [ ] My changes follow the [style guidelines](https://github.com/signalwire/docs/wiki/Written-Style-Guide) of this project
 - [ ] I have performed a self-review of my changes
 - [ ] My changes generate no new warnings
 - [ ] Builds successfully locally 

.github/PULL_REQUEST_TEMPLATE/rest_api_update.md

@@ -19,8 +19,8 @@ Why is this change required? What problem does it solve?
 
 ## Checklist:
 
-- [ ] I have read and fully understand the [process for updating the REST API](https://github.com/signalwire/signalwire-docs/wiki/REST-API-Specs-&-Docs) 
-- [ ] [Mandatory fields](https://github.com/signalwire/signalwire-docs/wiki/REST-API-Specs-&-Docs#documentation-required-decorators) are present in the TypeSpec files.
+- [ ] I have read and fully understand the [process for updating the REST API](https://github.com/signalwire/docs/wiki/REST-API-Specs-&-Docs) 
+- [ ] [Mandatory fields](https://github.com/signalwire/docs/wiki/REST-API-Specs-&-Docs#documentation-required-decorators) are present in the TypeSpec files.
 - [ ] TypeSpec files successfully compiled OpenAPI spec files.
   - [ ] No new warnings were generated during the compilation process. 
 - [ ] OpenAPI spec files were validated with a SWAGGER UI tool to ensure they are correct.

.github/PULL_REQUEST_TEMPLATE/updating_docs.md

@@ -23,7 +23,7 @@ Why is this change required? What problem does it solve?
 
 ## Checklist:
 
-- [ ] My documentation follows the [style guidelines](https://github.com/signalwire/signalwire-docs/wiki/Style-Guidelines) of this project
+- [ ] My documentation follows the [style guidelines](https://github.com/signalwire/docs/wiki/Written-Style-Guide) of this project
 - [ ] I have performed a self-review of my documentation
 - [ ] My changes generate no new warnings
 - [ ] Builds successfully locally

.gitignore

@@ -23,6 +23,7 @@ specs/tsp-output
 .cursorignore
 temp
 .env
+.vscode
 
 npm-debug.log*
 yarn-debug.log*

Dockerfile

@@ -19,7 +19,7 @@ COPY website ./website
 COPY specs ./specs
 COPY tools ./tools
 
-# Install dependencies and run postinstall (builds specs and website)
+# Install dependencies and run postinstall (builds specs)
 RUN yarn install --frozen-lockfile
 
 # Build the website
@@ -34,4 +34,7 @@ COPY --from=builder /app/website/provisioning/nginx/nginx.conf /etc/nginx/nginx.
 COPY --from=builder /app/website/provisioning/nginx/redirects.map /etc/nginx/redirects.map
 COPY --from=builder /app/website/build/ /usr/share/nginx/html
 
+# Test nginx configuration
+RUN nginx -t
+
 EXPOSE 80

specs/compatibility-api/_spec_.yaml

@@ -6559,6 +6559,304 @@ paths:
       responses:
         '204':
           $ref: '#/components/responses/204'
+  /Accounts/{AccountSid}/ImportedPhoneNumbers:
+    post:
+      parameters:
+        - name: AccountSid
+          in: path
+          description: >-
+            The unique identifier for the account that is associated with this
+            phone number.
+          required: true
+          schema:
+            type: string
+            format: uuid
+      operationId: create_imported_phone_number
+      summary: Import a Phone Number
+      description: >
+        Import a phone number hosted elsewhere into your SignalWire Space.
+
+        **Note:** This is a **Partner API**. To enable it on your SignalWire Space, contact 
+        [Sales](https://signalwire.com/company/contact?utm_campaign=devex_sent_em).
+
+        #### Permissions
+
+        The API token must include the following scopes: _Numbers_.
+      tags:
+        - Imported Phone Numbers
+      requestBody:
+        content:
+          application/x-www-form-urlencoded:
+            schema:
+              type: object
+              required:
+                - number
+                - number_type
+              properties:
+                number:
+                  type: string
+                  description: >-
+                    The phone number to import in E.164 format. Number must be
+                    between 5 and 30 characters with no special characters
+                    besides a leading `+`.
+                  example: '+49152234333323'
+                  minLength: 5
+                  maxLength: 30
+                number_type:
+                  type: string
+                  description: The type of phone number being imported.
+                  enum:
+                    - longcode
+                    - tollfree
+                  example: longcode
+                capabilities:
+                  type: array
+                  description: >-
+                    The capabilities to enable for this phone number. Can
+                    include any combination of SMS, Voice, Fax, and MMS. If not
+                    provided, defaults to all capabilities (SMS, Voice, Fax,
+                    and MMS). Cannot be an empty array.
+                  items:
+                    type: string
+                    enum:
+                      - sms
+                      - voice
+                      - fax
+                      - mms
+                  example: ['sms', 'fax']
+      responses:
+        '201':
+          description: Created
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  sid:
+                    type: string
+                    description: The unique identifier for this phone number.
+                    example: b3877c40-da60-4998-90ad-b792e98472pn
+                  account_id:
+                    type: string
+                    format: uuid
+                    description: >-
+                      The unique identifier for the account that is associated
+                      with this phone number.
+                    example: b3877c40-da60-4998-90ad-b792e98472ac
+                  account_sid:
+                    type: string
+                    format: uuid
+                    description: >-
+                      The unique identifier for the account that is associated
+                      with this phone number.
+                    example: b3877c40-da60-4998-90ad-b792e98472ac
+                  friendly_name:
+                    type: string
+                    nullable: true
+                    description: A formatted version of the number.
+                    example: null
+                  phone_number:
+                    type: string
+                    description: The phone number in E.164 format.
+                    example: '+49152234333323'
+                  voice_url:
+                    type: string
+                    nullable: true
+                    description: The URL to request when an incoming call is received.
+                    example: null
+                  voice_method:
+                    type: string
+                    nullable: true
+                    description: >-
+                      Whether the request to voice_url is a GET or a POST.
+                    example: null
+                  voice_fallback_url:
+                    type: string
+                    nullable: true
+                    description: The URL to request if errors occur when fetching voice_url.
+                    example: null
+                  voice_fallback_method:
+                    type: string
+                    nullable: true
+                    description: >-
+                      Whether the request to voice_fallback_url is a GET or a POST.
+                    example: null
+                  status_callback:
+                    type: string
+                    nullable: true
+                    description: The URL to request to pass status updates to.
+                    example: null
+                  status_callback_method:
+                    type: string
+                    nullable: true
+                    description: >-
+                      Whether the request to status_callback is a GET or a POST.
+                    example: null
+                  voice_application_sid:
+                    type: string
+                    nullable: true
+                    description: >-
+                      The unique identifier for the application associated with
+                      call handling on this phone number.
+                    example: null
+                  voice_caller_id_lookup:
+                    type: boolean
+                    nullable: true
+                    description: Whether or not to look up a caller's name in the database.
+                    example: null
+                  sms_url:
+                    type: string
+                    nullable: true
+                    description: The URL to request when an incoming SMS is received.
+                    example: null
+                  sms_method:
+                    type: string
+                    nullable: true
+                    description: >-
+                      Whether the request to sms_url is a GET or a POST.
+                    example: null
+                  sms_fallback_url:
+                    type: string
+                    nullable: true
+                    description: The URL to request if errors occur when fetching sms_url.
+                    example: null
+                  sms_fallback_method:
+                    type: string
+                    nullable: true
+                    description: >-
+                      Whether the request to sms_fallback_url is a GET or a POST.
+                    example: null
+                  sms_application_sid:
+                    type: string
+                    nullable: true
+                    description: >-
+                      The unique identifier for the application associated with
+                      SMS handling on this phone number.
+                    example: null
+                  date_created:
+                    type: string
+                    description: >-
+                      The date, in RFC 2822 format, this phone number was
+                      created.
+                    example: 'Thu, 28 Sep 2023 17:58:29 +0000'
+                  date_updated:
+                    type: string
+                    description: >-
+                      The date, in RFC 2822 format, this phone number was
+                      updated.
+                    example: 'Thu, 28 Sep 2023 17:58:29 +0000'
+                  capabilities:
+                    type: object
+                    description: Whether or not a number can receive calls and messages.
+                    properties:
+                      voice:
+                        type: boolean
+                        example: false
+                      sms:
+                        type: boolean
+                        example: true
+                      mms:
+                        type: boolean
+                        example: false
+                      fax:
+                        type: boolean
+                        example: true
+                  beta:
+                    type: boolean
+                    description: New numbers on SignalWire are marked as beta.
+                    example: false
+                  api_version:
+                    type: string
+                    description: The version of the SignalWire API.
+                    example: '2010-04-01'
+                  uri:
+                    type: string
+                    description: The URI for this number.
+                    example: >-
+                      /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472ac/IncomingPhoneNumbers/16db4a36-8a97-4e10-98c5-58daafac95f9
+                  address_requirements:
+                    type: string
+                    description: >-
+                      Whether or not a registered address with SignalWire is
+                      required.
+                    enum:
+                      - none
+                      - any
+                      - local
+                      - foreign
+                    example: none
+                  address_sid:
+                    type: string
+                    nullable: true
+                    description: >-
+                      The unique identifier for the address associated with this
+                      phone number.
+                    example: null
+                  identity_sid:
+                    type: string
+                    nullable: true
+                    description: >-
+                      The unique identifier for the identity associated with
+                      this phone number.
+                    example: null
+                  trunk_sid:
+                    type: string
+                    nullable: true
+                    description: >-
+                      The unique identifier for the Trunk associated with this
+                      phone number.
+                    example: null
+                  origin:
+                    type: string
+                    description: >-
+                      The origin of the phone number. SignalWire numbers are
+                      denoted as signalwire while hosted numbers are denoted
+                      as hosted.
+                    example: signalwire
+                  emergency_address_sid:
+                    type: string
+                    nullable: true
+                    description: >-
+                      The unique identifier of the address associated with E911
+                      for this phone number.
+                    example: null
+                  emergency_status:
+                    type: string
+                    description: >-
+                      Whether the phone route has an active E911 address
+                      associated.
+                    enum:
+                      - Active
+                      - Inactive
+                    example: Inactive
+                  country_code:
+                    type: string
+                    nullable: true
+                    description: The country code for this phone number.
+                    example: null
+        '422':
+          description: Unprocessable Entity
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  code:
+                    type: string
+                    description: The error code.
+                    example: '10000'
+                  message:
+                    type: string
+                    description: A human-readable error message.
+                    example: "Number type can't be blank"
+                  more_info:
+                    type: string
+                    description: A URL to more information about the error.
+                    example: 'https://developer.signalwire.com/compatibility-api/reference/error-codes'
+                  status:
+                    type: integer
+                    description: The HTTP status code.
+                    example: 400
   /Accounts/{AccountSid}/LamlBins:
     get:
       parameters:

specs/signalwire-rest/calling-api/calls/const.tsp

@@ -0,0 +1 @@
+import "../../_globally_shared/const.tsp";