@sdlcworks/components 0.0.28 → 0.0.30

package/dist/index.d.ts

@@ -3,25 +3,14 @@
 import { Input as PulumiInput, Output as PulumiOutput } from '@pulumi/pulumi';
 import { z } from 'zod';
 
-declare const BranchMetadataCloudCredentialGCPSchema = z.object({
-	GCP_PROJECT_ID: z.string().describe("Required GCP Project ID"),
-	GCP_SERVICE_ACCOUNT_KEY: z.string()
-		.describe("Required GCP Service Account Key"),
-});
-export type BranchMetadataCloudCredentialGCP = z.infer<typeof BranchMetadataCloudCredentialGCPSchema>;
-declare const BranchMetadataCloudCredentialAWSSchema = z.object({
-	AWS_ACCESS_KEY_ID: z.string().describe("Required AWS Access Key ID"),
-	AWS_SECRET_ACCESS_KEY: z.string().describe("Required AWS Secret Access Key"),
-	AWS_REGION: z.string().describe("Required AWS Region"),
-});
-export type BranchMetadataCloudCredentialAWS = z.infer<typeof BranchMetadataCloudCredentialAWSSchema>;
-declare const BranchMetadataCloudCredentialCloudflareSchema = z.object({
-	CLOUDFLARE_API_TOKEN: z.string().describe("Required Cloudflare API Token"),
-	CLOUDFLARE_ACCOUNT_ID: z.string()
-		.optional()
-		.describe("Optional Cloudflare Account ID (required for account-scoped resources like Workers, R2, Pages)"),
-});
-export type BranchMetadataCloudCredentialCloudflare = z.infer<typeof BranchMetadataCloudCredentialCloudflareSchema>;
+/**
+ * Types copied from @sdlc/types for use in the published @sdlcworks/components package.
+ * These are duplicated here to avoid requiring users to install @sdlc/types
+ * (which is an internal monorepo package not published to npm).
+ *
+ * ⚠️  SYNC REQUIRED: When modifying these types, also update @sdlc/types/src/index.ts
+ *     and vice versa. These files must be kept in sync manually.
+ */
 export declare enum CloudProvider {
 	aws = "aws",
 	gcloud = "gcloud",
@@ -30,6 +19,31 @@ export declare enum CloudProvider {
 	hetzner = "hetzner",
 	cloudflare = "cloudflare"
 }
+export declare enum DeploymentArtifactType {
+	container_image = "container_image"
+}
+/**
+ * GCP credential fields required for authentication.
+ */
+export type BranchMetadataCloudCredentialGCP = {
+	GCP_PROJECT_ID: string;
+	GCP_SERVICE_ACCOUNT_KEY: string;
+};
+/**
+ * AWS credential fields required for authentication.
+ */
+export type BranchMetadataCloudCredentialAWS = {
+	AWS_ACCESS_KEY_ID: string;
+	AWS_SECRET_ACCESS_KEY: string;
+	AWS_REGION: string;
+};
+/**
+ * Cloudflare credential fields required for authentication.
+ */
+export type BranchMetadataCloudCredentialCloudflare = {
+	CLOUDFLARE_API_TOKEN: string;
+	CLOUDFLARE_ACCOUNT_ID?: string;
+};
 /**
  * Maps each CloudProvider to its corresponding credential type.
  * Used to provide fully-typed credentials in handler contexts.
@@ -52,9 +66,6 @@ export declare enum TCPUrlType {
 	ipv6 = "ipv6",
 	domain = "domain"
 }
-export declare enum DeploymentArtifactType {
-	container_image = "container_image"
-}
 /**
  * Transforms any interface name to canonical hyphen-separated lowercase form.
  *
@@ -68,23 +79,33 @@ export declare function toCanonicalInterfaceName(name: string): string;
 /**
  * Connection interface definition with a unique name and typed schema.
  * The name is used for matching interfaces across separately bundled components.
+ *
+ * @param TName - Unique interface name
+ * @param TSchema - Input schema (data from connecting component)
+ * @param TResultSchema - Optional result metadata schema for typed handler results
  */
-export type ConnectionInterfaceDef<TName extends string = string, TSchema extends z.ZodObject<z.ZodRawShape> = z.ZodObject<z.ZodRawShape>> = {
+export type ConnectionInterfaceDef<TName extends string = string, TSchema extends z.ZodObject<z.ZodRawShape> = z.ZodObject<z.ZodRawShape>, TResultSchema extends z.ZodObject<z.ZodRawShape> | undefined = undefined> = {
 	readonly name: TName;
 	readonly schema: TSchema;
+	readonly resultSchema?: TResultSchema;
 };
 /**
- * Creates a connection interface definition with a unique name and schema.
+ * Creates a connection interface definition with a unique name and schemas.
  * The name is canonicalized to hyphen-separated lowercase and registered
  * globally to detect collisions.
  *
+ * @param name - Unique interface name
+ * @param schema - Input schema for data passed to handler via ctx.connectionData
+ * @param resultSchema - Optional schema for typed metadata returned by handler
+ *
  * @example
  * const ServiceAccountCI = defineConnectionInterface(
  *   "service-account",
- *   z.object({ email: z.string() })
+ *   z.object({ email: z.string() }),
+ *   z.object({ role: z.string() })  // Optional result metadata
  * );
  */
-export declare function defineConnectionInterface<TName extends string, TSchema extends z.ZodObject<z.ZodRawShape>>(name: TName, schema: TSchema): ConnectionInterfaceDef<TName, TSchema>;
+export declare function defineConnectionInterface<TName extends string, TSchema extends z.ZodObject<z.ZodRawShape>, TResultSchema extends z.ZodObject<z.ZodRawShape> | undefined = undefined>(name: TName, schema: TSchema, resultSchema?: TResultSchema): ConnectionInterfaceDef<TName, TSchema, TResultSchema>;
 /**
  * Merges a parent interface's schema with additional fields.
  * Use with defineConnectionInterface to create extended interfaces.
@@ -116,7 +137,7 @@ export declare const TCPCI: ConnectionInterfaceDef<"tcp", z.ZodObject<{
 		value: z.ZodString;
 	}, z.core.$strip>;
 	publicAccess: z.ZodBoolean;
-}, z.core.$strip>>;
+}, z.core.$strip>, undefined>;
 /**
  * Extract the inferred data type from a ConnectionInterfaceDef.
  */
@@ -127,6 +148,11 @@ export type InferConnectionData<D extends ConnectionInterfaceDef> = z.infer<D["s
 export type InferConnectionDataWithInputs<D extends ConnectionInterfaceDef> = InferConnectionData<D> extends infer Data ? {
 	[K in keyof Data]: PulumiInput<Data[K]>;
 } : never;
+/**
+ * Extract the inferred result metadata type from a ConnectionInterfaceDef.
+ * Returns undefined if no resultSchema is defined.
+ */
+export type InferConnectionResultMetadata<D extends ConnectionInterfaceDef> = D extends ConnectionInterfaceDef<any, any, infer R> ? R extends z.ZodObject<z.ZodRawShape> ? z.infer<R> : undefined : undefined;
 /**
  * Entry type for declareConnectionInterfaces parameter.
  * Declares an interface that this component exposes with typed data.
@@ -222,15 +248,25 @@ export type ConnectionHandlerCtx<S, ConnectorData, ConnectionType extends string
 };
 /**
  * Result returned by connection handlers.
- * Must return a record mapping component names to their URIs.
+ * - uri: Required, the connection URI as a Pulumi Output
+ * - metadata: Optional, typed based on interface's resultSchema
+ *
+ * If no resultSchema is defined on the interface, metadata can be any record.
+ * If resultSchema is defined, metadata is typed and validated against it.
  */
-export type ConnectionHandlerResult = Record<string, PulumiOutput<string>>;
+export type ConnectionHandlerResult<TMetadata = undefined> = {
+	uri: PulumiOutput<string>;
+	metadata?: TMetadata extends undefined ? Record<string, PulumiInput<string | number | boolean>> : {
+		[K in keyof TMetadata]: PulumiInput<TMetadata[K]>;
+	};
+};
 /**
  * A connection handler entry mapping a ConnectionInterfaceDef to its handler function.
+ * The handler returns typed metadata based on the interface's resultSchema.
  */
 export type ConnectionHandlerEntry<S, ConnectionType extends string, D extends ConnectionInterfaceDef, P extends CloudProvider = CloudProvider> = {
 	interface: D;
-	handler: (ctx: ConnectionHandlerCtx<S, InferConnectionData<D>, ConnectionType, P>) => Promise<ConnectionHandlerResult>;
+	handler: (ctx: ConnectionHandlerCtx<S, InferConnectionData<D>, ConnectionType, P>) => Promise<ConnectionHandlerResult<InferConnectionResultMetadata<D>>>;
 };
 /**
  * Type definition for a connection handler entry.
@@ -238,7 +274,7 @@ export type ConnectionHandlerEntry<S, ConnectionType extends string, D extends C
  */
 export type ConnectionHandlerDef<D extends ConnectionInterfaceDef> = {
 	interface: D;
-	handler: (ctx: ConnectionHandlerCtx<any, InferConnectionData<D>, any>) => Promise<ConnectionHandlerResult>;
+	handler: (ctx: ConnectionHandlerCtx<any, InferConnectionData<D>, any>) => Promise<ConnectionHandlerResult<InferConnectionResultMetadata<D>>>;
 };
 export declare function connectionHandler<D extends ConnectionInterfaceDef>(entry: ConnectionHandlerDef<D>): ConnectionHandlerDef<D>;
 export type ProviderDeployCtx<D, S, P extends CloudProvider = CloudProvider> = {
@@ -305,8 +341,8 @@ export type ProviderFnsDef<I, D, O, SShape extends z.ZodRawShape = EmptyStateSha
  * when accessing from the registry, allowing runtime schema access.
  */
 export type StoredConnectionHandlerEntry = {
-	interface: ConnectionInterfaceDef;
-	handler: (ctx: ConnectionHandlerCtx<any, any, any, any>) => Promise<ConnectionHandlerResult>;
+	interface: ConnectionInterfaceDef<string, any, any>;
+	handler: (ctx: ConnectionHandlerCtx<any, any, any, any>) => Promise<ConnectionHandlerResult<any>>;
 };
 export type StoredProviderFns = {
 	stateSchema: z.ZodObject<any>;

package/dist/index.js

@@ -1,164 +1 @@
-// src/infra.ts
-import { z } from "zod";
-import * as pulumi from "@pulumi/pulumi";
-var CloudProvider;
-((CloudProvider2) => {
-  CloudProvider2["aws"] = "aws";
-  CloudProvider2["gcloud"] = "gcloud";
-  CloudProvider2["azure"] = "azure";
-  CloudProvider2["linode"] = "linode";
-  CloudProvider2["hetzner"] = "hetzner";
-  CloudProvider2["cloudflare"] = "cloudflare";
-})(CloudProvider ||= {});
-var TCPUrlType;
-((TCPUrlType2) => {
-  TCPUrlType2["ipv4"] = "ipv4";
-  TCPUrlType2["ipv6"] = "ipv6";
-  TCPUrlType2["domain"] = "domain";
-})(TCPUrlType ||= {});
-var DeploymentArtifactType;
-((DeploymentArtifactType2) => {
-  DeploymentArtifactType2["container_image"] = "container_image";
-})(DeploymentArtifactType ||= {});
-var connectionInterfaceRegistry = new Map;
-function toCanonicalInterfaceName(name) {
-  return name.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[_\s]+/g, "-").toLowerCase().replace(/-+/g, "-").replace(/^-|-$/g, "");
-}
-function registerInterfaceName(name) {
-  const canonical = toCanonicalInterfaceName(name);
-  if (canonical.length === 0) {
-    throw new Error(`Connection interface name cannot be empty`);
-  }
-  const existing = connectionInterfaceRegistry.get(canonical);
-  if (existing !== undefined && existing !== name) {
-    throw new Error(`Connection interface name collision: '${name}' resolves to '${canonical}' which is already registered by '${existing}'`);
-  }
-  connectionInterfaceRegistry.set(canonical, name);
-  return canonical;
-}
-function defineConnectionInterface(name, schema) {
-  const canonicalName = registerInterfaceName(name);
-  return {
-    name: canonicalName,
-    schema
-  };
-}
-function extendSchema(parentDef, additionalSchema) {
-  return parentDef.schema.merge(additionalSchema);
-}
-var TCPCI = defineConnectionInterface("tcp", z.object({
-  url: z.object({
-    type: z.nativeEnum(TCPUrlType),
-    value: z.string()
-  }),
-  publicAccess: z.boolean()
-}));
-var emptyOutputSchema = z.object({});
-function transformSchemaToAcceptOutputs(schema) {
-  if (schema instanceof z.ZodObject) {
-    const shape = schema.shape;
-    const newShape = {};
-    for (const key in shape) {
-      newShape[key] = transformSchemaToAcceptOutputs(shape[key]);
-    }
-    return z.object(newShape);
-  }
-  if (schema instanceof z.ZodOptional) {
-    return transformSchemaToAcceptOutputs(schema.unwrap()).optional();
-  }
-  if (schema instanceof z.ZodNullable) {
-    return transformSchemaToAcceptOutputs(schema.unwrap()).nullable();
-  }
-  if (schema instanceof z.ZodDefault) {
-    return transformSchemaToAcceptOutputs(schema._def.innerType).default(schema._def.defaultValue);
-  }
-  if (schema instanceof z.ZodArray) {
-    return z.array(transformSchemaToAcceptOutputs(schema.element));
-  }
-  if (schema instanceof z.ZodDiscriminatedUnion) {
-    const transformedOptions = schema._def.options.map((option) => transformSchemaToAcceptOutputs(option));
-    return z.discriminatedUnion(schema._def.discriminator, transformedOptions);
-  }
-  if (schema instanceof z.ZodRecord) {
-    const keyType = schema._def.keyType;
-    const valueType = schema._def.valueType;
-    const transformedKey = keyType ? transformSchemaToAcceptOutputs(keyType) : z.string();
-    const transformedValue = valueType ? transformSchemaToAcceptOutputs(valueType) : z.any();
-    return z.record(transformedKey, transformedValue);
-  }
-  return z.union([
-    schema,
-    z.custom((val) => pulumi.Output.isInstance(val))
-  ]);
-}
-var InfraComponentOptsSchema = z.object({
-  metadata: z.object({
-    stateful: z.boolean(),
-    proxiable: z.boolean()
-  }),
-  connectionTypes: z.record(z.string(), z.object({
-    description: z.string().min(5)
-  })),
-  configSchema: z.custom(),
-  deploymentInputSchema: z.custom(),
-  outputSchema: z.custom()
-});
-function connectionHandler(entry) {
-  return entry;
-}
-var emptyStateSchema = z.object({});
-
-class InfraComponent {
-  opts;
-  providers;
-  validationSchema;
-  validationDeploymentInputSchema;
-  declaredConnectionInterfaces = new Map;
-  constructor(opts) {
-    this.opts = InfraComponentOptsSchema.parse(opts);
-    this.providers = {};
-    this.validationSchema = transformSchemaToAcceptOutputs(opts.configSchema);
-    this.validationDeploymentInputSchema = transformSchemaToAcceptOutputs(opts.deploymentInputSchema);
-  }
-  implement(provider, fns) {
-    this.providers[provider] = {
-      ...fns,
-      stateSchema: fns.stateSchema ?? emptyStateSchema,
-      initialState: fns.initialState
-    };
-    return this;
-  }
-  getConnectionSchema(interfaceDef) {
-    return interfaceDef.schema;
-  }
-  createDeclareConnectionInterfacesFn() {
-    return (entries) => {
-      for (const entry of entries) {
-        const schema = entry.interface.schema;
-        const transformedSchema = transformSchemaToAcceptOutputs(schema);
-        const parseResult = transformedSchema.safeParse(entry.data);
-        if (!parseResult.success) {
-          throw new Error(`Invalid data for connection interface '${entry.interface.name}': ${parseResult.error.message}`);
-        }
-        this.declaredConnectionInterfaces.set(entry.interface.name, {
-          schema: transformedSchema,
-          data: entry.data
-        });
-      }
-    };
-  }
-  getDeclaredInterfaces() {
-    return this.declaredConnectionInterfaces;
-  }
-}
-export {
-  toCanonicalInterfaceName,
-  extendSchema,
-  defineConnectionInterface,
-  connectionHandler,
-  TCPUrlType,
-  TCPCI,
-  InfraComponent,
-  DeploymentArtifactType,
-  CloudProvider
-};
+import{z as j}from"zod";import*as Y from"@pulumi/pulumi";var Q;((L)=>{L.aws="aws";L.gcloud="gcloud";L.azure="azure";L.linode="linode";L.hetzner="hetzner";L.cloudflare="cloudflare"})(Q||={});var W;((B)=>B.container_image="container_image")(W||={});var Z;((H)=>{H.ipv4="ipv4";H.ipv6="ipv6";H.domain="domain"})(Z||={});var X=new Map;function _(b){return b.replace(/([a-z])([A-Z])/g,"$1-$2").replace(/[_\s]+/g,"-").toLowerCase().replace(/-+/g,"-").replace(/^-|-$/g,"")}function $(b){let B=_(b);if(B.length===0)throw new Error("Connection interface name cannot be empty");let F=X.get(B);if(F!==void 0&&F!==b)throw new Error(`Connection interface name collision: '${b}' resolves to '${B}' which is already registered by '${F}'`);return X.set(B,b),B}function q(b,B,F){return{name:$(b),schema:B,resultSchema:F}}function w(b,B){return b.schema.merge(B)}var x=q("tcp",j.object({url:j.object({type:j.nativeEnum(Z),value:j.string()}),publicAccess:j.boolean()})),R=j.object({});function J(b){if(b instanceof j.ZodObject){let B=b.shape,F={};for(let H in B)F[H]=J(B[H]);return j.object(F)}if(b instanceof j.ZodOptional)return J(b.unwrap()).optional();if(b instanceof j.ZodNullable)return J(b.unwrap()).nullable();if(b instanceof j.ZodDefault)return J(b._def.innerType).default(b._def.defaultValue);if(b instanceof j.ZodArray)return j.array(J(b.element));if(b instanceof j.ZodDiscriminatedUnion){let B=b._def.options.map((F)=>J(F));return j.discriminatedUnion(b._def.discriminator,B)}if(b instanceof j.ZodRecord){let B=b._def.keyType,F=b._def.valueType,H=B?J(B):j.string(),M=F?J(F):j.any();return j.record(H,M)}return j.union([b,j.custom((B)=>Y.Output.isInstance(B))])}var E=j.object({metadata:j.object({stateful:j.boolean(),proxiable:j.boolean()}),connectionTypes:j.record(j.string(),j.object({description:j.string().min(5)})),configSchema:j.custom(),deploymentInputSchema:j.custom(),outputSchema:j.custom()});function U(b){return b}var G=j.object({});class K{opts;providers;validationSchema;validationDeploymentInputSchema;declaredConnectionInterfaces=new Map;constructor(b){this.opts=E.parse(b),this.providers={},this.validationSchema=J(b.configSchema),this.validationDeploymentInputSchema=J(b.deploymentInputSchema)}implement(b,B){return this.providers[b]={...B,stateSchema:B.stateSchema??G,initialState:B.initialState},this}getConnectionSchema(b){return b.schema}createDeclareConnectionInterfacesFn(){return(b)=>{for(let B of b){let F=B.interface.schema,H=J(F),M=H.safeParse(B.data);if(!M.success)throw new Error(`Invalid data for connection interface '${B.interface.name}': ${M.error.message}`);this.declaredConnectionInterfaces.set(B.interface.name,{schema:H,data:B.data})}}}getDeclaredInterfaces(){return this.declaredConnectionInterfaces}}export{_ as toCanonicalInterfaceName,w as extendSchema,q as defineConnectionInterface,U as connectionHandler,Z as TCPUrlType,x as TCPCI,K as InfraComponent,W as DeploymentArtifactType,Q as CloudProvider};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdlcworks/components",
-  "version": "0.0.28",
+  "version": "0.0.30",
   "module": "dist/index.js",
   "files": [
     "dist"
@@ -31,7 +31,6 @@
     "typescript": "^5.0.0"
   },
   "dependencies": {
-    "@sdlc/types": "workspace:*",
     "zod": "4.1.13"
   }
 }