extension.yaml

name: firestore-typesense-search
version: 2.0.0
specVersion: v1beta # Firebase Extensions specification version (do not edit)

displayName: Search Firestore with Typesense
description: Indexes data from Firestore into Typesense for full-text search

license: Apache-2.0 # The license you want for the extension

author:
  authorName: Typesense
  url: https://typesense.org

sourceUrl: https://github.com/typesense/firebase-typesense-search-extension/tree/master
releaseNotesUrl: https://github.com/typesense/firestore-typesense-search/releases

billingRequired: true

resources:
  - name: indexOnWrite
    description: A function that indexes data into Typesense when it's triggered by Firestore changes
    type: firebaseextensions.v1beta.v2.function
    properties:
      sourceDirectory: functions
      buildConfig:
        runtime: nodejs18
      serviceConfig:
        timeout: 540s
      eventTrigger:
        eventType: google.cloud.firestore.document.v1.written
        triggerRegion: ${LOCATION}
        eventFilters:
          - attribute: database
            value: (default)
          - attribute: document
            value: ${FIRESTORE_COLLECTION_PATH}/{documentID}
            operator: match-path-pattern

  - name: backfill
    description: >-
      A function that backfills data from a Firestore collection into Typesense,
      triggered when a Firestore document with the path `typesense_sync/backfill` has the contents of `trigger: true`.
    type: firebaseextensions.v1beta.v2.function
    properties:
      buildConfig:
        runtime: nodejs18
      sourceDirectory: functions
      serviceConfig:
        timeout: 540s
        availableMemoryMb: 2048
      maxInstances: 1
      eventTrigger:
        eventType: google.cloud.firestore.document.v1.written
        triggerRegion: ${LOCATION}
        eventFilters:
          - attribute: database
            value: (default)
          - attribute: document
            value: typesense_sync/backfill
            operator: match-path-pattern

roles:
  - role: datastore.user
    reason: Required to backfill data from your Firestore collection into Typesense

externalServices:
  - name: Typesense Cloud
    PricingUri: https://cloud.typesense.org/pricing
  - name: Typesense Self Hosted (Free)
    PricingUri: https://typesense.org/downloads

params:
  - param: FIRESTORE_COLLECTION_PATH
    label: Firestore Collection Path
    description: >-
      The Firestore collection that needs to be indexed into Typesense.
    example: path/to/firestore_collection
    validationRegex: "^[^/]+(/[^/]+/[^/]+)*$"
    validationErrorMessage: Firestore collection paths must be an odd number of segments separated by slashes, e.g. "path/to/firestore_collection".
    default: path/to/firestore_collection
    required: true
    immutable: true
  - param: FIRESTORE_COLLECTION_FIELDS
    label: Firestore Collection Fields
    description: >-
      A comma separated list of fields that need to be indexed from each Firestore document. Leave blank to index all fields.
    example: field1,field2,field3
    default: ""
    required: false
  - param: TYPESENSE_HOSTS
    label: Typesense Hosts
    description: >-
      A comma-separated list of Typesense Hosts.
      For single node clusters, a single hostname is sufficient. For multi-node Highly Available or SDN Clusters,
      please be sure to mention all hostnames.
    example: xyz.a1.typesense.net,xyz-1.a1.typesense.net,xyz-2.a1.typesense.net,xyz-3.a1.typesense.net
    required: true
  - param: TYPESENSE_API_KEY
    label: Typesense API Key
    type: secret
    description: >-
      An Typesense API key with admin permissions.
      Click on "Generate API Key" in cluster dashboard in Typesense Cloud
    example: ""
    required: true
  - param: TYPESENSE_COLLECTION_NAME
    label: Typesense Collection Name
    description: >-
      Typesense collection name to index data into. This collection needs to exist before this extension is installed. Please create it via the Typesense Cloud dashboard or API.
    default: companies
    required: true
  - param: FLATTEN_NESTED_DOCUMENTS
    label: Flatten Nested Documents
    description: >-
      Should nested documents in Firestore be flattened by this extension before they are indexed in Typesense? 
      Set to "Yes" for Typesense versions 0.23.1 and earlier. Set to "No" for Typesense versions 0.24.0 and later.
    type: select
    options:
      - label: No
        value: false
      - label: Yes
        value: true
    default: false
    required: false
  - param: LOG_TYPESENSE_INSERTS
    label: Log Typesense Inserts for Debugging
    description: >-
      Should data inserted into Typesense be logged in Cloud Logging? This can be useful for debugging, but should not be enabled in production.
    type: select
    options:
      - label: No
        value: false
      - label: Yes
        value: true
    default: false
    required: false
  - param: LOCATION
    label: Cloud Functions location
    description: >-
      Where do you want to deploy the functions created for this extension?
      You usually want a location close to your database. For help selecting a
      location, refer to the [location selection
      guide](https://firebase.google.com/docs/functions/locations).
    type: select
    options:
      - label: Iowa (us-central1)
        value: us-central1
      - label: South Carolina (us-east1)
        value: us-east1
      - label: Northern Virginia (us-east4)
        value: us-east4
      - label: Warsaw (europe-central2)
        value: europe-central2
      - label: Los Angeles (us-west2)
        value: us-west2
      - label: Salt Lake City (us-west3)
        value: us-west3
      - label: Las Vegas (us-west4)
        value: us-west4
      - label: Warsaw (europe-central2)
        value: europe-central2
      - label: Belgium (europe-west1)
        value: europe-west1
      - label: London (europe-west2)
        value: europe-west2
      - label: Frankfurt (europe-west3)
        value: europe-west3
      - label: Zurich (europe-west6)
        value: europe-west6
      - label: Hong Kong (asia-east2)
        value: asia-east2
      - label: Tokyo (asia-northeast1)
        value: asia-northeast1
      - label: Osaka (asia-northeast2)
        value: asia-northeast2
      - label: Seoul (asia-northeast3)
        value: asia-northeast3
      - label: Mumbai (asia-south1)
        value: asia-south1
      - label: Singapore (asia-southeast1)
        value: asia-southeast1
      - label: Jakarta (asia-southeast2)
        value: asia-southeast2
      - label: Montreal (northamerica-northeast1)
        value: northamerica-northeast1
      - label: Sao Paulo (southamerica-east1)
        value: southamerica-east1
      - label: Sydney (australia-southeast1)
        value: australia-southeast1
    default: us-central1
    required: true
    immutable: true