@streetlevel/api-clients 1.0.1

package/BUILD.bazel

@@ -0,0 +1,118 @@
+load(":openapi_ts.bzl", "openapi_ts_client")
+
+# ============================================================================
+# Generate TypeScript clients from OpenAPI specs
+# ============================================================================
+
+# Ad API Client
+openapi_ts_client(
+    name = "ad_client_generated",
+    spec = "@api-contracts//:specs/ad/ad.openapi.yaml",
+)
+
+# Ad Request API Client
+openapi_ts_client(
+    name = "adrequest_client_generated",
+    spec = "@api-contracts//:specs/adrequest/adrequest.openapi.yaml",
+)
+
+# Ad Set API Client
+openapi_ts_client(
+    name = "adset_client_generated",
+    spec = "@api-contracts//:specs/adset/adset.openapi.yaml",
+)
+
+# Campaign API Client
+openapi_ts_client(
+    name = "campaign_client_generated",
+    spec = "@api-contracts//:specs/campaign/campaign.openapi.yaml",
+)
+
+# Car API Client
+openapi_ts_client(
+    name = "car_client_generated",
+    spec = "@api-contracts//:specs/car/car.openapi.yaml",
+)
+
+# Car Supplier API Client
+openapi_ts_client(
+    name = "carsupplier_client_generated",
+    spec = "@api-contracts//:specs/carsupplier/carsupplier.openapi.yaml",
+)
+
+# Client API Client
+openapi_ts_client(
+    name = "client_client_generated",
+    spec = "@api-contracts//:specs/client/client.openapi.yaml",
+)
+
+# Client Zone API Client
+openapi_ts_client(
+    name = "clientzone_client_generated",
+    spec = "@api-contracts//:specs/clientzone/clientzone.openapi.yaml",
+)
+
+# Device API Client
+openapi_ts_client(
+    name = "device_client_generated",
+    spec = "@api-contracts//:specs/device/device.openapi.yaml",
+)
+
+# Document API Client
+openapi_ts_client(
+    name = "document_client_generated",
+    spec = "@api-contracts//:specs/document/document.openapi.yaml",
+)
+
+# Playlist API Client
+openapi_ts_client(
+    name = "playlist_client_generated",
+    spec = "@api-contracts//:specs/playlist/playlist.openapi.yaml",
+)
+
+# Rate API Client
+openapi_ts_client(
+    name = "rate_client_generated",
+    spec = "@api-contracts//:specs/rate/rate.openapi.yaml",
+)
+
+# Settings API Client
+openapi_ts_client(
+    name = "settings_client_generated",
+    spec = "@api-contracts//:specs/settings/settings.openapi.yaml",
+)
+
+# Zone API Client
+openapi_ts_client(
+    name = "zone_client_generated",
+    spec = "@api-contracts//:specs/zone/zone.openapi.yaml",
+)
+
+# ============================================================================
+# Unified TypeScript Client Library
+# ============================================================================
+
+# Export all generated files for consumers
+filegroup(
+    name = "api_clients",
+    srcs = [
+        ":ad_client_generated",
+        ":adrequest_client_generated",
+        ":adset_client_generated",
+        ":campaign_client_generated",
+        ":car_client_generated",
+        ":carsupplier_client_generated",
+        ":client_client_generated",
+        ":clientzone_client_generated",
+        ":device_client_generated",
+        ":document_client_generated",
+        ":playlist_client_generated",
+        ":rate_client_generated",
+        ":settings_client_generated",
+        ":zone_client_generated",
+    ],
+    visibility = ["//visibility:public"],
+)
+
+# Export individual clients for selective imports
+exports_files(["src/index.ts"])

package/generate.sh

@@ -0,0 +1,91 @@
+#!/bin/bash
+set -e
+
+# Generate TypeScript clients from OpenAPI specs
+# Usage: npm run generate
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+API_CONTRACTS_DIR="${SCRIPT_DIR}/../api-contracts/specs"
+OUTPUT_DIR="${SCRIPT_DIR}/src/generated"
+INDEX_FILE="${SCRIPT_DIR}/src/index.ts"
+
+echo "Generating TypeScript clients from OpenAPI specs..."
+
+# Clean and recreate output directory
+rm -rf "${OUTPUT_DIR}"
+mkdir -p "${OUTPUT_DIR}"
+
+generate_client() {
+    local spec=$1
+    local output=$2
+    local name=$3
+
+    echo "  Generating ${name}..."
+    npx @openapitools/openapi-generator-cli generate \
+        -i "${spec}" \
+        -g typescript-fetch \
+        -o "${output}" \
+        --additional-properties=supportsES6=true,typescriptThreePlus=true,withInterfaces=true \
+        2>/dev/null || echo "    Warning: Failed to generate ${name}"
+}
+
+# Generate clients for each API spec
+generate_client "${API_CONTRACTS_DIR}/ad/ad.openapi.yaml" "${OUTPUT_DIR}/ad" "ad"
+generate_client "${API_CONTRACTS_DIR}/adrequest/adrequest.openapi.yaml" "${OUTPUT_DIR}/adrequest" "adrequest"
+generate_client "${API_CONTRACTS_DIR}/adset/adset.openapi.yaml" "${OUTPUT_DIR}/adset" "adset"
+generate_client "${API_CONTRACTS_DIR}/campaign/campaign.openapi.yaml" "${OUTPUT_DIR}/campaign" "campaign"
+generate_client "${API_CONTRACTS_DIR}/car/car.openapi.yaml" "${OUTPUT_DIR}/car" "car"
+generate_client "${API_CONTRACTS_DIR}/carsupplier/carsupplier.openapi.yaml" "${OUTPUT_DIR}/carsupplier" "carsupplier"
+generate_client "${API_CONTRACTS_DIR}/client/client.openapi.yaml" "${OUTPUT_DIR}/client" "client"
+generate_client "${API_CONTRACTS_DIR}/clientzone/clientzone.openapi.yaml" "${OUTPUT_DIR}/clientzone" "clientzone"
+generate_client "${API_CONTRACTS_DIR}/device/device.openapi.yaml" "${OUTPUT_DIR}/device" "device"
+generate_client "${API_CONTRACTS_DIR}/document/document.openapi.yaml" "${OUTPUT_DIR}/document" "document"
+generate_client "${API_CONTRACTS_DIR}/playlist/playlist.openapi.yaml" "${OUTPUT_DIR}/playlist" "playlist"
+generate_client "${API_CONTRACTS_DIR}/rate/rate.openapi.yaml" "${OUTPUT_DIR}/rate" "rate"
+generate_client "${API_CONTRACTS_DIR}/settings/settings.openapi.yaml" "${OUTPUT_DIR}/settings" "settings"
+generate_client "${API_CONTRACTS_DIR}/zone/zone.openapi.yaml" "${OUTPUT_DIR}/zone" "zone"
+
+# Generate index.ts
+echo "Generating index.ts..."
+cat > "${INDEX_FILE}" << 'EOF'
+/**
+ * Street Level API Clients
+ *
+ * Auto-generated TypeScript clients from OpenAPI specifications.
+ * Run `npm run generate` to regenerate.
+ *
+ * Usage:
+ *   import { zone, campaign, client } from '@streetlevel/api-clients';
+ *
+ *   const config = new zone.Configuration({
+ *     basePath: process.env.NEXT_PUBLIC_API_URL,
+ *   });
+ *
+ *   const zonesApi = new zone.ZonesApi(config);
+ *   const result = await zonesApi.listZones();
+ */
+
+// Core APIs
+export * as ad from './generated/ad';
+export * as adrequest from './generated/adrequest';
+export * as adset from './generated/adset';
+export * as campaign from './generated/campaign';
+export * as client from './generated/client';
+export * as zone from './generated/zone';
+
+// Vehicle APIs
+export * as car from './generated/car';
+export * as carsupplier from './generated/carsupplier';
+export * as device from './generated/device';
+
+// Business APIs
+export * as clientzone from './generated/clientzone';
+export * as document from './generated/document';
+export * as rate from './generated/rate';
+
+// System APIs
+export * as playlist from './generated/playlist';
+export * as settings from './generated/settings';
+EOF
+
+echo "Done! Generated clients in ${OUTPUT_DIR}"

package/openapi_ts.bzl

@@ -0,0 +1,69 @@
+"""Custom Bazel rule for OpenAPI TypeScript client generation.
+
+This rule generates TypeScript client code from OpenAPI specs using openapi-generator-cli
+with the typescript-fetch template.
+"""
+
+def _openapi_ts_client_impl(ctx):
+    """Implementation of openapi_ts_client rule."""
+
+    # Declare output directory for generated files
+    output_dir = ctx.actions.declare_directory(ctx.attr.name)
+
+    # Build the generation script
+    script = """
+set -e
+
+# Create temp directory for generation
+TMPDIR=$(mktemp -d)
+trap "rm -rf $TMPDIR" EXIT
+
+# Run OpenAPI Generator
+npx @openapitools/openapi-generator-cli generate \
+    -i {spec} \
+    -g typescript-fetch \
+    -o "$TMPDIR/generated" \
+    --additional-properties=supportsES6=true,typescriptThreePlus=true,withInterfaces=true
+
+# Copy generated files to output directory
+mkdir -p {output}
+cp -r "$TMPDIR/generated/"* {output}/
+""".format(
+        spec = ctx.file.spec.path,
+        output = output_dir.path,
+    )
+
+    ctx.actions.run_shell(
+        inputs = [ctx.file.spec],
+        outputs = [output_dir],
+        command = script,
+        mnemonic = "OpenAPIGenerateTS",
+        progress_message = "Generating TypeScript client from %s" % ctx.file.spec.short_path,
+        use_default_shell_env = True,
+    )
+
+    return [
+        DefaultInfo(files = depset([output_dir])),
+    ]
+
+openapi_ts_client = rule(
+    implementation = _openapi_ts_client_impl,
+    attrs = {
+        "spec": attr.label(
+            mandatory = True,
+            allow_single_file = [".yaml", ".yml", ".json"],
+            doc = "The OpenAPI specification file",
+        ),
+    },
+    doc = """Generates a TypeScript client from an OpenAPI specification.
+
+Outputs a directory containing all generated TypeScript files using the
+typescript-fetch generator template.
+
+Example:
+    openapi_ts_client(
+        name = "zone_client",
+        spec = "@api-contracts//:specs/zone/zone.openapi.yaml",
+    )
+""",
+)

package/openapitools.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "./node_modules/@openapitools/openapi-generator-cli/config.schema.json",
+  "spaces": 2,
+  "generator-cli": {
+    "version": "7.20.0"
+  }
+}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@streetlevel/api-clients",
+  "version": "1.0.1",
+  "description": "Auto-generated TypeScript clients from Street Level OpenAPI specifications",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "scripts": {
+    "generate": "bash generate.sh",
+    "generate:zone": "npx @openapitools/openapi-generator-cli generate -i ../api-contracts/specs/zone/zone.openapi.yaml -g typescript-fetch -o src/generated/zone --additional-properties=supportsES6=true,typescriptThreePlus=true,withInterfaces=true",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf src/generated"
+  },
+  "devDependencies": {
+    "@openapitools/openapi-generator-cli": "^2.13.4",
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=4.7.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/generated/ad/.openapi-generator/FILES

@@ -0,0 +1,25 @@
+.openapi-generator-ignore
+apis/AdsApi.ts
+apis/index.ts
+docs/AdResponse.md
+docs/AdStatus.md
+docs/AdsApi.md
+docs/CreateAd400Response.md
+docs/CreateAd400ResponseViolationsInner.md
+docs/CreateAdRequest.md
+docs/GetAd404Response.md
+docs/ListAdsResponse.md
+docs/RejectAdRequest.md
+docs/UploadUrlResponse.md
+index.ts
+models/AdResponse.ts
+models/AdStatus.ts
+models/CreateAd400Response.ts
+models/CreateAd400ResponseViolationsInner.ts
+models/CreateAdRequest.ts
+models/GetAd404Response.ts
+models/ListAdsResponse.ts
+models/RejectAdRequest.ts
+models/UploadUrlResponse.ts
+models/index.ts
+runtime.ts

package/src/generated/ad/.openapi-generator/VERSION

@@ -0,0 +1 @@
+7.20.0

package/src/generated/ad/.openapi-generator-ignore

@@ -0,0 +1,23 @@
+# OpenAPI Generator Ignore
+# Generated by openapi-generator https://github.com/openapitools/openapi-generator
+
+# Use this file to prevent files from being overwritten by the generator.
+# The patterns follow closely to .gitignore or .dockerignore.
+
+# As an example, the C# client generator defines ApiClient.cs.
+# You can make changes and tell OpenAPI Generator to ignore just this file by uncommenting the following line:
+#ApiClient.cs
+
+# You can match any string of characters against a directory, file or extension with a single asterisk (*):
+#foo/*/qux
+# The above matches foo/bar/qux and foo/baz/qux, but not foo/bar/baz/qux
+
+# You can recursively match patterns against a directory, file or extension with a double asterisk (**):
+#foo/**/qux
+# This matches foo/bar/qux, foo/baz/qux, and foo/bar/baz/qux
+
+# You can also negate patterns with an exclamation (!).
+# For example, you can ignore all files in a docs folder with the file extension .md:
+#docs/*.md
+# Then explicitly reverse the ignore rule for a single file:
+#!docs/README.md