typekro 0.33.9 → 0.34.0

package/dist/factories/gateway-api/readiness.js

@@ -0,0 +1,213 @@
+/**
+ * Shared Gateway API readiness evaluators.
+ *
+ * Every Gateway API controller publishes the same condition vocabulary
+ * (`Accepted`, `Programmed`, `ResolvedRefs`) with `observedGeneration`, so the
+ * freshness logic belongs in one place rather than once per implementation.
+ *
+ * Extracted from `src/factories/envoy-ai-gateway/resources/gateway.ts` (#176).
+ * The envoy-ai-gateway evaluators now delegate here and keep their original
+ * portable-strategy identifiers so existing plans stay resolvable.
+ */
+import { identifyPortableReadinessEvaluator, registerPortableReadinessEvaluator, registerPortableReadinessStrategy, } from '../../core/readiness/index.js';
+import { readinessConfiguration, readinessLiteral, requiredReadinessString, } from '../../core/readiness/strategy-configuration.js';
+import { GATEWAY_API_ACCEPTED_CONDITION, GATEWAY_API_PROGRAMMED_CONDITION, GATEWAY_API_RESOLVED_REFS_CONDITION, } from './constants.js';
+const READINESS_REVISION = '1';
+const ACCEPTED_STRATEGY = 'typekro.readiness.gateway-api.accepted';
+const GATEWAY_CLASS_STRATEGY = 'typekro.readiness.gateway-api.gateway-class';
+const GATEWAY_STRATEGY = 'typekro.readiness.gateway-api.gateway';
+const ROUTE_STRATEGY = 'typekro.readiness.gateway-api.route';
+const POLICY_STRATEGY = 'typekro.readiness.gateway-api.policy';
+/**
+ * Whether a condition describes the resource's current generation.
+ *
+ * Some controllers (notably Envoy AI Gateway v0.6 on its v1beta1 resources)
+ * emit Condition-shaped entries without `observedGeneration`. Preserve strict
+ * freshness whenever the controller supplies it, while accepting the
+ * controller's documented sparse condition shape when it cannot.
+ */
+export function gatewayApiConditionIsCurrent(condition, generation) {
+    if (generation === undefined)
+        return true;
+    return condition?.observedGeneration === undefined || condition.observedGeneration === generation;
+}
+/**
+ * Generic condition readiness for Gateway API resources.
+ *
+ * @param liveResource - The observed cluster resource.
+ * @param acceptedType - Condition type that must be `True` for readiness.
+ * @param rejectedTypes - Condition types whose `True` state is a hard rejection.
+ */
+export function gatewayApiConditionReadiness(liveResource, acceptedType, rejectedTypes) {
+    const resource = liveResource;
+    const conditions = resource?.status?.conditions ?? [];
+    const generation = resource?.metadata?.generation;
+    const rejected = conditions.find((condition) => rejectedTypes.includes(condition.type) &&
+        condition.status === 'True' &&
+        gatewayApiConditionIsCurrent(condition, generation));
+    if (rejected) {
+        return {
+            ready: false,
+            reason: rejected.reason ?? rejected.type,
+            message: rejected.message ?? `${rejected.type} is True`,
+        };
+    }
+    const accepted = conditions.find((condition) => condition.type === acceptedType);
+    const current = gatewayApiConditionIsCurrent(accepted, generation);
+    if (accepted?.status === 'True' && current) {
+        return {
+            ready: true,
+            reason: accepted.reason ?? acceptedType,
+            message: accepted.message ?? `${acceptedType} is True`,
+        };
+    }
+    return {
+        ready: false,
+        reason: accepted?.reason ?? 'Reconciling',
+        message: accepted?.message ??
+            `${acceptedType} has not been observed for the current resource generation`,
+    };
+}
+/**
+ * Readiness for any Gateway API resource that publishes a top-level `Accepted`
+ * condition and signals rejection with `NotAccepted`.
+ */
+export const gatewayApiAcceptedReadinessEvaluator = registerPortableReadinessEvaluator(ACCEPTED_STRATEGY, READINESS_REVISION, (liveResource) => gatewayApiConditionReadiness(liveResource, GATEWAY_API_ACCEPTED_CONDITION, ['NotAccepted']));
+/**
+ * Readiness for `GatewayClass`: the controller sets `Accepted=True` once it has
+ * claimed the class. There is no negative condition type in the spec.
+ */
+export const gatewayApiGatewayClassReadinessEvaluator = registerPortableReadinessEvaluator(GATEWAY_CLASS_STRATEGY, READINESS_REVISION, (liveResource) => gatewayApiConditionReadiness(liveResource, GATEWAY_API_ACCEPTED_CONDITION, []));
+/**
+ * Readiness for `Gateway`: both `Accepted` (configuration is valid) and
+ * `Programmed` (the data plane serves it) must be `True` for the current
+ * generation. Either condition reported `False` is a not-ready answer with the
+ * controller's own reason.
+ */
+export const gatewayApiGatewayReadinessEvaluator = registerPortableReadinessEvaluator(GATEWAY_STRATEGY, READINESS_REVISION, (liveResource) => {
+    const resource = liveResource;
+    const conditions = resource?.status?.conditions ?? [];
+    const generation = resource?.metadata?.generation;
+    const rejected = conditions.find((condition) => [GATEWAY_API_ACCEPTED_CONDITION, GATEWAY_API_PROGRAMMED_CONDITION].includes(condition.type) &&
+        condition.status === 'False' &&
+        gatewayApiConditionIsCurrent(condition, generation));
+    if (rejected) {
+        return {
+            ready: false,
+            reason: rejected.reason ?? `${rejected.type}False`,
+            message: rejected.message ?? `${rejected.type} is False`,
+        };
+    }
+    const accepted = conditions.find((condition) => condition.type === GATEWAY_API_ACCEPTED_CONDITION);
+    const programmed = conditions.find((condition) => condition.type === GATEWAY_API_PROGRAMMED_CONDITION);
+    const ready = accepted?.status === 'True' &&
+        programmed?.status === 'True' &&
+        gatewayApiConditionIsCurrent(accepted, generation) &&
+        gatewayApiConditionIsCurrent(programmed, generation);
+    return ready
+        ? {
+            ready: true,
+            reason: 'GatewayProgrammed',
+            message: programmed.message ?? 'Gateway is accepted and programmed',
+        }
+        : {
+            ready: false,
+            reason: programmed?.reason ?? accepted?.reason ?? 'GatewayProgressing',
+            message: programmed?.message ??
+                accepted?.message ??
+                'Gateway is waiting to be accepted and programmed',
+        };
+});
+/**
+ * Readiness for `HTTPRoute` / `GRPCRoute`: at least one claimed parent must
+ * report `Accepted=True` and `ResolvedRefs` must not be `False`.
+ *
+ * A route with no `parents` entry has not been picked up by any controller yet,
+ * which is not-ready rather than ready.
+ */
+export const gatewayApiRouteReadinessEvaluator = registerPortableReadinessEvaluator(ROUTE_STRATEGY, READINESS_REVISION, (liveResource) => {
+    const resource = liveResource;
+    const generation = resource?.metadata?.generation;
+    const parents = resource?.status?.parents ?? [];
+    const conditions = parents.flatMap((parent) => parent.conditions ?? []);
+    const rejected = conditions.find((condition) => (condition.type === GATEWAY_API_ACCEPTED_CONDITION ||
+        condition.type === GATEWAY_API_RESOLVED_REFS_CONDITION) &&
+        condition.status === 'False' &&
+        gatewayApiConditionIsCurrent(condition, generation));
+    if (rejected) {
+        return {
+            ready: false,
+            reason: rejected.reason ?? `${rejected.type}False`,
+            message: rejected.message ?? `${rejected.type} is False`,
+        };
+    }
+    const accepted = conditions.find((condition) => condition.type === GATEWAY_API_ACCEPTED_CONDITION &&
+        condition.status === 'True' &&
+        gatewayApiConditionIsCurrent(condition, generation));
+    return accepted
+        ? {
+            ready: true,
+            reason: accepted.reason ?? GATEWAY_API_ACCEPTED_CONDITION,
+            message: accepted.message ?? 'Route is accepted by its parent Gateway',
+        }
+        : {
+            ready: false,
+            reason: 'Reconciling',
+            message: 'Route has not been accepted for the current resource generation',
+        };
+});
+function policyReadiness(liveResource, controllerName) {
+    const resource = liveResource;
+    const generation = resource?.metadata?.generation;
+    const conditions = (resource?.status?.ancestors ?? [])
+        .filter((ancestor) => ancestor.controllerName === controllerName)
+        .flatMap((ancestor) => ancestor.conditions ?? []);
+    const rejected = conditions.find((condition) => ((condition.type === GATEWAY_API_ACCEPTED_CONDITION && condition.status === 'False') ||
+        (condition.type === GATEWAY_API_RESOLVED_REFS_CONDITION && condition.status === 'False')) &&
+        gatewayApiConditionIsCurrent(condition, generation));
+    if (rejected) {
+        return {
+            ready: false,
+            terminal: true,
+            reason: rejected.reason ?? `${rejected.type}False`,
+            message: rejected.message ?? `${rejected.type} is False`,
+        };
+    }
+    const accepted = conditions.find((condition) => condition.type === GATEWAY_API_ACCEPTED_CONDITION &&
+        condition.status === 'True' &&
+        gatewayApiConditionIsCurrent(condition, generation));
+    return accepted
+        ? {
+            ready: true,
+            reason: accepted.reason ?? GATEWAY_API_ACCEPTED_CONDITION,
+            message: accepted.message ?? 'Policy is accepted',
+        }
+        : {
+            ready: false,
+            reason: 'Reconciling',
+            message: 'Policy has not been accepted for the current resource generation',
+        };
+}
+/**
+ * Build a readiness evaluator for a Gateway API policy attachment.
+ *
+ * Policies report conditions per ancestor, and a cluster can run several
+ * Gateway API controllers, so only the ancestors claimed by `controllerName`
+ * are considered.
+ *
+ * @param controllerName - The `GatewayClass.spec.controllerName` whose
+ *   ancestor conditions are authoritative for this policy.
+ */
+export function createGatewayApiPolicyReadinessEvaluator(controllerName) {
+    const evaluator = (liveResource) => policyReadiness(liveResource, controllerName);
+    return identifyPortableReadinessEvaluator(evaluator, {
+        kind: 'registered',
+        id: POLICY_STRATEGY,
+        revision: READINESS_REVISION,
+        configuration: readinessConfiguration({
+            controllerName: readinessLiteral(controllerName),
+        }),
+    });
+}
+registerPortableReadinessStrategy(POLICY_STRATEGY, READINESS_REVISION, (configuration) => createGatewayApiPolicyReadinessEvaluator(requiredReadinessString(configuration, 'controllerName')));
+//# sourceMappingURL=readiness.js.map

package/dist/factories/gateway-api/readiness.js.map

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

package/dist/factories/gateway-api/resources/gateway.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Upstream Gateway API resource factories.
+ *
+ * Vendor-neutral by design: the only implementation-specific input is the
+ * `GatewayClass.spec.controllerName` a caller supplies. Envoy AI Gateway and
+ * Traefik both build on these (#176).
+ */
+import type { Composable, Enhanced } from '../../../core/types/index.js';
+import type { AcceptedResourceStatus, BackendTLSPolicyConfig, BackendTLSPolicySpec, GatewayApiClusterResourceMetadata, GatewayApiNamespacedResourceMetadata, GatewayClassSpec, GatewayObservedStatus, GatewayPolicyObservedStatus, GatewaySpec, GRPCRouteSpec, HTTPRouteSpec, ReferenceGrantSpec, RouteObservedStatus } from '../types.js';
+/**
+ * `backendTLSPolicy`'s configuration type.
+ *
+ * DECLARED in `../types.js`, next to the ArkType schema it is inferred from,
+ * and re-exported here so the public import path stays
+ * `resources/gateway.js`.
+ */
+export type { BackendTLSPolicyConfig } from '../types.js';
+/**
+ * Configuration for a namespaced Gateway API resource.
+ *
+ * Nothing here is hand-written. The identity half is
+ * {@link GatewayApiNamespacedResourceMetadata}, inferred from its ArkType
+ * schema; `spec` stays a TYPE PARAMETER because it is a different schema per
+ * kind — `GatewaySpec`, `HTTPRouteSpec`, `GRPCRouteSpec`,
+ * `ReferenceGrantSpec` — each already inferred from its own schema, so the
+ * caller binds it rather than this file re-declaring any of them.
+ */
+export type GatewayApiNamespacedResourceConfig<TSpec extends object> = GatewayApiNamespacedResourceMetadata & {
+    readonly spec: TSpec;
+};
+/**
+ * Configuration for a cluster-scoped Gateway API resource.
+ *
+ * Same split as {@link GatewayApiNamespacedResourceConfig}, without a
+ * namespace.
+ */
+export type GatewayApiClusterResourceConfig<TSpec extends object> = GatewayApiClusterResourceMetadata & {
+    readonly spec: TSpec;
+};
+/**
+ * Create a cluster-scoped Gateway API `GatewayClass`.
+ *
+ * Ready once the controller named by `spec.controllerName` reports
+ * `Accepted=True` for the current generation.
+ *
+ * @example
+ * ```typescript
+ * gatewayClass({
+ *   name: 'traefik',
+ *   spec: { controllerName: 'traefik.io/gateway-controller' },
+ * });
+ * ```
+ */
+export declare function gatewayClass<TController extends string = string>(config: Composable<GatewayApiClusterResourceConfig<GatewayClassSpec<TController>>>): Enhanced<GatewayClassSpec<TController>, AcceptedResourceStatus>;
+/**
+ * Create a Gateway API `Gateway`.
+ *
+ * Ready once the controller reports both `Accepted=True` and `Programmed=True`
+ * for the current generation.
+ */
+export declare function gateway(config: Composable<GatewayApiNamespacedResourceConfig<GatewaySpec>>): Enhanced<GatewaySpec, GatewayObservedStatus>;
+/**
+ * Create a Gateway API `HTTPRoute`.
+ *
+ * Ready once at least one claimed parent reports `Accepted=True` and no parent
+ * reports `ResolvedRefs=False`.
+ */
+export declare function httpRoute(config: Composable<GatewayApiNamespacedResourceConfig<HTTPRouteSpec>>): Enhanced<HTTPRouteSpec, RouteObservedStatus>;
+/**
+ * Create a Gateway API `GRPCRoute`.
+ *
+ * Shares the route readiness contract with {@link httpRoute}.
+ */
+export declare function grpcRoute(config: Composable<GatewayApiNamespacedResourceConfig<GRPCRouteSpec>>): Enhanced<GRPCRouteSpec, RouteObservedStatus>;
+/**
+ * Create a Gateway API `ReferenceGrant`.
+ *
+ * `ReferenceGrant` carries no `status` subresource — it is pure authorization
+ * data consumed by controllers — so it is registered as always-ready rather
+ * than waiting forever for conditions that will never appear.
+ */
+export declare function referenceGrant(config: Composable<GatewayApiNamespacedResourceConfig<ReferenceGrantSpec>>): Enhanced<ReferenceGrantSpec, Record<string, never>>;
+/**
+ * Create a Gateway API `BackendTLSPolicy`.
+ *
+ * Ready once the ancestor entry belonging to `controllerName` reports
+ * `Accepted=True`; an explicit `Accepted=False` / `ResolvedRefs=False` is
+ * terminal because a rejected policy will not self-heal.
+ */
+export declare function backendTLSPolicy(config: Composable<BackendTLSPolicyConfig>): Enhanced<BackendTLSPolicySpec, GatewayPolicyObservedStatus>;
+//# sourceMappingURL=gateway.d.ts.map

package/dist/factories/gateway-api/resources/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../../../src/factories/gateway-api/resources/gateway.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAazE,OAAO,KAAK,EACV,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,iCAAiC,EACjC,oCAAoC,EACpC,gBAAgB,EAChB,qBAAqB,EACrB,2BAA2B,EAC3B,WAAW,EACX,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAErB;;;;;;GAMG;AACH,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D;;;;;;;;;GASG;AACH,MAAM,MAAM,kCAAkC,CAAC,KAAK,SAAS,MAAM,IACjE,oCAAoC,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC;AAElE;;;;;GAKG;AACH,MAAM,MAAM,+BAA+B,CAAC,KAAK,SAAS,MAAM,IAC9D,iCAAiC,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC;AAqB/D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,WAAW,SAAS,MAAM,GAAG,MAAM,EAC9D,MAAM,EAAE,UAAU,CAAC,+BAA+B,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,GACjF,QAAQ,CAAC,gBAAgB,CAAC,WAAW,CAAC,EAAE,sBAAsB,CAAC,CAejE;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,MAAM,EAAE,UAAU,CAAC,kCAAkC,CAAC,WAAW,CAAC,CAAC,GAClE,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAK9C;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,UAAU,CAAC,kCAAkC,CAAC,aAAa,CAAC,CAAC,GACpE,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAK9C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,UAAU,CAAC,kCAAkC,CAAC,aAAa,CAAC,CAAC,GACpE,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAK9C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,UAAU,CAAC,kCAAkC,CAAC,kBAAkB,CAAC,CAAC,GACzE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAKrD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,UAAU,CAAC,sBAAsB,CAAC,GACzC,QAAQ,CAAC,oBAAoB,EAAE,2BAA2B,CAAC,CAK7D"}

package/dist/factories/gateway-api/resources/gateway.js

@@ -0,0 +1,99 @@
+/**
+ * Upstream Gateway API resource factories.
+ *
+ * Vendor-neutral by design: the only implementation-specific input is the
+ * `GatewayClass.spec.controllerName` a caller supplies. Envoy AI Gateway and
+ * Traefik both build on these (#176).
+ */
+import { createAlwaysReadyEvaluator } from '../../../core/readiness/evaluator-factories.js';
+import { createResource } from '../../shared.js';
+import { GATEWAY_API_REFERENCE_GRANT_VERSION, GATEWAY_API_TLS_POLICY_VERSION, GATEWAY_API_VERSION, } from '../constants.js';
+import { createGatewayApiPolicyReadinessEvaluator, gatewayApiGatewayClassReadinessEvaluator, gatewayApiGatewayReadinessEvaluator, gatewayApiRouteReadinessEvaluator, } from '../readiness.js';
+function namespacedDefinition(apiVersion, kind, config) {
+    return {
+        apiVersion,
+        kind,
+        metadata: {
+            name: config.name,
+            namespace: config.namespace,
+            ...(config.labels ? { labels: { ...config.labels } } : {}),
+            ...(config.annotations ? { annotations: { ...config.annotations } } : {}),
+        },
+        spec: config.spec,
+        ...(config.id ? { id: config.id } : {}),
+    };
+}
+/**
+ * Create a cluster-scoped Gateway API `GatewayClass`.
+ *
+ * Ready once the controller named by `spec.controllerName` reports
+ * `Accepted=True` for the current generation.
+ *
+ * @example
+ * ```typescript
+ * gatewayClass({
+ *   name: 'traefik',
+ *   spec: { controllerName: 'traefik.io/gateway-controller' },
+ * });
+ * ```
+ */
+export function gatewayClass(config) {
+    return createResource({
+        apiVersion: GATEWAY_API_VERSION,
+        kind: 'GatewayClass',
+        metadata: {
+            name: config.name,
+            ...(config.labels ? { labels: { ...config.labels } } : {}),
+            ...(config.annotations ? { annotations: { ...config.annotations } } : {}),
+        },
+        spec: config.spec,
+        ...(config.id ? { id: config.id } : {}),
+    }, { scope: 'cluster' }).withReadinessEvaluator(gatewayApiGatewayClassReadinessEvaluator);
+}
+/**
+ * Create a Gateway API `Gateway`.
+ *
+ * Ready once the controller reports both `Accepted=True` and `Programmed=True`
+ * for the current generation.
+ */
+export function gateway(config) {
+    return createResource(namespacedDefinition(GATEWAY_API_VERSION, 'Gateway', config), { scope: 'namespaced' }).withReadinessEvaluator(gatewayApiGatewayReadinessEvaluator);
+}
+/**
+ * Create a Gateway API `HTTPRoute`.
+ *
+ * Ready once at least one claimed parent reports `Accepted=True` and no parent
+ * reports `ResolvedRefs=False`.
+ */
+export function httpRoute(config) {
+    return createResource(namespacedDefinition(GATEWAY_API_VERSION, 'HTTPRoute', config), { scope: 'namespaced' }).withReadinessEvaluator(gatewayApiRouteReadinessEvaluator);
+}
+/**
+ * Create a Gateway API `GRPCRoute`.
+ *
+ * Shares the route readiness contract with {@link httpRoute}.
+ */
+export function grpcRoute(config) {
+    return createResource(namespacedDefinition(GATEWAY_API_VERSION, 'GRPCRoute', config), { scope: 'namespaced' }).withReadinessEvaluator(gatewayApiRouteReadinessEvaluator);
+}
+/**
+ * Create a Gateway API `ReferenceGrant`.
+ *
+ * `ReferenceGrant` carries no `status` subresource — it is pure authorization
+ * data consumed by controllers — so it is registered as always-ready rather
+ * than waiting forever for conditions that will never appear.
+ */
+export function referenceGrant(config) {
+    return createResource(namespacedDefinition(GATEWAY_API_REFERENCE_GRANT_VERSION, 'ReferenceGrant', config), { scope: 'namespaced' }).withReadinessEvaluator(createAlwaysReadyEvaluator('ReferenceGrant'));
+}
+/**
+ * Create a Gateway API `BackendTLSPolicy`.
+ *
+ * Ready once the ancestor entry belonging to `controllerName` reports
+ * `Accepted=True`; an explicit `Accepted=False` / `ResolvedRefs=False` is
+ * terminal because a rejected policy will not self-heal.
+ */
+export function backendTLSPolicy(config) {
+    return createResource(namespacedDefinition(GATEWAY_API_TLS_POLICY_VERSION, 'BackendTLSPolicy', config), { scope: 'namespaced' }).withReadinessEvaluator(createGatewayApiPolicyReadinessEvaluator(config.controllerName));
+}
+//# sourceMappingURL=gateway.js.map

package/dist/factories/gateway-api/resources/gateway.js.map

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

package/dist/factories/gateway-api/resources/index.d.ts

@@ -0,0 +1,2 @@
+export * from './gateway.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/factories/gateway-api/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/factories/gateway-api/resources/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/factories/gateway-api/resources/index.js

@@ -0,0 +1,2 @@
+export * from './gateway.js';
+//# sourceMappingURL=index.js.map

package/dist/factories/gateway-api/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/factories/gateway-api/resources/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}