c4r-aggregator-client 1.0.0

package/src/apis/CatalogApi.ts

@@ -0,0 +1,220 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * C4R Aggregator API
+ * Aggregator for public [12-Step Meeting List](https://wordpress.org/plugins/12-step-meeting-list/) WordPress feeds. Ingests registered sources on a schedule, normalizes duplicates across feeds, and exposes a unified read API whose responses follow the [Meeting Guide API spec](https://github.com/code4recovery/spec) for drop-in client compatibility.  - **Public endpoints** return Meeting Guide-shape data. `/meetings` requires at least one filter   (bounding box, radius, region, source, program, day, or type) and is cursor-paginated. - **Per-source and per-region feeds** return bare JSON arrays — safe drop-in replacements for the   upstream TSML endpoint. - **Admin endpoints** under `/admin/_*` require a Sanctum bearer token.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import * as runtime from '../runtime';
+import {
+    type MapFeatureCollection,
+    MapFeatureCollectionFromJSON,
+    MapFeatureCollectionToJSON,
+} from '../models/MapFeatureCollection';
+import {
+    type MeetingType,
+    MeetingTypeFromJSON,
+    MeetingTypeToJSON,
+} from '../models/MeetingType';
+import {
+    type Program,
+    ProgramFromJSON,
+    ProgramToJSON,
+} from '../models/Program';
+import {
+    type Stats,
+    StatsFromJSON,
+    StatsToJSON,
+} from '../models/Stats';
+
+export interface GetMapRequest {
+    program?: string;
+}
+
+export interface GetStatsRequest {
+    program?: string;
+}
+
+export interface ListMeetingTypesRequest {
+    program?: string;
+}
+
+/**
+ * 
+ */
+export class CatalogApi extends runtime.BaseAPI {
+
+    /**
+     * Creates request options for getMap without sending the request
+     */
+    async getMapRequestOpts(requestParameters: GetMapRequest): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        if (requestParameters['program'] != null) {
+            queryParameters['program'] = requestParameters['program'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/api/v1/map`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * One Feature per Location (not per meeting), with the list of meetings-at-that-location in the properties. Intended for a coverage-map view — show pins, click to see meeting names. Cached for 5 minutes (per program filter).
+     * All geocoded locations with active meetings, as GeoJSON
+     */
+    async getMapRaw(requestParameters: GetMapRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MapFeatureCollection>> {
+        const requestOptions = await this.getMapRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => MapFeatureCollectionFromJSON(jsonValue));
+    }
+
+    /**
+     * One Feature per Location (not per meeting), with the list of meetings-at-that-location in the properties. Intended for a coverage-map view — show pins, click to see meeting names. Cached for 5 minutes (per program filter).
+     * All geocoded locations with active meetings, as GeoJSON
+     */
+    async getMap(requestParameters: GetMapRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MapFeatureCollection> {
+        const response = await this.getMapRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for getStats without sending the request
+     */
+    async getStatsRequestOpts(requestParameters: GetStatsRequest): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        if (requestParameters['program'] != null) {
+            queryParameters['program'] = requestParameters['program'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/api/v1/stats`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Cached for 60s in Redis (per program filter). Useful for dashboards, transparency pages, and monitoring. Pass `?program=AA` to scope every count to a single program; `programs_breakdown` is always included so you can see per-program slices alongside the totals.
+     * Aggregator-wide counts and health snapshot
+     */
+    async getStatsRaw(requestParameters: GetStatsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Stats>> {
+        const requestOptions = await this.getStatsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => StatsFromJSON(jsonValue));
+    }
+
+    /**
+     * Cached for 60s in Redis (per program filter). Useful for dashboards, transparency pages, and monitoring. Pass `?program=AA` to scope every count to a single program; `programs_breakdown` is always included so you can see per-program slices alongside the totals.
+     * Aggregator-wide counts and health snapshot
+     */
+    async getStats(requestParameters: GetStatsRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Stats> {
+        const response = await this.getStatsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for listMeetingTypes without sending the request
+     */
+    async listMeetingTypesRequestOpts(requestParameters: ListMeetingTypesRequest): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        if (requestParameters['program'] != null) {
+            queryParameters['program'] = requestParameters['program'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/api/v1/types`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Returns all known meeting-type codes. Filter by `program` to scope to one program (e.g. AA).
+     * Meeting-type dictionary
+     */
+    async listMeetingTypesRaw(requestParameters: ListMeetingTypesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<MeetingType>>> {
+        const requestOptions = await this.listMeetingTypesRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(MeetingTypeFromJSON));
+    }
+
+    /**
+     * Returns all known meeting-type codes. Filter by `program` to scope to one program (e.g. AA).
+     * Meeting-type dictionary
+     */
+    async listMeetingTypes(requestParameters: ListMeetingTypesRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<MeetingType>> {
+        const response = await this.listMeetingTypesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for listPrograms without sending the request
+     */
+    async listProgramsRequestOpts(): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/api/v1/programs`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * List supported programs
+     */
+    async listProgramsRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<Program>>> {
+        const requestOptions = await this.listProgramsRequestOpts();
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(ProgramFromJSON));
+    }
+
+    /**
+     * List supported programs
+     */
+    async listPrograms(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<Program>> {
+        const response = await this.listProgramsRaw(initOverrides);
+        return await response.value();
+    }
+
+}

package/src/apis/MeetingsApi.ts

@@ -0,0 +1,305 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * C4R Aggregator API
+ * Aggregator for public [12-Step Meeting List](https://wordpress.org/plugins/12-step-meeting-list/) WordPress feeds. Ingests registered sources on a schedule, normalizes duplicates across feeds, and exposes a unified read API whose responses follow the [Meeting Guide API spec](https://github.com/code4recovery/spec) for drop-in client compatibility.  - **Public endpoints** return Meeting Guide-shape data. `/meetings` requires at least one filter   (bounding box, radius, region, source, program, day, or type) and is cursor-paginated. - **Per-source and per-region feeds** return bare JSON arrays — safe drop-in replacements for the   upstream TSML endpoint. - **Admin endpoints** under `/admin/_*` require a Sanctum bearer token.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import * as runtime from '../runtime';
+import {
+    type AuthError,
+    AuthErrorFromJSON,
+    AuthErrorToJSON,
+} from '../models/AuthError';
+import {
+    type Meeting,
+    MeetingFromJSON,
+    MeetingToJSON,
+} from '../models/Meeting';
+import {
+    type MeetingPage,
+    MeetingPageFromJSON,
+    MeetingPageToJSON,
+} from '../models/MeetingPage';
+import {
+    type MeetingsFilterError,
+    MeetingsFilterErrorFromJSON,
+    MeetingsFilterErrorToJSON,
+} from '../models/MeetingsFilterError';
+import {
+    type ValidationError,
+    ValidationErrorFromJSON,
+    ValidationErrorToJSON,
+} from '../models/ValidationError';
+
+export interface ExportMeetingsRequest {
+    includeInactive?: boolean;
+    program?: string;
+}
+
+export interface GetRegionFeedRequest {
+    region: number;
+}
+
+export interface GetSourceFeedRequest {
+    source: number;
+}
+
+export interface ListMeetingsRequest {
+    bbox?: string;
+    near?: string;
+    radius?: number;
+    regionId?: number;
+    sourceId?: number;
+    program?: string;
+    day?: number;
+    type?: string;
+    includeInactive?: boolean;
+    cursor?: string;
+    limit?: number;
+}
+
+/**
+ * 
+ */
+export class MeetingsApi extends runtime.BaseAPI {
+
+    /**
+     * Creates request options for exportMeetings without sending the request
+     */
+    async exportMeetingsRequestOpts(requestParameters: ExportMeetingsRequest): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        if (requestParameters['includeInactive'] != null) {
+            queryParameters['include_inactive'] = requestParameters['includeInactive'];
+        }
+
+        if (requestParameters['program'] != null) {
+            queryParameters['program'] = requestParameters['program'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/api/v1/meetings/export`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Returns every meeting as newline-delimited JSON. Intended for researchers and downstream aggregators. Heavily rate-limited (5/minute) and requires a Sanctum bearer token. Filter by `program` to scope to one program (unknown codes stream an empty body).
+     * Streamed NDJSON export of all meetings
+     */
+    async exportMeetingsRaw(requestParameters: ExportMeetingsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>> {
+        const requestOptions = await this.exportMeetingsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.VoidApiResponse(response);
+    }
+
+    /**
+     * Returns every meeting as newline-delimited JSON. Intended for researchers and downstream aggregators. Heavily rate-limited (5/minute) and requires a Sanctum bearer token. Filter by `program` to scope to one program (unknown codes stream an empty body).
+     * Streamed NDJSON export of all meetings
+     */
+    async exportMeetings(requestParameters: ExportMeetingsRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void> {
+        await this.exportMeetingsRaw(requestParameters, initOverrides);
+    }
+
+    /**
+     * Creates request options for getRegionFeed without sending the request
+     */
+    async getRegionFeedRequestOpts(requestParameters: GetRegionFeedRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['region'] == null) {
+            throw new runtime.RequiredError(
+                'region',
+                'Required parameter "region" was null or undefined when calling getRegionFeed().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/api/v1/regions/{region}/feed`;
+        urlPath = urlPath.replace('{region}', encodeURIComponent(String(requestParameters['region'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Returns a bare JSON array of meetings located within the specified region or any sub-region.
+     * Full Meeting Guide feed for a region and its descendants
+     */
+    async getRegionFeedRaw(requestParameters: GetRegionFeedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<Meeting>>> {
+        const requestOptions = await this.getRegionFeedRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(MeetingFromJSON));
+    }
+
+    /**
+     * Returns a bare JSON array of meetings located within the specified region or any sub-region.
+     * Full Meeting Guide feed for a region and its descendants
+     */
+    async getRegionFeed(requestParameters: GetRegionFeedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<Meeting>> {
+        const response = await this.getRegionFeedRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for getSourceFeed without sending the request
+     */
+    async getSourceFeedRequestOpts(requestParameters: GetSourceFeedRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['source'] == null) {
+            throw new runtime.RequiredError(
+                'source',
+                'Required parameter "source" was null or undefined when calling getSourceFeed().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/api/v1/sources/{source}/feed`;
+        urlPath = urlPath.replace('{source}', encodeURIComponent(String(requestParameters['source'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Drop-in replacement for the upstream `/wp-json/tsml/meetings` endpoint. Returns a bare JSON array of meetings — no pagination envelope.
+     * Full Meeting Guide feed for a single source
+     */
+    async getSourceFeedRaw(requestParameters: GetSourceFeedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<Meeting>>> {
+        const requestOptions = await this.getSourceFeedRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(MeetingFromJSON));
+    }
+
+    /**
+     * Drop-in replacement for the upstream `/wp-json/tsml/meetings` endpoint. Returns a bare JSON array of meetings — no pagination envelope.
+     * Full Meeting Guide feed for a single source
+     */
+    async getSourceFeed(requestParameters: GetSourceFeedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<Meeting>> {
+        const response = await this.getSourceFeedRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for listMeetings without sending the request
+     */
+    async listMeetingsRequestOpts(requestParameters: ListMeetingsRequest): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        if (requestParameters['bbox'] != null) {
+            queryParameters['bbox'] = requestParameters['bbox'];
+        }
+
+        if (requestParameters['near'] != null) {
+            queryParameters['near'] = requestParameters['near'];
+        }
+
+        if (requestParameters['radius'] != null) {
+            queryParameters['radius'] = requestParameters['radius'];
+        }
+
+        if (requestParameters['regionId'] != null) {
+            queryParameters['region_id'] = requestParameters['regionId'];
+        }
+
+        if (requestParameters['sourceId'] != null) {
+            queryParameters['source_id'] = requestParameters['sourceId'];
+        }
+
+        if (requestParameters['program'] != null) {
+            queryParameters['program'] = requestParameters['program'];
+        }
+
+        if (requestParameters['day'] != null) {
+            queryParameters['day'] = requestParameters['day'];
+        }
+
+        if (requestParameters['type'] != null) {
+            queryParameters['type'] = requestParameters['type'];
+        }
+
+        if (requestParameters['includeInactive'] != null) {
+            queryParameters['include_inactive'] = requestParameters['includeInactive'];
+        }
+
+        if (requestParameters['cursor'] != null) {
+            queryParameters['cursor'] = requestParameters['cursor'];
+        }
+
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/api/v1/meetings`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Returns meetings matching the provided filter(s). At least one of `bbox`, `near`, `region_id`, `source_id`, `program`, `day`, or `type` is required. Results are cursor-paginated (default 500/page, max 2000).
+     * Filtered meeting search
+     */
+    async listMeetingsRaw(requestParameters: ListMeetingsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MeetingPage>> {
+        const requestOptions = await this.listMeetingsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => MeetingPageFromJSON(jsonValue));
+    }
+
+    /**
+     * Returns meetings matching the provided filter(s). At least one of `bbox`, `near`, `region_id`, `source_id`, `program`, `day`, or `type` is required. Results are cursor-paginated (default 500/page, max 2000).
+     * Filtered meeting search
+     */
+    async listMeetings(requestParameters: ListMeetingsRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MeetingPage> {
+        const response = await this.listMeetingsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}

package/src/apis/SourcesApi.ts

@@ -0,0 +1,74 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * C4R Aggregator API
+ * Aggregator for public [12-Step Meeting List](https://wordpress.org/plugins/12-step-meeting-list/) WordPress feeds. Ingests registered sources on a schedule, normalizes duplicates across feeds, and exposes a unified read API whose responses follow the [Meeting Guide API spec](https://github.com/code4recovery/spec) for drop-in client compatibility.  - **Public endpoints** return Meeting Guide-shape data. `/meetings` requires at least one filter   (bounding box, radius, region, source, program, day, or type) and is cursor-paginated. - **Per-source and per-region feeds** return bare JSON arrays — safe drop-in replacements for the   upstream TSML endpoint. - **Admin endpoints** under `/admin/_*` require a Sanctum bearer token.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import * as runtime from '../runtime';
+import {
+    type PublicSource,
+    PublicSourceFromJSON,
+    PublicSourceToJSON,
+} from '../models/PublicSource';
+
+export interface ListSourcesRequest {
+    program?: string;
+}
+
+/**
+ * 
+ */
+export class SourcesApi extends runtime.BaseAPI {
+
+    /**
+     * Creates request options for listSources without sending the request
+     */
+    async listSourcesRequestOpts(requestParameters: ListSourcesRequest): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        if (requestParameters['program'] != null) {
+            queryParameters['program'] = requestParameters['program'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/api/v1/sources`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Returns every registered source minus admin-only fields (sharing keys, next_fetch_at, failures, etc.). Filter by `program` to scope to one program (e.g. `AA`, `NA`); unknown codes return an empty array.
+     * Public list of registered sources
+     */
+    async listSourcesRaw(requestParameters: ListSourcesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<PublicSource>>> {
+        const requestOptions = await this.listSourcesRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(PublicSourceFromJSON));
+    }
+
+    /**
+     * Returns every registered source minus admin-only fields (sharing keys, next_fetch_at, failures, etc.). Filter by `program` to scope to one program (e.g. `AA`, `NA`); unknown codes return an empty array.
+     * Public list of registered sources
+     */
+    async listSources(requestParameters: ListSourcesRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<PublicSource>> {
+        const response = await this.listSourcesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}

package/src/apis/index.ts

@@ -0,0 +1,6 @@
+/* tslint:disable */
+/* eslint-disable */
+export * from './AdminApi';
+export * from './CatalogApi';
+export * from './MeetingsApi';
+export * from './SourcesApi';

package/src/index.ts

@@ -0,0 +1,5 @@
+/* tslint:disable */
+/* eslint-disable */
+export * from './runtime';
+export * from './apis/index';
+export * from './models/index';