@decaf-ts/integrations 0.10.8 → 0.12.0

package/lib/esm/feature-flags/EngineCapabilityFeatureFlag.service.js

@@ -0,0 +1,203 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var EngineCapabilityFeatureFlagService_1;
+/**
+ * @module integrations/feature-flags/EngineCapabilityFeatureFlag.service
+ * @summary Capability-derived feature-flag service (SAA-197, SAA-193 C22).
+ * @description A {@link FeatureFlagService} subclass whose flag values are derived
+ * exclusively from a served engine capability manifest — never from the
+ * environment and never from the persistence repository. Resolution is
+ * fail-closed: a feature that the manifest does not declare resolves to
+ * `false`/absent, so an undeclared feature is denied rather than admitted.
+ *
+ * The input is the same manifest shape the as-graph server serves (per engine:
+ * `engineId` plus `capabilities: [{ feature, verdict }]`), so no import of the
+ * as-graph package is required and the dependency direction is preserved.
+ */
+import { service } from "@decaf-ts/core";
+import { InternalError } from "@decaf-ts/db-decorators";
+import { FeatureFlag } from "./models/FeatureFlag.model.js";
+import { FeatureFlagReader } from "./readers/FeatureFlagReader.js";
+import { FeatureFlagService, } from "./services/FeatureFlag.service.js";
+import { isFeatureFlagEnabled, isFeatureFlagEnabledByName, normalizeFeatureName, } from "./utils.js";
+/** Pascal-cases a flag segment through the shared feature-name normalizer. */
+function pascalSegment(value) {
+    const normalized = normalizeFeatureName(value);
+    return normalized
+        ? normalized.charAt(0).toUpperCase() + normalized.slice(1)
+        : normalized;
+}
+/**
+ * Builds the canonical, collision-safe feature-flag key for an engine, or for one
+ * feature of an engine. Keys are `engine<Pascal(engineId)>` and
+ * `engine<Pascal(engineId)><Pascal(feature)>`; use this helper rather than
+ * assembling keys by hand.
+ *
+ * @param engineId - The engine id.
+ * @param feature - The feature name, when a feature key is wanted.
+ * @returns The canonical flag key.
+ */
+export function engineCapabilityFlagKey(engineId, feature) {
+    const engine = pascalSegment(engineId);
+    return feature === undefined
+        ? `engine${engine}`
+        : `engine${engine}${pascalSegment(feature)}`;
+}
+/**
+ * Derives a fail-closed feature-flag registry from an engine capability manifest:
+ * an engine key is enabled, and a feature key is enabled **only** when the engine
+ * declares that feature `SUPPORTED`. Features declared `NOT_SUPPORTED` or
+ * `EXTENSION_POINT`, and features absent from the manifest, are all disabled.
+ *
+ * @param manifest - The served engine capability manifest.
+ * @returns The derived flag registry.
+ */
+export function engineCapabilityFlagRegistry(manifest) {
+    const registry = {};
+    for (const engine of manifest.engines ?? []) {
+        registry[engineCapabilityFlagKey(engine.engineId)] = true;
+        for (const capability of engine.capabilities ?? []) {
+            registry[engineCapabilityFlagKey(engine.engineId, capability.feature)] =
+                capability.verdict === "SUPPORTED";
+        }
+    }
+    return registry;
+}
+/**
+ * A {@link FeatureFlagReader} over an already-derived capability registry. It
+ * never reads the environment; {@link FeatureFlagReader.read} returns a copy of the
+ * capability registry so the base service's reader plumbing stays satisfied.
+ */
+class EngineCapabilityFlagReader extends FeatureFlagReader {
+    /**
+     * @param registry - The capability-derived flag registry.
+     */
+    constructor(registry) {
+        super();
+        this.registry = registry;
+    }
+    /** Returns a copy of the capability registry, ignoring any reader input. */
+    async read(input) {
+        void input;
+        return { ...this.registry };
+    }
+}
+/**
+ * A {@link FeatureFlagService} whose values come from the served engine
+ * capability manifest. Every read path (`isEnabled`, `resolveFeatureFlags`,
+ * `isEnabledForSubject`, `resolveFeatureFlagsForSubject`) resolves against the
+ * derived registry only; a feature the manifest does not declare is denied.
+ * `syncFromEnvironment` is overridden to fail closed rather than read the
+ * environment.
+ *
+ * Carries its own `@service()` decorator: the parent {@link FeatureFlagService}
+ * is itself `@service(...)`-decorated, so without a decorator of its own the
+ * parent constructor's singleton wrapper would be returned and the capability
+ * methods below would be unreachable. Decorating the leaf subclass restores it;
+ * the subclass does not rely on the parent's environment/repository fields.
+ *
+ * The constructor additionally re-parents the constructed instance when the parent's
+ * singleton wrapper has already cached a `FeatureFlagService` (which would otherwise
+ * be returned through `super()`), so the capability methods stay reachable on every
+ * construction.
+ */
+let EngineCapabilityFeatureFlagService = EngineCapabilityFeatureFlagService_1 = class EngineCapabilityFeatureFlagService extends FeatureFlagService {
+    constructor() {
+        const base = super();
+        if (!(this instanceof EngineCapabilityFeatureFlagService_1)) {
+            return Object.assign(Object.create(EngineCapabilityFeatureFlagService_1.prototype), base, { capabilityRegistry: {} });
+        }
+        this.capabilityRegistry = {};
+    }
+    /**
+     * Initializes the service from its manifest, replacing the base service's
+     * environment/repository-backed registry with the capability-derived one. No
+     * environment source is read.
+     */
+    async initialize(...args) {
+        const config = args[0] ?? {};
+        if (config.repository) {
+            this._repository = config.repository;
+        }
+        this.capabilityRegistry = engineCapabilityFlagRegistry(config.manifest ?? { engines: [] });
+        const reader = new EngineCapabilityFlagReader(this.capabilityRegistry);
+        const effectiveConfig = {
+            ...config,
+            reader,
+            readerConfig: { ...(config.readerConfig ?? {}), source: {} },
+        };
+        return { config: effectiveConfig, client: reader };
+    }
+    /**
+     * Whether an engine is available in the manifest.
+     *
+     * @param engineId - The engine id to check.
+     * @returns `true` when the engine is declared.
+     */
+    isEngineEnabled(engineId) {
+        return isFeatureFlagEnabledByName(this.capabilityRegistry, engineCapabilityFlagKey(engineId));
+    }
+    /**
+     * Whether an engine declares a feature as `SUPPORTED`. An undeclared feature,
+     * or one declared `NOT_SUPPORTED`/`EXTENSION_POINT`, resolves `false`.
+     *
+     * @param engineId - The engine id to check.
+     * @param feature - The feature name to check.
+     * @returns `true` only when the manifest declares the feature `SUPPORTED`.
+     */
+    isEngineFeatureEnabled(engineId, feature) {
+        return isFeatureFlagEnabledByName(this.capabilityRegistry, engineCapabilityFlagKey(engineId, feature));
+    }
+    /** Resolves a flag from the capability registry; undeclared keys are denied. */
+    isEnabled(key) {
+        return isFeatureFlagEnabledByName(this.capabilityRegistry, key);
+    }
+    /** Returns a copy of the capability-derived registry. */
+    async resolveFeatureFlags() {
+        return { ...this.capabilityRegistry };
+    }
+    /** Returns a copy of the capability-derived registry (not subject-scoped). */
+    async resolveFeatureFlagsForSubject(subject, ...args) {
+        void subject;
+        void args;
+        return { ...this.capabilityRegistry };
+    }
+    /** Resolves a flag from the capability registry; undeclared keys are denied. */
+    async isEnabledForSubject(key, subject, ...args) {
+        void subject;
+        void args;
+        return isFeatureFlagEnabledByName(this.capabilityRegistry, key);
+    }
+    /** Lists the enabled capability flags as models, without touching a repository. */
+    async listEnabled(...args) {
+        void args;
+        return Object.entries(this.capabilityRegistry)
+            .filter(([, value]) => isFeatureFlagEnabled(value))
+            .map(([key]) => new FeatureFlag({
+            key,
+            enabled: true,
+            config: { enabled: true },
+        }));
+    }
+    /**
+     * Fails closed: capability flags are derived from the served engine manifest
+     * and are never synced from the environment.
+     */
+    async syncFromEnvironment(...args) {
+        void args;
+        throw new InternalError("Engine capability feature flags are derived from the served engine manifest and are never synced from the environment");
+    }
+};
+EngineCapabilityFeatureFlagService = EngineCapabilityFeatureFlagService_1 = __decorate([
+    service(),
+    __metadata("design:paramtypes", [])
+], EngineCapabilityFeatureFlagService);
+export { EngineCapabilityFeatureFlagService };
+//# sourceMappingURL=EngineCapabilityFeatureFlag.service.js.map

package/lib/esm/feature-flags/EngineCapabilityFeatureFlag.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EngineCapabilityFeatureFlag.service.js","sourceRoot":"","sources":["../../../src/feature-flags/EngineCapabilityFeatureFlag.service.ts"],"names":[],"mappings":"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"}

package/lib/esm/feature-flags/index.js

@@ -10,5 +10,6 @@ export * from "./models/FeatureFlag.model.js";
 export * from "./models/FeatureFlagAccess.model.js";
 export * from "./readers/index.js";
 export * from "./services/FeatureFlag.service.js";
+export * from "./EngineCapabilityFeatureFlag.service.js";
 export * from "./decorators.js";
 //# sourceMappingURL=index.js.map

package/lib/esm/feature-flags/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/feature-flags/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,+BAA4B;AAC5B,2BAAwB;AACxB,2BAAwB;AACxB,iCAA8B;AAC9B,8CAA2C;AAC3C,oDAAiD;AACjD,mCAA0B;AAC1B,kDAA+C;AAC/C,gCAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/feature-flags/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,+BAA4B;AAC5B,2BAAwB;AACxB,2BAAwB;AACxB,iCAA8B;AAC9B,8CAA2C;AAC3C,oDAAiD;AACjD,mCAA0B;AAC1B,kDAA+C;AAC/C,yDAAsD;AACtD,gCAA6B"}

package/lib/esm/feature-flags/models/FeatureFlag.model.js

@@ -7,6 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
+import { description } from "@decaf-ts/decoration";
 import { BaseModel } from "@decaf-ts/core";
 import { column, createdAt, pk, table, updatedAt, uuid, unique, } from "@decaf-ts/core";
 import { model, required } from "@decaf-ts/decorator-validation";
@@ -64,6 +65,7 @@ __decorate([
     __metadata("design:type", Date)
 ], FeatureFlag.prototype, "updatedAt", void 0);
 FeatureFlag = __decorate([
+    description("Persisted feature flag definition used for runtime evaluation"),
     table("feature_flags"),
     model(),
     __metadata("design:paramtypes", [Object])

package/lib/esm/feature-flags/models/FeatureFlag.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"FeatureFlag.model.js","sourceRoot":"","sources":["../../../../src/feature-flags/models/FeatureFlag.model.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EACL,MAAM,EACN,SAAS,EACT,EAAE,EACF,KAAK,EACL,SAAS,EACT,IAAI,EACJ,MAAM,GACP,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAK1D,IAAM,WAAW,GAAjB,MAAM,WAAY,SAAQ,SAAS;IACxC,YAAY,IAA2B;QACrC,KAAK,CAAC,IAAI,CAAC,CAAC;QAad,YAAO,GAAY,IAAI,CAAC;IAZxB,CAAC;CAqCF,CAAA;AAjCC;IAFC,EAAE,EAAE;IACJ,IAAI,EAAE;;uCACK;AAKZ;IAHC,MAAM,EAAE;IACR,QAAQ,EAAE;IACV,MAAM,EAAE;;wCACI;AAGb;IADC,MAAM,EAAE;;4CACe;AAGxB;IADC,MAAM,EAAE;;gDACY;AAGrB;IADC,MAAM,EAAE;;0CACM;AAGf;IADC,MAAM,EAAE;;6CAC0B;AAGnC;IADC,MAAM,EAAE;;2CACkB;AAG3B;IADC,MAAM,EAAE;;8CACU;AAGnB;IADC,MAAM,EAAE;;8CACU;AAGnB;IADC,SAAS,EAAE;8BACA,IAAI;8CAAC;AAGjB;IADC,SAAS,EAAE;8BACA,IAAI;8CAAC;AAvCN,WAAW;IAFvB,KAAK,CAAC,eAAe,CAAC;IACtB,KAAK,EAAE;;GACK,WAAW,CAwCvB"}
+{"version":3,"file":"FeatureFlag.model.js","sourceRoot":"","sources":["../../../../src/feature-flags/models/FeatureFlag.model.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EACL,MAAM,EACN,SAAS,EACT,EAAE,EACF,KAAK,EACL,SAAS,EACT,IAAI,EACJ,MAAM,GACP,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAM1D,IAAM,WAAW,GAAjB,MAAM,WAAY,SAAQ,SAAS;IACxC,YAAY,IAA2B;QACrC,KAAK,CAAC,IAAI,CAAC,CAAC;QAad,YAAO,GAAY,IAAI,CAAC;IAZxB,CAAC;CAqCF,CAAA;AAjCC;IAFC,EAAE,EAAE;IACJ,IAAI,EAAE;;uCACK;AAKZ;IAHC,MAAM,EAAE;IACR,QAAQ,EAAE;IACV,MAAM,EAAE;;wCACI;AAGb;IADC,MAAM,EAAE;;4CACe;AAGxB;IADC,MAAM,EAAE;;gDACY;AAGrB;IADC,MAAM,EAAE;;0CACM;AAGf;IADC,MAAM,EAAE;;6CAC0B;AAGnC;IADC,MAAM,EAAE;;2CACkB;AAG3B;IADC,MAAM,EAAE;;8CACU;AAGnB;IADC,MAAM,EAAE;;8CACU;AAGnB;IADC,SAAS,EAAE;8BACA,IAAI;8CAAC;AAGjB;IADC,SAAS,EAAE;8BACA,IAAI;8CAAC;AAvCN,WAAW;IAHvB,WAAW,CAAC,+DAA+D,CAAC;IAC5E,KAAK,CAAC,eAAe,CAAC;IACtB,KAAK,EAAE;;GACK,WAAW,CAwCvB"}

package/lib/esm/feature-flags/models/FeatureFlagAccess.model.js

@@ -7,6 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
+import { description } from "@decaf-ts/decoration";
 import { BaseModel } from "@decaf-ts/core";
 import { column, createdAt, pk, table, updatedAt, uuid } from "@decaf-ts/core";
 import { model, required } from "@decaf-ts/decorator-validation";
@@ -61,6 +62,7 @@ __decorate([
     __metadata("design:type", Date)
 ], FeatureFlagAccess.prototype, "updatedAt", void 0);
 FeatureFlagAccess = __decorate([
+    description("Persisted feature flag access rule for a subject"),
     table("feature_flag_access"),
     model(),
     __metadata("design:paramtypes", [Object])

package/lib/esm/feature-flags/models/FeatureFlagAccess.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"FeatureFlagAccess.model.js","sourceRoot":"","sources":["../../../../src/feature-flags/models/FeatureFlagAccess.model.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAK1D,IAAM,iBAAiB,GAAvB,MAAM,iBAAkB,SAAQ,SAAS;IAC9C,YAAY,IAAiC;QAC3C,KAAK,CAAC,IAAI,CAAC,CAAC;QAoBd,YAAO,GAAY,IAAI,CAAC;IAnBxB,CAAC;CAmCF,CAAA;AA/BC;IAFC,EAAE,EAAE;IACJ,IAAI,EAAE;;6CACK;AAIZ;IAFC,QAAQ,EAAE;IACV,MAAM,EAAE;;qDACW;AAIpB;IAFC,QAAQ,EAAE;IACV,MAAM,EAAE;;sDAC2C;AAIpD;IAFC,QAAQ,EAAE;IACV,MAAM,EAAE;;qDACW;AAGpB;IADC,MAAM,EAAE;;kDACe;AAGxB;IADC,MAAM,EAAE;;mDAC0B;AAGnC;IADC,MAAM,EAAE;;oDACU;AAGnB;IADC,MAAM,EAAE;;oDACU;AAGnB;IADC,SAAS,EAAE;8BACA,IAAI;oDAAC;AAGjB;IADC,SAAS,EAAE;8BACA,IAAI;oDAAC;AArCN,iBAAiB;IAF7B,KAAK,CAAC,qBAAqB,CAAC;IAC5B,KAAK,EAAE;;GACK,iBAAiB,CAsC7B"}
+{"version":3,"file":"FeatureFlagAccess.model.js","sourceRoot":"","sources":["../../../../src/feature-flags/models/FeatureFlagAccess.model.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAM1D,IAAM,iBAAiB,GAAvB,MAAM,iBAAkB,SAAQ,SAAS;IAC9C,YAAY,IAAiC;QAC3C,KAAK,CAAC,IAAI,CAAC,CAAC;QAoBd,YAAO,GAAY,IAAI,CAAC;IAnBxB,CAAC;CAmCF,CAAA;AA/BC;IAFC,EAAE,EAAE;IACJ,IAAI,EAAE;;6CACK;AAIZ;IAFC,QAAQ,EAAE;IACV,MAAM,EAAE;;qDACW;AAIpB;IAFC,QAAQ,EAAE;IACV,MAAM,EAAE;;sDAC2C;AAIpD;IAFC,QAAQ,EAAE;IACV,MAAM,EAAE;;qDACW;AAGpB;IADC,MAAM,EAAE;;kDACe;AAGxB;IADC,MAAM,EAAE;;mDAC0B;AAGnC;IADC,MAAM,EAAE;;oDACU;AAGnB;IADC,MAAM,EAAE;;oDACU;AAGnB;IADC,SAAS,EAAE;8BACA,IAAI;oDAAC;AAGjB;IADC,SAAS,EAAE;8BACA,IAAI;oDAAC;AArCN,iBAAiB;IAH7B,WAAW,CAAC,kDAAkD,CAAC;IAC/D,KAAK,CAAC,qBAAqB,CAAC;IAC5B,KAAK,EAAE;;GACK,iBAAiB,CAsC7B"}

package/lib/esm/index.js

@@ -6,8 +6,8 @@
 export * from "./utils.js";
 export * from "./namespaces/index.js";
 export * from "./feature-flags/index.js";
-export const VERSION = "0.10.7";
-export const COMMIT = "9f5df0a";
-export const FULL_VERSION = "0.10.7-9f5df0a";
+export const VERSION = "0.11.0";
+export const COMMIT = "004735e";
+export const FULL_VERSION = "0.11.0-004735e";
 export const PACKAGE_NAME = "@decaf-ts/integrations";
 //# sourceMappingURL=index.js.map

package/lib/esm/io/airtable/AirtableService.js

@@ -0,0 +1,261 @@
+/**
+ * @module integrations/io/airtable/service
+ * @summary Airtable Web API integration service for CRUD operations on base records.
+ * @description Exposes the Airtable v0 records API (list, get, create, update,
+ * delete) as an undecorated client-based service built on
+ * {@link HttpApiService}. Configuration comes from an explicit
+ * `AirtableServiceConfig` or the `io.airtable` environment slice; base
+ * targets default to the configured `baseId` and can be overridden per call.
+ * Failures are mapped to decaf errors via {@link httpError}.
+ */
+import { InternalError } from "@decaf-ts/db-decorators";
+import { IoEnvironment } from "./../environment.js";
+import { envNumber, envString } from "./../../shared/environmentValue.js";
+import { HttpApiService, httpError, } from "./../../shared/http/index.js";
+/**
+ * @description Airtable Web API integration service
+ * @summary An undecorated HTTP service for listing records
+ * with filtering, sorting, and cursor paging; fetching, creating, updating,
+ * and deleting individual records. Base targets resolve per call from the
+ * `baseId` argument, falling back to the configured value, and throw
+ * `InternalError` when unresolved. Every operation requires a token
+ * (`requireToken()`), and transport failures are mapped to decaf errors via
+ * {@link httpError}.
+ * @class AirtableService
+ * @category IO
+ * @example
+ * ```ts
+ * import { AirtableService } from "@decaf-ts/integrations/io/airtable";
+ *
+ * const airtable = new AirtableService();
+ * await airtable.initialize({
+ *   token: process.env.GRAPH_CREDENTIAL_AIRTABLE_TOKEN,
+ *   baseId: "appExampleBase",
+ * });
+ * const created = await airtable.createRecord({
+ *   table: "Tasks",
+ *   fields: { Name: "Ship release", Status: "Todo" },
+ * });
+ * ```
+ * @memberOf module:integrations/io/airtable/service
+ */
+export class AirtableService extends HttpApiService {
+    constructor() {
+        super(...arguments);
+        /**
+         * @description The provider name used in error messages
+         */
+        this.serviceName = "Airtable";
+    }
+    /**
+     * @description The Airtable Web API v0 base URL
+     * @summary Used when the resolved config carries no `baseUrl`.
+     * @returns {string} `"https://api.airtable.com/v0"`.
+     */
+    defaultBaseUrl() {
+        return "https://api.airtable.com/v0";
+    }
+    /**
+     * @description Builds the Airtable bearer authorization headers
+     * @summary Returns the `Authorization: Bearer <token>` header when the
+     * config carries a token, and no headers otherwise.
+     * @param {AirtableServiceConfig} config - The resolved service configuration.
+     * @returns {Record<string, string>} The authorization headers (empty without a token).
+     */
+    authHeaders(config) {
+        return config.token ? { Authorization: `Bearer ${config.token}` } : {};
+    }
+    /**
+     * @description Reads the Airtable credentials and defaults from the environment
+     * @summary Reads the `io.airtable` environment slice and returns a partial
+     * config when a token is configured, `undefined` otherwise. Values pass
+     * through `envString`/`envNumber` to reject unset-leaf proxies.
+     * @returns {Partial<AirtableServiceConfig> | undefined} A partial config, or `undefined` when no Airtable token is configured.
+     */
+    configFromEnvironment() {
+        const env = IoEnvironment.io.airtable;
+        const token = envString(env?.token);
+        if (!token)
+            return undefined;
+        return {
+            token,
+            baseId: envString(env.baseId),
+            baseUrl: envString(env.baseUrl),
+            timeout: envNumber(env.timeout),
+        };
+    }
+    /**
+     * @description Resolves the URL-encoded base path for a call
+     * @summary Builds `/<baseId>` from the given base ID, falling back to the
+     * configured value, and throws when neither is available.
+     * @param {string} [baseId] - The per-call base override.
+     * @returns {string} The URL-encoded base API path.
+     * @throws {InternalError} When neither the input nor the config yields a base ID.
+     */
+    basePath(baseId) {
+        const resolved = baseId ?? this.config.baseId;
+        if (!resolved) {
+            throw new InternalError("Airtable requires a base ID");
+        }
+        return `/${encodeURIComponent(resolved)}`;
+    }
+    /**
+     * @description Resolves the URL-encoded table path for a call
+     * @summary Builds `<basePath>/<table>` with both segments URL-encoded, and
+     * throws when the table name is empty (or the base cannot be resolved).
+     * @param {string} table - The table name or ID.
+     * @param {string} [baseId] - The per-call base override.
+     * @returns {string} The URL-encoded table API path.
+     * @throws {InternalError} When the table name is empty or the base ID cannot be resolved.
+     */
+    tablePath(table, baseId) {
+        if (!table)
+            throw new InternalError("Airtable requires a table name");
+        return `${this.basePath(baseId)}/${encodeURIComponent(table)}`;
+    }
+    /**
+     * @description Lists records in an Airtable table with cursor paging
+     * @summary `GET`s the table endpoint with the configured view, formula
+     * filter, record caps, page size, page offset, field projection, and first
+     * sort entry. Return the `offset` cursor as the next call's
+     * `AirtableListOptions.offset` to fetch further pages.
+     * @param {AirtableListOptions} options - The table and filter/sort/paging options.
+     * @param {string} [baseId] - The base override; falls back to the configured `baseId`.
+     * @returns {Promise<AirtableListResult>} The page of records and the next offset cursor when more pages exist.
+     * @throws {InternalError} When no token is configured or the table/base cannot be resolved.
+     * @throws {NotFoundError} When the base or table does not exist (HTTP 404).
+     * @throws {ConflictError} When Airtable answers with HTTP 409.
+     * @throws {BadRequestError} When Airtable answers with any other HTTP error status (e.g. invalid formula).
+     * @example
+     * ```ts
+     * let offset: string | undefined;
+     * do {
+     *   const page = await airtable.listRecords({
+     *     table: "Tasks",
+     *     filterByFormula: "{Status} = 'Active'",
+     *     pageSize: 100,
+     *     offset,
+     *     sort: [{ field: "Name", direction: "asc" }],
+     *   });
+     *   console.log(page.records);
+     *   offset = page.offset;
+     * } while (offset);
+     * ```
+     */
+    async listRecords(options, baseId) {
+        this.requireToken();
+        try {
+            const response = await this.client.get(this.tablePath(options.table, baseId), {
+                params: {
+                    view: options.view,
+                    filterByFormula: options.filterByFormula,
+                    maxRecords: options.maxRecords,
+                    pageSize: options.pageSize,
+                    offset: options.offset,
+                    "fields[]": options.fields,
+                    "sort[0][field]": options.sort?.[0]?.field,
+                    "sort[0][direction]": options.sort?.[0]?.direction,
+                },
+            });
+            return {
+                records: response.data.records ?? [],
+                offset: response.data.offset,
+            };
+        }
+        catch (error) {
+            throw httpError("Airtable", "list records", error);
+        }
+    }
+    /**
+     * @description Fetches a single Airtable record
+     * @summary `GET`s the table endpoint with the record ID appended and
+     * returns the record envelope.
+     * @param {string} table - The table name or ID.
+     * @param {string} recordId - The record ID to fetch (e.g. `"rec1234567890"`).
+     * @param {string} [baseId] - The base override; falls back to the configured `baseId`.
+     * @returns {Promise<AirtableRecord>} The record envelope.
+     * @throws {InternalError} When no token is configured or the table/base cannot be resolved.
+     * @throws {NotFoundError} When the record does not exist (HTTP 404).
+     * @throws {ConflictError} When Airtable answers with HTTP 409.
+     * @throws {BadRequestError} When Airtable answers with any other HTTP error status.
+     */
+    async getRecord(table, recordId, baseId) {
+        this.requireToken();
+        try {
+            const response = await this.client.get(`${this.tablePath(table, baseId)}/${encodeURIComponent(recordId)}`);
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Airtable", "get record", error);
+        }
+    }
+    /**
+     * @description Creates an Airtable record
+     * @summary `POST`s the fields map to the table endpoint; `typecast` lets
+     * Airtable coerce values into the column types (disabled by default).
+     * @param {AirtableWriteInput} input - The table, fields, and typecast option.
+     * @param {string} [baseId] - The base override; falls back to the configured `baseId`.
+     * @returns {Promise<AirtableRecord>} The created record envelope.
+     * @throws {InternalError} When no token is configured or the table/base cannot be resolved.
+     * @throws {NotFoundError} When the base or table does not exist (HTTP 404).
+     * @throws {ConflictError} When Airtable answers with HTTP 409.
+     * @throws {BadRequestError} When Airtable answers with any other HTTP error status (e.g. invalid field values).
+     */
+    async createRecord(input, baseId) {
+        this.requireToken();
+        try {
+            const response = await this.client.post(this.tablePath(input.table, baseId), { fields: input.fields, typecast: input.typecast ?? false });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Airtable", "create record", error);
+        }
+    }
+    /**
+     * @description Updates an Airtable record
+     * @summary `PATCH`es the fields map onto the record identified by
+     * `recordId`; only the provided fields change. `typecast` lets Airtable
+     * coerce values into the column types (disabled by default).
+     * @param {AirtableWriteInput & {recordId: string}} input - The table, fields, typecast option, and target record ID.
+     * @param {string} [baseId] - The base override; falls back to the configured `baseId`.
+     * @returns {Promise<AirtableRecord>} The updated record envelope.
+     * @throws {InternalError} When no token is configured or the table/base cannot be resolved.
+     * @throws {NotFoundError} When the record does not exist (HTTP 404).
+     * @throws {ConflictError} When Airtable answers with HTTP 409.
+     * @throws {BadRequestError} When Airtable answers with any other HTTP error status (e.g. invalid field values).
+     */
+    async updateRecord(input, baseId) {
+        this.requireToken();
+        try {
+            const response = await this.client.patch(`${this.tablePath(input.table, baseId)}/${encodeURIComponent(input.recordId)}`, { fields: input.fields, typecast: input.typecast ?? false });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Airtable", "update record", error);
+        }
+    }
+    /**
+     * @description Deletes an Airtable record
+     * @summary `DELETE`s the record identified by `recordId` and returns the
+     * Airtable deletion confirmation.
+     * @param {string} table - The table name or ID.
+     * @param {string} recordId - The record ID to delete.
+     * @param {string} [baseId] - The base override; falls back to the configured `baseId`.
+     * @returns {Promise<{id: string, deleted: boolean}>} The deleted record's ID and Airtable's `deleted` confirmation.
+     * @throws {InternalError} When no token is configured or the table/base cannot be resolved.
+     * @throws {NotFoundError} When the record does not exist (HTTP 404).
+     * @throws {ConflictError} When Airtable answers with HTTP 409.
+     * @throws {BadRequestError} When Airtable answers with any other HTTP error status.
+     */
+    async deleteRecord(table, recordId, baseId) {
+        this.requireToken();
+        try {
+            const response = await this.client.delete(`${this.tablePath(table, baseId)}/${encodeURIComponent(recordId)}`);
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Airtable", "delete record", error);
+        }
+    }
+}
+//# sourceMappingURL=AirtableService.js.map

package/lib/esm/io/airtable/AirtableService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AirtableService.js","sourceRoot":"","sources":["../../../../src/io/airtable/AirtableService.ts"],"names":[],"mappings":"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"}

package/lib/esm/io/airtable/index.js

@@ -0,0 +1,7 @@
+/**
+ * @module integrations/io/airtable
+ * @summary Airtable Web API service (record CRUD).
+ * @description Re-exports the Airtable client-based service and its types.
+ */
+export * from "./AirtableService.js";
+//# sourceMappingURL=index.js.map

package/lib/esm/io/airtable/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/io/airtable/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qCAAkC"}

package/lib/esm/io/environment.js

@@ -0,0 +1,42 @@
+import { LoggedEnvironment } from "@decaf-ts/logging";
+/**
+ * @description Accumulated io environment singleton
+ * @summary The `LoggedEnvironment.accumulate`-registered instance backing the
+ * `IoEnvironmentShape` contract. IO services read their provider slice
+ * (e.g. `IoEnvironment.io.airtable`) inside `configFromEnvironment()` and
+ * translate it into an `HttpApiServiceConfig`-derived config. Credentials
+ * come from environment variables; for as-graph node usage those are provided
+ * as `GRAPH_CREDENTIAL_*` values (placeholders in this example).
+ * @example
+ * ```ts
+ * import { AirtableService } from "@decaf-ts/integrations/io/airtable";
+ *
+ * // with io.airtable.token / io.airtable.baseId configured in the environment
+ * const airtable = new AirtableService();
+ * await airtable.initialize();
+ * ```
+ * @constant {LoggedEnvironment} IoEnvironment
+ * @memberOf module:integrations/io/environment
+ */
+export const IoEnvironment = LoggedEnvironment.accumulate({
+    io: {
+        airtable: {
+            token: "",
+            baseUrl: "",
+            baseId: "",
+            timeout: undefined,
+        },
+        googleSheets: {
+            token: "",
+            apiKey: "",
+            baseUrl: "",
+            timeout: undefined,
+        },
+        graphql: {
+            endpoint: "",
+            token: "",
+            timeout: undefined,
+        },
+    },
+});
+//# sourceMappingURL=environment.js.map

package/lib/esm/io/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../src/io/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AA8CtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,iBAAiB,CAAC,UAAU,CAAC;IACxD,EAAE,EAAE;QACF,QAAQ,EAAE;YACR,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,SAA8B;SACxC;QACD,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,SAA8B;SACxC;QACD,OAAO,EAAE;YACP,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,SAA8B;SACxC;KACF;CACoB,CAAC,CAAC"}