@useairfoil/connector-kit 0.5.3 → 0.6.0

package/METRICS.md

@@ -4,18 +4,20 @@ Connector Kit emits standard metrics through Effect metrics. Production runtimes
 
 ## Metrics
 
-| Name                                               | Type            | Unit            | Attributes                                   |
-| -------------------------------------------------- | --------------- | --------------- | -------------------------------------------- |
-| `airfoil_connector_entities_upserted_total`        | counter         | mutations       | `connector`, `resource`, `source`            |
-| `airfoil_connector_entities_deleted_total`         | counter         | mutations       | `connector`, `resource`, `source`            |
-| `airfoil_connector_batches_total`                  | counter         | batches         | `connector`, `resource`, `source`, `outcome` |
-| `airfoil_connector_batch_size`                     | histogram       | mutations/batch | `connector`, `resource`, `source`            |
-| `airfoil_connector_publish_duration_ms`            | histogram timer | ms              | `connector`, `resource`, `source`            |
-| `airfoil_connector_webhook_requests_total`         | counter         | requests        | `connector`, `path`, `outcome`               |
-| `airfoil_connector_webhook_queue_depth`            | gauge           | batches         | `connector`                                  |
-| `airfoil_connector_sync_state`                     | gauge           | none            | `connector`, `resource`, `state`             |
-| `airfoil_connector_last_success_timestamp_seconds` | gauge           | Unix seconds    | `connector`, `resource`, `source`            |
-| `airfoil_connector_api_retries_total`              | counter         | retries         | `connector`, `reason`                        |
+| OTLP name                                  | Prometheus name                            | Type            | Unit         |
+| ------------------------------------------ | ------------------------------------------ | --------------- | ------------ |
+| `airfoil.connector.entity.upserts`         | `airfoil_connector_entity_upserts`         | counter         | `{mutation}` |
+| `airfoil.connector.entity.deletes`         | `airfoil_connector_entity_deletes`         | counter         | `{mutation}` |
+| `airfoil.connector.batches`                | `airfoil_connector_batches`                | counter         | `{batch}`    |
+| `airfoil.connector.batch.size`             | `airfoil_connector_batch_size`             | histogram       | `{mutation}` |
+| `airfoil.connector.publish.duration`       | `airfoil_connector_publish_duration`       | histogram timer | `ms`         |
+| `airfoil.connector.webhook.requests`       | `airfoil_connector_webhook_requests`       | counter         | `{request}`  |
+| `airfoil.connector.webhook.queue.depth`    | `airfoil_connector_webhook_queue_depth`    | gauge           | `{batch}`    |
+| `airfoil.connector.sync.state`             | `airfoil_connector_sync_state`             | gauge           | `1`          |
+| `airfoil.connector.last_success.timestamp` | `airfoil_connector_last_success_timestamp` | gauge           | `s`          |
+| `airfoil.connector.api.retries`            | `airfoil_connector_api_retries`            | counter         | `{retry}`    |
+
+OTLP attributes use dotted OTel names. Common dimensions are `airfoil.connector.name`, `airfoil.resource.name`, and `airfoil.resource.source`; specialized attributes are `airfoil.batch.outcome`, `airfoil.webhook.path`, `airfoil.webhook.outcome`, `airfoil.connector.sync.state`, and `airfoil.connector.api.retry.reason`. The Prometheus endpoint replaces dots in metric and label names with underscores and does not append `_total`.
 
 Batch `source` is `backfill`, `changes`, or `webhook`. Batch `outcome` is `accepted`, `rejected`, or `error`. Webhook `outcome` is `ok`, `read_error`, `invalid_json`, `invalid_payload`, `rejected`, or `handler_error`. Sync `state` is `pending`, `backfilling`, `live`, or `error`.
 
@@ -26,7 +28,7 @@ Counters are activity since process start, not entity population. Use `increase(
 The last-success gauge is restored from durable state after restart and is `0` until the source commits its first checkpoint. Calculate source freshness in Prometheus:
 
 ```promql
-time() - airfoil_connector_last_success_timestamp_seconds
+time() - airfoil_connector_last_success_timestamp
 ```
 
 ## Sync Status
@@ -75,4 +77,4 @@ const schema = Schema.toStandardSchemaV1(Manifest.configSchema(polarManifest));
 const result = await schema["~standard"].validate(formValues);
 ```
 
-Poll `GET /status` and decode with `Status.StatusResponseSchema`. Chart ingestion with `increase(airfoil_connector_entities_upserted_total[...])`, alert on `airfoil_connector_sync_state{state="error"} == 1`, and alert on non-`ok` webhook outcomes.
+Poll `GET /status` and decode with `Status.StatusResponseSchema`. Chart ingestion with `increase(airfoil_connector_entity_upserts[...])`, alert on `airfoil_connector_sync_state{airfoil_connector_sync_state="error"} == 1`, and alert on non-`ok` `airfoil_webhook_outcome` values.

package/README.md

@@ -159,6 +159,14 @@ Render fields from `manifest.config`: use `field.name` as the form/storage key,
 
 Hosted connectors receive the runtime document as a read-only JSON file. `AIRFOIL_CONFIG_PATH` selects the file, and `RuntimeConfig.layerHosted()` adds the file beneath Effect's existing environment provider. The file is required and must contain valid JSON; each connector's Effect Config validates the fields it reads. Local sandboxes use Effect's default environment provider. Platform-owned config such as Wings host, namespace, table names, PostgreSQL settings, ports, and OTEL settings stays outside the manifest and outside the connector JSON.
 
+Hosted HTTP runtimes use `AIRFOIL_HTTP_PORT` (default `8080`). Wings table routing is one atomic `AIRFOIL_TABLE_BINDINGS` JSON object keyed by connector resource name. `Publisher.layerWingsConfig(connector)` rejects missing or unknown resources and validates every binding before ingestion starts:
+
+```env
+AIRFOIL_TABLE_BINDINGS={"posts":"namespaces/default/tables/posts"}
+```
+
+An object binding may add a typed runtime partition, for example `{"name":"namespaces/default/tables/posts","partition":{"type":"string","value":"tenant-a"}}`. Signed and unsigned 64-bit partition values use decimal strings; byte partitions use base64.
+
 ### Pre-provision Checks
 
 The dashboard backend imports each connector package and runs `ConnectorApp.check(...)` after manifest decoding but before persisting secrets or creating database and Kubernetes resources. Validate submitted resource names against `manifest.resources` at the request boundary before calling the typed check API. Replace the backend process provider with the submitted runtime document so unrelated backend environment variables cannot satisfy connector configuration:
@@ -357,17 +365,21 @@ const publisherLayer = Publisher.layerWings({
 The `tables` map is keyed by resource name. Values can be table names or objects with a table name and optional partition value.
 
 ```ts
+import * as Wings from "@useairfoil/wings";
+
 Publisher.layerWings({
   connector,
   tables: {
     posts: {
       name: "namespaces/default/tables/posts",
-      partitionValue: "account_123",
+      partitionValue: Wings.PartitionValue.string("account_123"),
     },
   },
 });
 ```
 
+Hosted entrypoints should use `Publisher.layerWingsConfig(connector)` instead. It loads the exact resource map from `AIRFOIL_TABLE_BINDINGS`, delegates partition decoding and table compatibility to Wings, and applies Connector Kit's manifest-resource validation before ingestion starts.
+
 The Wings publisher resolves table metadata during layer construction, validates resource key/version/partition compatibility, sends upserts with full rows, and sends deletes with key/version-only rows.
 
 ## Minimal Example
@@ -440,7 +452,7 @@ Effect.scoped(ConnectorApp.start(connector, { port: 8080 })).pipe(
 
 `Telemetry` contains connector-kit span names, span attributes, error annotation helpers, OTLP tracing layers, and OTLP metrics layers. HTTP connector runtimes expose shallow process health at `GET /health`, Prometheus metrics at `GET /metrics`, and durable sync state at `GET /status` by default. Provider, Wings, and PostgreSQL failures do not make `/health` fail.
 
-`/status` includes `lastSuccessAt` for each checkpointed backfill or changes source. Use `time() - airfoil_connector_last_success_timestamp_seconds` to monitor source freshness without interpreting provider cursors.
+`/status` includes `lastSuccessAt` for each checkpointed backfill or changes source. Use `time() - airfoil_connector_last_success_timestamp` to monitor source freshness without interpreting provider cursors. OTLP receives the canonical `airfoil.connector.last_success.timestamp` name; the Prometheus endpoint replaces dots with underscores.
 
 Common entry points:
 
@@ -471,7 +483,7 @@ Telemetry environment variables:
 | `OTEL_EXPORTER_OTLP_HEADERS`  | Connector Kit | Optional comma-separated headers, for example `Authorization=Bearer <token>,X-Axiom-Dataset=<dataset>`.                                                |
 | `OTEL_SERVICE_NAME`           | Effect        | Service name resource attribute, for example `producer-shopify`.                                                                                       |
 | `OTEL_SERVICE_VERSION`        | Effect        | Optional service version resource attribute.                                                                                                           |
-| `OTEL_RESOURCE_ATTRIBUTES`    | Effect        | Optional comma-separated resource attributes, for example `deployment.environment=production,team=data`.                                               |
+| `OTEL_RESOURCE_ATTRIBUTES`    | Effect        | Operator-owned identity, for example `service.instance.id=instance-1,airfoil.connector.revision=4,airfoil.team.id=team-acme`.                          |
 
 ## Testing
 

package/dist/auth/index.d.ts

@@ -1,2 +1,2 @@
-import { i as makeTokenCache, n as ExpiringToken, r as TokenCache } from "../index-CTHVudvQ.js";
+import { i as makeTokenCache, n as ExpiringToken, r as TokenCache } from "../index-DXa26Ry5.js";
 export { ExpiringToken, TokenCache, makeTokenCache };

package/dist/connector-app/index.d.ts

@@ -1,14 +1,14 @@
-import "../index-CTHVudvQ.js";
-import "../index-D54ySAKn.js";
-import "../types-B35J5YPu.js";
-import { d as CheckResult, f as ResourceCheckResult, i as start, n as App, p as check, r as StartOptions, u as CheckOptions } from "../index-DtJX_tic.js";
-import "../service-IE5qaf9x.js";
-import "../index-Coh_SkBs.js";
-import "../index-J42AZaXU.js";
-import "../index-CBT-JX-T.js";
-import "../metrics-CVAk1ALR.js";
-import "../index-Byr0Lf0C.js";
-import "../index-o1-Z3n7V.js";
-import "../index-Cq2IzY7T.js";
-import "../index-DKWIh6M1.js";
+import "../index-DXa26Ry5.js";
+import "../index-DKoRwyFn.js";
+import "../types-jVD5Ys43.js";
+import { d as CheckResult, f as ResourceCheckResult, i as start, n as App, p as check, r as StartOptions, u as CheckOptions } from "../index-C5Ma7V7t.js";
+import "../service-CUjGhe-7.js";
+import "../index-DYpEMJf-.js";
+import "../index-bfjH7Yb0.js";
+import "../index-CR9HJDdr.js";
+import "../metrics-C4V1pm6v.js";
+import "../index-ZSuiZX5H.js";
+import "../index-BA8ASHKr.js";
+import "../index-VpHaZXZw.js";
+import "../index-BKw7jA2a.js";
 export { App, CheckOptions, CheckResult, ResourceCheckResult, StartOptions, check, start };

package/dist/connector-app/index.js

@@ -1,11 +1,12 @@
 import "../errors-DHWylqRZ.js";
-import { n as start, r as check } from "../connector-app-d7Z-SZLQ.js";
-import "../metrics-CWPy2Aqc.js";
-import "../constants-BRhIX_rz.js";
-import "../service-DuFiQwid.js";
-import "../server-CXTQ7odl.js";
-import "../state-store-yl6LiTQ0.js";
-import "../status-B-oZBc33.js";
-import "../ingestion-BQo4cbGw.js";
+import { n as start, r as check } from "../connector-app-BljHd0Pe.js";
+import "../constants-D113Ut1x.js";
+import "../telemetry-j_nxwYfh.js";
+import "../metrics-inkCAxKq.js";
+import "../service-DiP-XETo.js";
+import "../server-D-eLX3yN.js";
+import "../state-store-BdYulQOY.js";
+import "../status-BTTd7AUR.js";
+import "../ingestion-QBGKrFr9.js";
 
 export { check, start };

package/dist/{connector-app-d7Z-SZLQ.js → connector-app-BljHd0Pe.js}

@@ -1,5 +1,5 @@
 import { t as __export } from "./chunk-Bp6m_JJh.js";
-import { n as run } from "./ingestion-BQo4cbGw.js";
+import { n as run } from "./ingestion-QBGKrFr9.js";
 import { Context, DateTime, Effect, Layer, Tuple } from "effect";
 import { NodeHttpServer } from "@effect/platform-node";
 import { HttpRouter } from "effect/unstable/http";
@@ -61,4 +61,4 @@ var connector_app_exports = /* @__PURE__ */ __export({
 
 //#endregion
 export { start as n, check as r, connector_app_exports as t };
-//# sourceMappingURL=connector-app-d7Z-SZLQ.js.map
+//# sourceMappingURL=connector-app-BljHd0Pe.js.map

package/dist/{connector-app-d7Z-SZLQ.js.map → connector-app-BljHd0Pe.js.map}

@@ -1 +1 @@
-{"version":3,"file":"connector-app-d7Z-SZLQ.js","names":["ok: ResourceCheckResult","runIngestion"],"sources":["../src/connector-app/check.ts","../src/connector-app/start.ts","../src/connector-app/index.ts"],"sourcesContent":["import { Context, Effect, Layer, Tuple } from \"effect\";\n\nimport type { ConnectorDefinition, ResourceDefinition, ResourceName } from \"../core/types\";\n\nexport type ResourceCheckResult =\n  | { readonly _tag: \"ok\" }\n  | { readonly _tag: \"error\"; readonly message: string };\n\nexport type CheckOptions<Name extends string> = {\n  readonly resources: ReadonlyArray<Name>;\n};\n\ntype ResourceCheckResults<Name extends PropertyKey> = {\n  readonly [Key in Name]: ResourceCheckResult;\n};\n\nexport type CheckResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Name extends ResourceName<Resources> = ResourceName<Resources>,\n> = ResourceCheckResults<Name>;\n\ntype CheckFailure = { readonly message: string };\n\nconst ok: ResourceCheckResult = { _tag: \"ok\" };\n\nconst error = (message: string): ResourceCheckResult => ({ _tag: \"error\", message });\n\nconst fromEntries = <Name extends string>(\n  entries: ReadonlyArray<readonly [Name, ResourceCheckResult]>,\n): ResourceCheckResults<Name> => Object.fromEntries(entries) as ResourceCheckResults<Name>;\n\nconst resultsFor = <Name extends string>(names: ReadonlyArray<Name>, result: ResourceCheckResult) =>\n  fromEntries(names.map((name) => Tuple.make(name, result)));\n\n/**\n * Builds the connector service from its layer and validates only the selected\n * resources. The layer remains open until every check finishes.\n */\nexport function check<\n  Identifier,\n  const Resources extends ReadonlyArray<ResourceDefinition>,\n  E extends CheckFailure,\n  R,\n  const Name extends ResourceName<Resources>,\n>(\n  service: Context.Key<Identifier, ConnectorDefinition<Resources>>,\n  layer: Layer.Layer<Identifier, E, R>,\n  options: CheckOptions<Name>,\n): Effect.Effect<CheckResult<Resources, Name>, never, R> {\n  if (options.resources.length === 0) {\n    return Effect.succeed(fromEntries<Name>([]));\n  }\n\n  return service.pipe(\n    Effect.flatMap((connector) =>\n      Effect.forEach(options.resources, (name) => {\n        const resource = connector.resources.find((candidate) => candidate.name === name);\n        const result = resource\n          ? resource.check.pipe(\n              Effect.match({\n                onFailure: (failure) => error(failure.message),\n                onSuccess: () => ok,\n              }),\n            )\n          : Effect.succeed(error(`Unknown connector resource: ${name}`));\n\n        return result.pipe(Effect.map((result) => Tuple.make(name, result)));\n      }).pipe(Effect.map(fromEntries)),\n    ),\n    Effect.provide(layer),\n    Effect.match({\n      onFailure: (failure) => resultsFor(options.resources, error(failure.message)),\n      onSuccess: (results) => results,\n    }),\n  );\n}\n","import { NodeHttpServer } from \"@effect/platform-node\";\nimport { DateTime, Effect } from \"effect\";\nimport { HttpRouter } from \"effect/unstable/http\";\nimport { createServer } from \"node:http\";\n\nimport type { ConnectorDefinition } from \"../core\";\nimport type { Cursor } from \"../core/types\";\n\nimport { run as runIngestion } from \"../ingestion\";\n\nexport type App = ConnectorDefinition;\n\nexport type StartOptions = {\n  readonly port: number;\n  readonly initialCutoff?: Cursor.Value;\n  readonly healthPath?: HttpRouter.PathInput;\n  readonly metricsPath?: HttpRouter.PathInput | false;\n  readonly statusPath?: HttpRouter.PathInput | false;\n  readonly disableHttpLogger?: boolean;\n};\n\nexport const start = (app: App, options: StartOptions) =>\n  Effect.gen(function* () {\n    const initialCutoff =\n      options.initialCutoff ?? (yield* DateTime.now.pipe(Effect.map(DateTime.formatIso)));\n    const routes = app.webhooks?.map((route) => route.path) ?? [];\n\n    yield* Effect.logInfo(\"webhook server ready\").pipe(\n      Effect.annotateLogs({ port: options.port, routes }),\n    );\n\n    return yield* runIngestion(app, {\n      initialCutoff,\n      webhook: {\n        routes: app.webhooks ?? [],\n        healthPath: options.healthPath ?? \"/health\",\n        metricsPath: options.metricsPath,\n        statusPath: options.statusPath,\n        disableHttpLogger: options.disableHttpLogger ?? true,\n      },\n    }).pipe(Effect.provide(NodeHttpServer.layer(createServer, { port: options.port })));\n  });\n","export { check, type CheckOptions, type CheckResult, type ResourceCheckResult } from \"./check\";\nexport { start, type App, type StartOptions } from \"./start\";\n"],"mappings":";;;;;;;;AAuBA,MAAMA,KAA0B,EAAE,MAAM,MAAM;AAE9C,MAAM,SAAS,aAA0C;CAAE,MAAM;CAAS;CAAS;AAEnF,MAAM,eACJ,YAC+B,OAAO,YAAY,QAAQ;AAE5D,MAAM,cAAmC,OAA4B,WACnE,YAAY,MAAM,KAAK,SAAS,MAAM,KAAK,MAAM,OAAO,CAAC,CAAC;;;;;AAM5D,SAAgB,MAOd,SACA,OACA,SACuD;AACvD,KAAI,QAAQ,UAAU,WAAW,EAC/B,QAAO,OAAO,QAAQ,YAAkB,EAAE,CAAC,CAAC;AAG9C,QAAO,QAAQ,KACb,OAAO,SAAS,cACd,OAAO,QAAQ,QAAQ,YAAY,SAAS;EAC1C,MAAM,WAAW,UAAU,UAAU,MAAM,cAAc,UAAU,SAAS,KAAK;AAUjF,UATe,WACX,SAAS,MAAM,KACb,OAAO,MAAM;GACX,YAAY,YAAY,MAAM,QAAQ,QAAQ;GAC9C,iBAAiB;GAClB,CAAC,CACH,GACD,OAAO,QAAQ,MAAM,+BAA+B,OAAO,CAAC,EAElD,KAAK,OAAO,KAAK,WAAW,MAAM,KAAK,MAAM,OAAO,CAAC,CAAC;GACpE,CAAC,KAAK,OAAO,IAAI,YAAY,CAAC,CACjC,EACD,OAAO,QAAQ,MAAM,EACrB,OAAO,MAAM;EACX,YAAY,YAAY,WAAW,QAAQ,WAAW,MAAM,QAAQ,QAAQ,CAAC;EAC7E,YAAY,YAAY;EACzB,CAAC,CACH;;;;;ACrDH,MAAa,SAAS,KAAU,YAC9B,OAAO,IAAI,aAAa;CACtB,MAAM,gBACJ,QAAQ,kBAAkB,OAAO,SAAS,IAAI,KAAK,OAAO,IAAI,SAAS,UAAU,CAAC;CACpF,MAAM,SAAS,IAAI,UAAU,KAAK,UAAU,MAAM,KAAK,IAAI,EAAE;AAE7D,QAAO,OAAO,QAAQ,uBAAuB,CAAC,KAC5C,OAAO,aAAa;EAAE,MAAM,QAAQ;EAAM;EAAQ,CAAC,CACpD;AAED,QAAO,OAAOC,IAAa,KAAK;EAC9B;EACA,SAAS;GACP,QAAQ,IAAI,YAAY,EAAE;GAC1B,YAAY,QAAQ,cAAc;GAClC,aAAa,QAAQ;GACrB,YAAY,QAAQ;GACpB,mBAAmB,QAAQ,qBAAqB;GACjD;EACF,CAAC,CAAC,KAAK,OAAO,QAAQ,eAAe,MAAM,cAAc,EAAE,MAAM,QAAQ,MAAM,CAAC,CAAC,CAAC;EACnF"}
+{"version":3,"file":"connector-app-BljHd0Pe.js","names":["ok: ResourceCheckResult","runIngestion"],"sources":["../src/connector-app/check.ts","../src/connector-app/start.ts","../src/connector-app/index.ts"],"sourcesContent":["import { Context, Effect, Layer, Tuple } from \"effect\";\n\nimport type { ConnectorDefinition, ResourceDefinition, ResourceName } from \"../core/types\";\n\nexport type ResourceCheckResult =\n  | { readonly _tag: \"ok\" }\n  | { readonly _tag: \"error\"; readonly message: string };\n\nexport type CheckOptions<Name extends string> = {\n  readonly resources: ReadonlyArray<Name>;\n};\n\ntype ResourceCheckResults<Name extends PropertyKey> = {\n  readonly [Key in Name]: ResourceCheckResult;\n};\n\nexport type CheckResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Name extends ResourceName<Resources> = ResourceName<Resources>,\n> = ResourceCheckResults<Name>;\n\ntype CheckFailure = { readonly message: string };\n\nconst ok: ResourceCheckResult = { _tag: \"ok\" };\n\nconst error = (message: string): ResourceCheckResult => ({ _tag: \"error\", message });\n\nconst fromEntries = <Name extends string>(\n  entries: ReadonlyArray<readonly [Name, ResourceCheckResult]>,\n): ResourceCheckResults<Name> => Object.fromEntries(entries) as ResourceCheckResults<Name>;\n\nconst resultsFor = <Name extends string>(names: ReadonlyArray<Name>, result: ResourceCheckResult) =>\n  fromEntries(names.map((name) => Tuple.make(name, result)));\n\n/**\n * Builds the connector service from its layer and validates only the selected\n * resources. The layer remains open until every check finishes.\n */\nexport function check<\n  Identifier,\n  const Resources extends ReadonlyArray<ResourceDefinition>,\n  E extends CheckFailure,\n  R,\n  const Name extends ResourceName<Resources>,\n>(\n  service: Context.Key<Identifier, ConnectorDefinition<Resources>>,\n  layer: Layer.Layer<Identifier, E, R>,\n  options: CheckOptions<Name>,\n): Effect.Effect<CheckResult<Resources, Name>, never, R> {\n  if (options.resources.length === 0) {\n    return Effect.succeed(fromEntries<Name>([]));\n  }\n\n  return service.pipe(\n    Effect.flatMap((connector) =>\n      Effect.forEach(options.resources, (name) => {\n        const resource = connector.resources.find((candidate) => candidate.name === name);\n        const result = resource\n          ? resource.check.pipe(\n              Effect.match({\n                onFailure: (failure) => error(failure.message),\n                onSuccess: () => ok,\n              }),\n            )\n          : Effect.succeed(error(`Unknown connector resource: ${name}`));\n\n        return result.pipe(Effect.map((result) => Tuple.make(name, result)));\n      }).pipe(Effect.map(fromEntries)),\n    ),\n    Effect.provide(layer),\n    Effect.match({\n      onFailure: (failure) => resultsFor(options.resources, error(failure.message)),\n      onSuccess: (results) => results,\n    }),\n  );\n}\n","import { NodeHttpServer } from \"@effect/platform-node\";\nimport { DateTime, Effect } from \"effect\";\nimport { HttpRouter } from \"effect/unstable/http\";\nimport { createServer } from \"node:http\";\n\nimport type { ConnectorDefinition } from \"../core\";\nimport type { Cursor } from \"../core/types\";\n\nimport { run as runIngestion } from \"../ingestion\";\n\nexport type App = ConnectorDefinition;\n\nexport type StartOptions = {\n  readonly port: number;\n  readonly initialCutoff?: Cursor.Value;\n  readonly healthPath?: HttpRouter.PathInput;\n  readonly metricsPath?: HttpRouter.PathInput | false;\n  readonly statusPath?: HttpRouter.PathInput | false;\n  readonly disableHttpLogger?: boolean;\n};\n\nexport const start = (app: App, options: StartOptions) =>\n  Effect.gen(function* () {\n    const initialCutoff =\n      options.initialCutoff ?? (yield* DateTime.now.pipe(Effect.map(DateTime.formatIso)));\n    const routes = app.webhooks?.map((route) => route.path) ?? [];\n\n    yield* Effect.logInfo(\"webhook server ready\").pipe(\n      Effect.annotateLogs({ port: options.port, routes }),\n    );\n\n    return yield* runIngestion(app, {\n      initialCutoff,\n      webhook: {\n        routes: app.webhooks ?? [],\n        healthPath: options.healthPath ?? \"/health\",\n        metricsPath: options.metricsPath,\n        statusPath: options.statusPath,\n        disableHttpLogger: options.disableHttpLogger ?? true,\n      },\n    }).pipe(Effect.provide(NodeHttpServer.layer(createServer, { port: options.port })));\n  });\n","export { check, type CheckOptions, type CheckResult, type ResourceCheckResult } from \"./check\";\nexport { start, type App, type StartOptions } from \"./start\";\n"],"mappings":";;;;;;;;AAuBA,MAAMA,KAA0B,EAAE,MAAM,MAAM;AAE9C,MAAM,SAAS,aAA0C;CAAE,MAAM;CAAS;CAAS;AAEnF,MAAM,eACJ,YAC+B,OAAO,YAAY,QAAQ;AAE5D,MAAM,cAAmC,OAA4B,WACnE,YAAY,MAAM,KAAK,SAAS,MAAM,KAAK,MAAM,OAAO,CAAC,CAAC;;;;;AAM5D,SAAgB,MAOd,SACA,OACA,SACuD;AACvD,KAAI,QAAQ,UAAU,WAAW,EAC/B,QAAO,OAAO,QAAQ,YAAkB,EAAE,CAAC,CAAC;AAG9C,QAAO,QAAQ,KACb,OAAO,SAAS,cACd,OAAO,QAAQ,QAAQ,YAAY,SAAS;EAC1C,MAAM,WAAW,UAAU,UAAU,MAAM,cAAc,UAAU,SAAS,KAAK;AAUjF,UATe,WACX,SAAS,MAAM,KACb,OAAO,MAAM;GACX,YAAY,YAAY,MAAM,QAAQ,QAAQ;GAC9C,iBAAiB;GAClB,CAAC,CACH,GACD,OAAO,QAAQ,MAAM,+BAA+B,OAAO,CAAC,EAElD,KAAK,OAAO,KAAK,WAAW,MAAM,KAAK,MAAM,OAAO,CAAC,CAAC;GACpE,CAAC,KAAK,OAAO,IAAI,YAAY,CAAC,CACjC,EACD,OAAO,QAAQ,MAAM,EACrB,OAAO,MAAM;EACX,YAAY,YAAY,WAAW,QAAQ,WAAW,MAAM,QAAQ,QAAQ,CAAC;EAC7E,YAAY,YAAY;EACzB,CAAC,CACH;;;;;ACrDH,MAAa,SAAS,KAAU,YAC9B,OAAO,IAAI,aAAa;CACtB,MAAM,gBACJ,QAAQ,kBAAkB,OAAO,SAAS,IAAI,KAAK,OAAO,IAAI,SAAS,UAAU,CAAC;CACpF,MAAM,SAAS,IAAI,UAAU,KAAK,UAAU,MAAM,KAAK,IAAI,EAAE;AAE7D,QAAO,OAAO,QAAQ,uBAAuB,CAAC,KAC5C,OAAO,aAAa;EAAE,MAAM,QAAQ;EAAM;EAAQ,CAAC,CACpD;AAED,QAAO,OAAOC,IAAa,KAAK;EAC9B;EACA,SAAS;GACP,QAAQ,IAAI,YAAY,EAAE;GAC1B,YAAY,QAAQ,cAAc;GAClC,aAAa,QAAQ;GACrB,YAAY,QAAQ;GACpB,mBAAmB,QAAQ,qBAAqB;GACjD;EACF,CAAC,CAAC,KAAK,OAAO,QAAQ,eAAe,MAAM,cAAc,EAAE,MAAM,QAAQ,MAAM,CAAC,CAAC,CAAC;EACnF"}

package/dist/{constants-BRhIX_rz.js → constants-D113Ut1x.js}

@@ -4,6 +4,8 @@ import { HashSet } from "effect";
 /** Shared runtime keys owned by Airfoil rather than an individual connector. */
 const PlatformRuntimeKey = {
 	configPath: "AIRFOIL_CONFIG_PATH",
+	httpPort: "AIRFOIL_HTTP_PORT",
+	tableBindings: "AIRFOIL_TABLE_BINDINGS",
 	connectorInstanceId: "AIRFOIL_CONNECTOR_INSTANCE_ID",
 	stateTable: "AIRFOIL_STATE_TABLE",
 	postgresConnectionString: "POSTGRES_CONNECTION_STRING",
@@ -17,11 +19,14 @@ const PlatformRuntimeKey = {
 	otelResourceAttributes: "OTEL_RESOURCE_ATTRIBUTES"
 };
 /** Defaults for optional platform-owned runtime configuration. */
-const PlatformRuntimeDefault = { stateTable: "_airfoil_connectors_state" };
+const PlatformRuntimeDefault = {
+	httpPort: 8080,
+	stateTable: "_airfoil_connectors_state"
+};
 const platformRuntimeKeys = HashSet.fromIterable(Object.values(PlatformRuntimeKey));
 /** @internal */
 const isPlatformRuntimeKey = (key) => HashSet.has(platformRuntimeKeys, key);
 
 //#endregion
 export { PlatformRuntimeKey as n, isPlatformRuntimeKey as r, PlatformRuntimeDefault as t };
-//# sourceMappingURL=constants-BRhIX_rz.js.map
+//# sourceMappingURL=constants-D113Ut1x.js.map

package/dist/constants-D113Ut1x.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants-D113Ut1x.js","names":[],"sources":["../src/runtime-config/constants.ts"],"sourcesContent":["import { HashSet } from \"effect\";\n\n/** Shared runtime keys owned by Airfoil rather than an individual connector. */\nexport const PlatformRuntimeKey = {\n  configPath: \"AIRFOIL_CONFIG_PATH\",\n  httpPort: \"AIRFOIL_HTTP_PORT\",\n  tableBindings: \"AIRFOIL_TABLE_BINDINGS\",\n  connectorInstanceId: \"AIRFOIL_CONNECTOR_INSTANCE_ID\",\n  stateTable: \"AIRFOIL_STATE_TABLE\",\n  postgresConnectionString: \"POSTGRES_CONNECTION_STRING\",\n  wingsHost: \"WINGS_HOST\",\n  wingsNamespace: \"WINGS_NAMESPACE\",\n  otelEnabled: \"OTEL_ENABLED\",\n  otelExporterOtlpEndpoint: \"OTEL_EXPORTER_OTLP_ENDPOINT\",\n  otelExporterOtlpHeaders: \"OTEL_EXPORTER_OTLP_HEADERS\",\n  otelServiceName: \"OTEL_SERVICE_NAME\",\n  otelServiceVersion: \"OTEL_SERVICE_VERSION\",\n  otelResourceAttributes: \"OTEL_RESOURCE_ATTRIBUTES\",\n} as const;\n\n/** Defaults for optional platform-owned runtime configuration. */\nexport const PlatformRuntimeDefault = {\n  httpPort: 8080,\n  stateTable: \"_airfoil_connectors_state\",\n} as const;\n\nconst platformRuntimeKeys = HashSet.fromIterable(Object.values(PlatformRuntimeKey));\n\n/** @internal */\nexport const isPlatformRuntimeKey = (key: string): boolean => HashSet.has(platformRuntimeKeys, key);\n"],"mappings":";;;;AAGA,MAAa,qBAAqB;CAChC,YAAY;CACZ,UAAU;CACV,eAAe;CACf,qBAAqB;CACrB,YAAY;CACZ,0BAA0B;CAC1B,WAAW;CACX,gBAAgB;CAChB,aAAa;CACb,0BAA0B;CAC1B,yBAAyB;CACzB,iBAAiB;CACjB,oBAAoB;CACpB,wBAAwB;CACzB;;AAGD,MAAa,yBAAyB;CACpC,UAAU;CACV,YAAY;CACb;AAED,MAAM,sBAAsB,QAAQ,aAAa,OAAO,OAAO,mBAAmB,CAAC;;AAGnF,MAAa,wBAAwB,QAAyB,QAAQ,IAAI,qBAAqB,IAAI"}

package/dist/errors/index.d.ts

@@ -1,2 +1,2 @@
-import { t as ConnectorError } from "../index-D54ySAKn.js";
+import { t as ConnectorError } from "../index-DKoRwyFn.js";
 export { ConnectorError };

package/dist/{index-Byr0Lf0C.d.ts → index-BA8ASHKr.d.ts}

@@ -1,25 +1,31 @@
-import { t as ConnectorError } from "./index-D54ySAKn.js";
-import { c as ResourceBatch, n as ConnectorDefinition } from "./types-B35J5YPu.js";
-import { a as PublisherService, i as Publisher, n as PublishOptions, r as PublishSource, t as PublishAck } from "./service-IE5qaf9x.js";
+import { t as ConnectorError } from "./index-DKoRwyFn.js";
+import { c as ResourceBatch, n as ConnectorDefinition } from "./types-jVD5Ys43.js";
+import { a as PublisherService, i as Publisher, n as PublishOptions, r as PublishSource, t as PublishAck } from "./service-CUjGhe-7.js";
+import { d as RuntimeConfigError } from "./index-ZSuiZX5H.js";
 import { Layer } from "effect";
 import * as Wings from "@useairfoil/wings";
 
 //#region src/publisher/wings.d.ts
+/** Programmatic mapping between a connector resource and a Wings table. */
 type WingsTableMapping = {
   readonly name: string;
   readonly partitionValue?: Wings.PartitionValue.PartitionValue;
 };
+/** Direct Wings publisher configuration, mainly for tests and local runtimes. */
 type WingsPublisherConfig = {
   readonly connector: ConnectorDefinition;
   readonly tables: Record<string, string | WingsTableMapping>;
 };
+/** Builds a Wings publisher from explicit table mappings. */
 declare const layerWings: (config: WingsPublisherConfig) => Layer.Layer<Publisher, ConnectorError, Wings.WingsClient.WingsClient>;
+/** Builds a Wings publisher from the complete hosted `AIRFOIL_TABLE_BINDINGS` document. */
+declare const layerWingsConfig: (connector: ConnectorDefinition) => Layer.Layer<Publisher, ConnectorError | RuntimeConfigError, Wings.WingsClient.WingsClient>;
 //#endregion
 //#region src/publisher/console.d.ts
 declare const layerConsole: Layer.Layer<Publisher, never, never>;
 declare namespace index_d_exports {
-  export { PublishAck, PublishOptions, PublishSource, Publisher, PublisherService, ResourceBatch, WingsPublisherConfig, layerConsole, layerWings };
+  export { PublishAck, PublishOptions, PublishSource, Publisher, PublisherService, ResourceBatch, WingsPublisherConfig, layerConsole, layerWings, layerWingsConfig };
 }
 //#endregion
-export { layerWings as i, layerConsole as n, WingsPublisherConfig as r, index_d_exports as t };
-//# sourceMappingURL=index-Byr0Lf0C.d.ts.map
+export { layerWingsConfig as a, layerWings as i, layerConsole as n, WingsPublisherConfig as r, index_d_exports as t };
+//# sourceMappingURL=index-BA8ASHKr.d.ts.map

package/dist/{index-DKWIh6M1.d.ts → index-BKw7jA2a.d.ts}

@@ -1,5 +1,5 @@
-import { C as WebhookRouteInput, S as WebhookRouteContext, c as ResourceBatch, l as ResourceDefinition, x as WebhookRoute, y as WebhookAckMode } from "./types-B35J5YPu.js";
-import { i as Publisher } from "./service-IE5qaf9x.js";
+import { C as WebhookRouteInput, S as WebhookRouteContext, c as ResourceBatch, l as ResourceDefinition, x as WebhookRoute, y as WebhookAckMode } from "./types-jVD5Ys43.js";
+import { i as Publisher } from "./service-CUjGhe-7.js";
 import { Context, Queue } from "effect";
 import { HttpRouter } from "effect/unstable/http";
 import * as effect_Layer1 from "effect/Layer";
@@ -22,4 +22,4 @@ declare namespace index_d_exports {
 declare const route: <const Resources extends ReadonlyArray<ResourceDefinition>, Payload>(definition: WebhookRouteInput<Resources, Payload>) => WebhookRoute<Resources, Payload>;
 //#endregion
 export { route as n, router as r, index_d_exports as t };
-//# sourceMappingURL=index-DKWIh6M1.d.ts.map
+//# sourceMappingURL=index-BKw7jA2a.d.ts.map

package/dist/{index-DtJX_tic.d.ts → index-C5Ma7V7t.d.ts}

@@ -1,7 +1,7 @@
-import { t as ConnectorError } from "./index-D54ySAKn.js";
-import { b as WebhookHandler, d as ResourceMutation, f as ResourceName, g as ResourceSchema, i as DeleteValue, l as ResourceDefinition, n as ConnectorDefinition, r as Cursor, s as PageFetch, t as ChangesFetch } from "./types-B35J5YPu.js";
-import { i as Publisher } from "./service-IE5qaf9x.js";
-import { i as StateStore } from "./index-Coh_SkBs.js";
+import { t as ConnectorError } from "./index-DKoRwyFn.js";
+import { b as WebhookHandler, d as ResourceMutation, f as ResourceName, g as ResourceSchema, i as DeleteValue, l as ResourceDefinition, n as ConnectorDefinition, r as Cursor, s as PageFetch, t as ChangesFetch } from "./types-jVD5Ys43.js";
+import { i as Publisher } from "./service-CUjGhe-7.js";
+import { i as StateStore } from "./index-DYpEMJf-.js";
 import { Config, Context, Duration, Effect, Layer } from "effect";
 import { HttpRouter } from "effect/unstable/http";
 import * as effect_unstable_http_HttpClient0 from "effect/unstable/http/HttpClient";
@@ -52,7 +52,7 @@ declare const Cursor$1: {
   nowIsoDateTime: Effect.Effect<string, never, never>;
 };
 declare namespace telemetry_d_exports {
-  export { Attr, EventAttr, EventName, OtlpMetricsOptions, OtlpTracingConfig, OtlpTracingOptions, SpanName, addCurrentSpanEvent, annotateError, layer, layerConfig, layerMetricsConsoleDump, layerOtlp, layerOtlpMetrics, layerOtlpTracing };
+  export { Attr, EventAttr, EventName, OtlpMetricsOptions, OtlpTracingConfig, OtlpTracingOptions, ResourceAttr, SpanName, addCurrentSpanEvent, annotateError, layer, layerConfig, layerMetricsConsoleDump, layerOtlp, layerOtlpMetrics, layerOtlpTracing };
 }
 /** Canonical span names emitted by connector-kit runtime instrumentation. */
 declare const SpanName: {
@@ -70,7 +70,11 @@ declare const Attr: {
   readonly resourceName: "airfoil.resource.name";
   readonly resourceSource: "airfoil.resource.source";
   readonly batchMutations: "airfoil.batch.mutations";
+  readonly batchOutcome: "airfoil.batch.outcome";
   readonly webhookPath: "airfoil.webhook.path";
+  readonly webhookOutcome: "airfoil.webhook.outcome";
+  readonly syncState: "airfoil.connector.sync.state";
+  readonly apiRetryReason: "airfoil.connector.api.retry.reason";
   readonly publisherSuccess: "airfoil.publisher.success";
   readonly stateKey: "airfoil.state.key";
   readonly apiPath: "airfoil.api.path";
@@ -79,6 +83,12 @@ declare const Attr: {
   readonly errorMessage: "airfoil.error.message";
   readonly errorDetails: "airfoil.error.details";
 };
+/** Resource attributes injected by the hosted operator through standard OTel environment keys. */
+declare const ResourceAttr: {
+  readonly serviceInstanceId: "service.instance.id";
+  readonly connectorRevision: "airfoil.connector.revision";
+  readonly teamId: "airfoil.team.id";
+};
 /** Span event names for high-cardinality reproduction details. */
 declare const EventName: {
   readonly batchCheckpoint: "airfoil.batch.checkpoint";
@@ -102,6 +112,7 @@ type OtlpTracingOptions = {
   /** Additional connector-specific header names or regexes to redact from HTTP logs/traces. */
   readonly redactedHeaders?: ReadonlyArray<string | RegExp>;
 };
+/** OTLP metric export settings. */
 type OtlpMetricsOptions = {
   readonly exportInterval?: Duration.Input;
 };
@@ -130,8 +141,11 @@ declare const layerConfig: (config: Config.Wrap<OtlpTracingConfig>, options?: Ot
  * `OTEL_SERVICE_NAME`, `OTEL_SERVICE_VERSION`, and `OTEL_RESOURCE_ATTRIBUTES`.
  */
 declare const layerOtlpTracing: (options?: OtlpTracingOptions) => Layer.Layer<never, Error | Config.ConfigError, effect_unstable_http_HttpClient0.HttpClient>;
+/** Exports connector metrics over OTLP when telemetry is enabled. */
 declare const layerOtlpMetrics: (options?: OtlpMetricsOptions) => Layer.Layer<never, Error | Config.ConfigError, effect_unstable_http_HttpClient0.HttpClient>;
+/** Enables OTLP traces and metrics with shared environment configuration. */
 declare const layerOtlp: (options?: OtlpTracingOptions & OtlpMetricsOptions) => Layer.Layer<never, Error | Config.ConfigError, effect_unstable_http_HttpClient0.HttpClient>;
+/** Periodically logs the in-memory metric snapshot for local debugging. */
 declare const layerMetricsConsoleDump: (interval?: Duration.Input) => Layer.Layer<never, never, never>;
 //#endregion
 //#region src/connector-app/start.d.ts
@@ -144,10 +158,10 @@ type StartOptions = {
   readonly statusPath?: HttpRouter.PathInput | false;
   readonly disableHttpLogger?: boolean;
 };
-declare const start: (app: App, options: StartOptions) => Effect.Effect<void, ConnectorError | effect_unstable_http_HttpServerError0.ServeError, StateStore | Publisher>;
+declare const start: (app: App, options: StartOptions) => Effect.Effect<void, ConnectorError | effect_unstable_http_HttpServerError0.ServeError, Publisher | StateStore>;
 declare namespace index_d_exports {
   export { App, CheckOptions, CheckResult, ResourceCheckResult, StartOptions, check, start };
 }
 //#endregion
 export { telemetry_d_exports as a, Fetch as c, CheckResult as d, ResourceCheckResult as f, start as i, Resource as l, App as n, Connector as o, check as p, StartOptions as r, Cursor$1 as s, index_d_exports as t, CheckOptions as u };
-//# sourceMappingURL=index-DtJX_tic.d.ts.map
+//# sourceMappingURL=index-C5Ma7V7t.d.ts.map

package/dist/{index-CBT-JX-T.d.ts → index-CR9HJDdr.d.ts}

@@ -170,4 +170,4 @@ declare namespace index_d_exports {
 }
 //#endregion
 export { number as _, configSchema as a, select as b, ConnectorManifest as c, ConfigField as d, ConfigFieldSpec as f, define as g, boolean as h, RuntimeConfigDocument as i, ResourceCapability as l, ConnectorConfigDef as m, ConnectorConfigSchema as n, decodeConfig as o, ConfigValuesOf as p, ConnectorConfigValues as r, toRuntimeDocument as s, index_d_exports as t, define$1 as u, optional as v, string as x, secret as y };
-//# sourceMappingURL=index-CBT-JX-T.d.ts.map
+//# sourceMappingURL=index-CR9HJDdr.d.ts.map

package/dist/{index-D54ySAKn.d.ts → index-DKoRwyFn.d.ts}

@@ -11,4 +11,4 @@ declare class ConnectorError extends ConnectorError_base<{
 }> {}
 //#endregion
 export { ConnectorError as t };
-//# sourceMappingURL=index-D54ySAKn.d.ts.map
+//# sourceMappingURL=index-DKoRwyFn.d.ts.map

package/dist/{index-CTHVudvQ.d.ts → index-DXa26Ry5.d.ts}

@@ -38,4 +38,4 @@ declare namespace index_d_exports {
 }
 //#endregion
 export { makeTokenCache as i, ExpiringToken as n, TokenCache as r, index_d_exports as t };
-//# sourceMappingURL=index-CTHVudvQ.d.ts.map
+//# sourceMappingURL=index-DXa26Ry5.d.ts.map

package/dist/{index-Coh_SkBs.d.ts → index-DYpEMJf-.d.ts}

@@ -1,4 +1,4 @@
-import { t as ConnectorError } from "./index-D54ySAKn.js";
+import { t as ConnectorError } from "./index-DKoRwyFn.js";
 import { Config, Context, Effect, Layer, Schema } from "effect";
 import { SqlClient } from "effect/unstable/sql";
 
@@ -92,4 +92,4 @@ declare namespace index_d_exports {
 }
 //#endregion
 export { StateStoreService as a, StateStore as i, layerSql as n, layerMemory as r, index_d_exports as t };
-//# sourceMappingURL=index-Coh_SkBs.d.ts.map
+//# sourceMappingURL=index-DYpEMJf-.d.ts.map

package/dist/{index-Cq2IzY7T.d.ts → index-VpHaZXZw.d.ts}

@@ -1,5 +1,5 @@
-import { n as ConnectorDefinition } from "./types-B35J5YPu.js";
-import { i as StateStore } from "./index-Coh_SkBs.js";
+import { n as ConnectorDefinition } from "./types-jVD5Ys43.js";
+import { i as StateStore } from "./index-DYpEMJf-.js";
 import { Schema } from "effect";
 import { HttpRouter } from "effect/unstable/http";
 import * as effect_Layer0 from "effect/Layer";
@@ -77,4 +77,4 @@ declare namespace index_d_exports {
 }
 //#endregion
 export { ResourceStatusSchema as a, StatusUnavailableResponse as c, SyncStateSchema as d, statusRoute as f, ResourceStatus as i, StatusUnavailableResponseSchema as l, ResourceError as n, StatusResponse as o, ResourceErrorSchema as r, StatusResponseSchema as s, index_d_exports as t, SyncState as u };
-//# sourceMappingURL=index-Cq2IzY7T.d.ts.map
+//# sourceMappingURL=index-VpHaZXZw.d.ts.map

package/dist/index-ZSuiZX5H.d.ts

@@ -0,0 +1,85 @@
+import { f as ResourceName, n as ConnectorDefinition } from "./types-jVD5Ys43.js";
+import { Config, Effect, FileSystem } from "effect";
+import * as Wings from "@useairfoil/wings";
+import * as effect_Types0 from "effect/Types";
+import * as effect_Cause0 from "effect/Cause";
+import * as effect_Layer0 from "effect/Layer";
+
+//#region src/runtime-config/error.d.ts
+type RuntimeConfigErrorCode = "CONFIG_PATH_MISSING" | "CONFIG_FILE_UNREADABLE" | "CONFIG_JSON_INVALID" | "TABLE_BINDINGS_MISSING" | "TABLE_BINDINGS_INVALID" | "TABLE_BINDINGS_MISMATCH";
+declare const RuntimeConfigError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => effect_Cause0.YieldableError & {
+  readonly _tag: "RuntimeConfigError";
+} & Readonly<A>;
+/** Expected hosted-config failure with a stable code and diagnostic cause. */
+declare class RuntimeConfigError extends RuntimeConfigError_base<{
+  readonly code: RuntimeConfigErrorCode;
+  readonly message: string;
+  readonly cause: Error;
+}> {}
+//#endregion
+//#region src/runtime-config/config.d.ts
+/** Shared HTTP port used by hosted and sandbox connector entrypoints. */
+declare const httpPort: Config.Config<number>;
+/** Shared Wings client configuration supplied by the hosting platform. */
+declare const wingsClient: {
+  host: Config.Config<string>;
+  namespace: Config.Config<string>;
+};
+//#endregion
+//#region src/runtime-config/constants.d.ts
+/** Shared runtime keys owned by Airfoil rather than an individual connector. */
+declare const PlatformRuntimeKey: {
+  readonly configPath: "AIRFOIL_CONFIG_PATH";
+  readonly httpPort: "AIRFOIL_HTTP_PORT";
+  readonly tableBindings: "AIRFOIL_TABLE_BINDINGS";
+  readonly connectorInstanceId: "AIRFOIL_CONNECTOR_INSTANCE_ID";
+  readonly stateTable: "AIRFOIL_STATE_TABLE";
+  readonly postgresConnectionString: "POSTGRES_CONNECTION_STRING";
+  readonly wingsHost: "WINGS_HOST";
+  readonly wingsNamespace: "WINGS_NAMESPACE";
+  readonly otelEnabled: "OTEL_ENABLED";
+  readonly otelExporterOtlpEndpoint: "OTEL_EXPORTER_OTLP_ENDPOINT";
+  readonly otelExporterOtlpHeaders: "OTEL_EXPORTER_OTLP_HEADERS";
+  readonly otelServiceName: "OTEL_SERVICE_NAME";
+  readonly otelServiceVersion: "OTEL_SERVICE_VERSION";
+  readonly otelResourceAttributes: "OTEL_RESOURCE_ATTRIBUTES";
+};
+/** Defaults for optional platform-owned runtime configuration. */
+declare const PlatformRuntimeDefault: {
+  readonly httpPort: 8080;
+  readonly stateTable: "_airfoil_connectors_state";
+};
+//#endregion
+//#region src/runtime-config/layer.d.ts
+/**
+ * Loads the required JSON file and lets environment values override it per key.
+ * Connector field validation remains in the connector's Effect Config.
+ *
+ * @example
+ * ```ts
+ * program.pipe(Effect.provide(layerHosted()));
+ * ```
+ */
+declare const layerHosted: () => effect_Layer0.Layer<never, RuntimeConfigError, FileSystem.FileSystem>;
+//#endregion
+//#region src/runtime-config/table-bindings.d.ts
+/** Table binding shape accepted in `AIRFOIL_TABLE_BINDINGS`. */
+type HostedTableBinding = string | {
+  readonly name: string;
+  readonly partition?: Wings.PartitionValue.Json;
+};
+/** Validated table binding ready for the Wings publisher. */
+type ResolvedTableBinding = {
+  readonly name: string;
+  readonly partitionValue?: Wings.PartitionValue.PartitionValue;
+};
+/** One resolved binding for each resource in a connector manifest. */
+type ResolvedTableBindings<Connector extends ConnectorDefinition> = Readonly<Record<ResourceName<Connector["resources"]>, ResolvedTableBinding>>;
+/** Loads and validates the complete hosted Wings table map for a connector. */
+declare const loadTableBindings: <const Connector extends ConnectorDefinition>(connector: Connector) => Effect.Effect<ResolvedTableBindings<Connector>, RuntimeConfigError>;
+declare namespace index_d_exports {
+  export { HostedTableBinding, PlatformRuntimeDefault, PlatformRuntimeKey, ResolvedTableBinding, ResolvedTableBindings, RuntimeConfigError, RuntimeConfigErrorCode, httpPort, layerHosted, loadTableBindings, wingsClient };
+}
+//#endregion
+export { loadTableBindings as a, PlatformRuntimeKey as c, RuntimeConfigError as d, RuntimeConfigErrorCode as f, ResolvedTableBindings as i, httpPort as l, HostedTableBinding as n, layerHosted as o, ResolvedTableBinding as r, PlatformRuntimeDefault as s, index_d_exports as t, wingsClient as u };
+//# sourceMappingURL=index-ZSuiZX5H.d.ts.map

package/dist/{index-J42AZaXU.d.ts → index-bfjH7Yb0.d.ts}

@@ -1,7 +1,7 @@
-import { t as ConnectorError } from "./index-D54ySAKn.js";
-import { l as ResourceDefinition, n as ConnectorDefinition, r as Cursor, x as WebhookRoute } from "./types-B35J5YPu.js";
-import { i as Publisher } from "./service-IE5qaf9x.js";
-import { i as StateStore } from "./index-Coh_SkBs.js";
+import { t as ConnectorError } from "./index-DKoRwyFn.js";
+import { l as ResourceDefinition, n as ConnectorDefinition, r as Cursor, x as WebhookRoute } from "./types-jVD5Ys43.js";
+import { i as Publisher } from "./service-CUjGhe-7.js";
+import { i as StateStore } from "./index-DYpEMJf-.js";
 import { Effect } from "effect";
 import { HttpRouter, HttpServer } from "effect/unstable/http";
 
@@ -35,4 +35,4 @@ declare namespace index_d_exports {
 }
 //#endregion
 export { RunOptions as n, run as r, index_d_exports as t };
-//# sourceMappingURL=index-J42AZaXU.d.ts.map
+//# sourceMappingURL=index-bfjH7Yb0.d.ts.map

package/dist/index.d.ts

@@ -1,14 +1,14 @@
-import { t as index_d_exports } from "./index-CTHVudvQ.js";
-import { t as ConnectorError } from "./index-D54ySAKn.js";
-import { S as WebhookRouteContext, _ as ResourceState, a as FetchChangesResult, b as WebhookHandler, c as ResourceBatch, d as ResourceMutation, g as ResourceSchema, h as ResourceRows, l as ResourceDefinition, m as ResourceRow, n as ConnectorDefinition, o as FetchPageResult, p as ResourcePayload, r as Cursor$1, s as PageFetch, t as ChangesFetch, u as ResourceField, x as WebhookRoute, y as WebhookAckMode } from "./types-B35J5YPu.js";
-import { a as telemetry_d_exports, c as Fetch, l as Resource, o as Connector, s as Cursor, t as index_d_exports$1 } from "./index-DtJX_tic.js";
-import "./service-IE5qaf9x.js";
-import { t as index_d_exports$6 } from "./index-Coh_SkBs.js";
-import { t as index_d_exports$2 } from "./index-J42AZaXU.js";
-import { t as index_d_exports$3 } from "./index-CBT-JX-T.js";
-import { g as metrics_d_exports } from "./metrics-CVAk1ALR.js";
-import { t as index_d_exports$4 } from "./index-Byr0Lf0C.js";
-import { t as index_d_exports$5 } from "./index-o1-Z3n7V.js";
-import { t as index_d_exports$7 } from "./index-Cq2IzY7T.js";
-import { t as index_d_exports$8 } from "./index-DKWIh6M1.js";
+import { t as index_d_exports } from "./index-DXa26Ry5.js";
+import { t as ConnectorError } from "./index-DKoRwyFn.js";
+import { S as WebhookRouteContext, _ as ResourceState, a as FetchChangesResult, b as WebhookHandler, c as ResourceBatch, d as ResourceMutation, g as ResourceSchema, h as ResourceRows, l as ResourceDefinition, m as ResourceRow, n as ConnectorDefinition, o as FetchPageResult, p as ResourcePayload, r as Cursor$1, s as PageFetch, t as ChangesFetch, u as ResourceField, x as WebhookRoute, y as WebhookAckMode } from "./types-jVD5Ys43.js";
+import { a as telemetry_d_exports, c as Fetch, l as Resource, o as Connector, s as Cursor, t as index_d_exports$1 } from "./index-C5Ma7V7t.js";
+import "./service-CUjGhe-7.js";
+import { t as index_d_exports$6 } from "./index-DYpEMJf-.js";
+import { t as index_d_exports$2 } from "./index-bfjH7Yb0.js";
+import { t as index_d_exports$3 } from "./index-CR9HJDdr.js";
+import { g as metrics_d_exports } from "./metrics-C4V1pm6v.js";
+import { t as index_d_exports$5 } from "./index-ZSuiZX5H.js";
+import { t as index_d_exports$4 } from "./index-BA8ASHKr.js";
+import { t as index_d_exports$7 } from "./index-VpHaZXZw.js";
+import { t as index_d_exports$8 } from "./index-BKw7jA2a.js";
 export { index_d_exports as Auth, ChangesFetch, Connector, index_d_exports$1 as ConnectorApp, ConnectorDefinition, ConnectorError, Cursor, Cursor$1 as CursorTypes, Fetch, FetchChangesResult, FetchPageResult, index_d_exports$2 as Ingestion, index_d_exports$3 as Manifest, metrics_d_exports as Metrics, PageFetch, index_d_exports$4 as Publisher, Resource, ResourceBatch, ResourceDefinition, ResourceField, ResourceMutation, ResourcePayload, ResourceRow, ResourceRows, ResourceSchema, ResourceState, index_d_exports$5 as RuntimeConfig, index_d_exports$6 as StateStore, index_d_exports$7 as Status, telemetry_d_exports as Telemetry, index_d_exports$8 as Webhook, WebhookAckMode, WebhookHandler, WebhookRoute, WebhookRouteContext };

package/dist/index.js

@@ -1,17 +1,19 @@
 import { t as ConnectorError } from "./errors-DHWylqRZ.js";
 import { t as auth_exports } from "./auth-DvU_CZ7C.js";
-import { t as connector_app_exports } from "./connector-app-d7Z-SZLQ.js";
-import { s as metrics_exports } from "./metrics-CWPy2Aqc.js";
-import "./constants-BRhIX_rz.js";
-import { c as telemetry_exports } from "./service-DuFiQwid.js";
-import "./server-CXTQ7odl.js";
-import { t as state_store_exports } from "./state-store-yl6LiTQ0.js";
-import { t as status_exports } from "./status-B-oZBc33.js";
-import { t as ingestion_exports } from "./ingestion-BQo4cbGw.js";
-import { t as manifest_exports } from "./manifest-ByE6YPG0.js";
-import { t as publisher_exports } from "./publisher-BYT3RLVO.js";
-import { t as runtime_config_exports } from "./runtime-config-BpB-d_bF.js";
-import { n as webhook_exports } from "./webhook-DI-Afxkg.js";
+import { t as connector_app_exports } from "./connector-app-BljHd0Pe.js";
+import "./constants-D113Ut1x.js";
+import { s as telemetry_exports } from "./telemetry-j_nxwYfh.js";
+import { s as metrics_exports } from "./metrics-inkCAxKq.js";
+import "./service-DiP-XETo.js";
+import "./server-D-eLX3yN.js";
+import { t as state_store_exports } from "./state-store-BdYulQOY.js";
+import { t as status_exports } from "./status-BTTd7AUR.js";
+import { t as ingestion_exports } from "./ingestion-QBGKrFr9.js";
+import { t as manifest_exports } from "./manifest-P7kBnch9.js";
+import { t as publisher_exports } from "./publisher-BdWJOfer.js";
+import "./table-bindings-Dp1DhTeS.js";
+import { t as runtime_config_exports } from "./runtime-config-IbyCVpei.js";
+import { n as webhook_exports } from "./webhook-MhFcLW-o.js";
 import { DateTime, Effect } from "effect";
 
 //#region src/core/builder.ts