@sdlcworks/components 0.0.38 → 0.0.39

package/dist/index.d.ts

@@ -88,7 +88,7 @@ export declare function toCanonicalInterfaceName(name: string): string;
  * @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>, TResultSchema extends z.ZodObject<z.ZodRawShape> | undefined = undefined> = {
+export type ConnectionInterfaceDef<TName extends string = string, TSchema extends z.ZodObject<z.ZodRawShape> = z.ZodObject<z.ZodRawShape>, TResultSchema extends z.ZodObject<z.ZodRawShape> | undefined = z.ZodObject<z.ZodRawShape> | undefined> = {
 	readonly name: TName;
 	readonly schema: TSchema;
 	readonly resultSchema?: TResultSchema;
@@ -131,11 +131,6 @@ export declare function extendSchema<TParentSchema extends z.ZodObject<z.ZodRawS
 } : never)) extends infer T ? {
 	[k in keyof T]: T[k];
 } : never, TChildSchema["_zod"]["config"]>;
-/**
- * Public HTTP Connection Interface - defines a public HTTP endpoint.
- * No metadata, only URI is provided.
- */
-export declare const PublicHTTPCI: ConnectionInterfaceDef<"public-http", z.ZodObject<{}, z.core.$strip>, undefined>;
 /**
  * Connection type used by the orchestrator when performing anonymous URI discovery
  * for URL register component collection. Infra component connect handlers that expose
@@ -172,7 +167,7 @@ export type DeclaredConnectionInterfaceEntry<D extends ConnectionInterfaceDef =
  * Function type for declareConnectionInterfaces.
  * Called within pulumi function to declare exposed connection interfaces.
  */
-export type DeclareConnectionInterfacesFn = <D extends ConnectionInterfaceDef>(entries: DeclaredConnectionInterfaceEntry<D>[]) => void;
+export type DeclareConnectionInterfacesFn = (entries: DeclaredConnectionInterfaceEntry<ConnectionInterfaceDef>[]) => void;
 export type InferredZodObject<S extends z.ZodRawShape> = z.infer<z.ZodObject<S>>;
 export type InferZodType<S extends z.ZodRawShape> = {
 	[K in keyof InferredZodObject<S>]: PulumiInput<InferredZodObject<S>[K]>;
@@ -182,6 +177,26 @@ export type InferOutputType<OShape extends z.ZodRawShape> = {
 };
 declare const emptyOutputSchema: z.ZodObject<{}, z.core.$strip>;
 export type EmptyOutputShape = typeof emptyOutputSchema.shape;
+/**
+ * The default app component type name.
+ * Used when an infra component has a single, uniform deployment input config
+ * for all app components deployed on it.
+ */
+export declare const DEFAULT_APP_COMPONENT_TYPE: "default";
+/**
+ * Helper to create an appComponentTypes map with a single "default" entry.
+ * Use this when the infra component does not distinguish between app component types.
+ *
+ * @example
+ * new InfraComponent({
+ *   ...
+ *   appComponentTypes: defaultAppComponentType(z.object({ image: z.string() })),
+ * })
+ * // Equivalent to: appComponentTypes: { default: z.object({ image: z.string() }) }
+ */
+export declare function defaultAppComponentType<S extends z.ZodTypeAny>(schema: S): {
+	default: S;
+};
 declare const InfraComponentOptsSchema: z.ZodObject<{
 	metadata: z.ZodObject<{
 		stateful: z.ZodBoolean;
@@ -196,7 +211,7 @@ declare const InfraComponentOptsSchema: z.ZodObject<{
 	}>, z.core.$strip>, z.ZodObject<Readonly<{
 		[k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
 	}>, z.core.$strip>>;
-	deploymentInputSchema: z.ZodCustom<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+	appComponentTypes: z.ZodRecord<z.ZodString, z.ZodCustom<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
 	outputSchema: z.ZodCustom<z.ZodObject<Readonly<{
 		[k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
 	}>, z.core.$strip>, z.ZodObject<Readonly<{
@@ -204,13 +219,13 @@ declare const InfraComponentOptsSchema: z.ZodObject<{
 	}>, z.core.$strip>>;
 }, z.core.$strip>;
 export type InfraComponentOptsBase = z.infer<typeof InfraComponentOptsSchema>;
-export type InfraComponentOpts<CShape extends z.ZodRawShape, DSchema extends z.ZodTypeAny, OShape extends z.ZodRawShape, ConnTypes extends Record<string, {
+export type InfraComponentOpts<CShape extends z.ZodRawShape, ACTypes extends Record<string, z.ZodTypeAny>, OShape extends z.ZodRawShape, ConnTypes extends Record<string, {
 	description: string;
 }> = Record<string, {
 	description: string;
-}>> = Omit<InfraComponentOptsBase, "configSchema" | "deploymentInputSchema" | "outputSchema" | "connectionTypes"> & {
+}>> = Omit<InfraComponentOptsBase, "configSchema" | "appComponentTypes" | "outputSchema" | "connectionTypes"> & {
 	configSchema: z.ZodObject<CShape>;
-	deploymentInputSchema: DSchema;
+	appComponentTypes: ACTypes;
 	outputSchema: z.ZodObject<OShape>;
 	connectionTypes: ConnTypes;
 	/**
@@ -380,6 +395,7 @@ export type ProviderDeployCtx<D, S, P extends CloudProvider = CloudProvider> = {
 } & Record<string, DeploymentInfo>;
 export type ProviderAllocateCtx<S, P extends CloudProvider = CloudProvider> = {
 	name: string;
+	appComponentType: string;
 	deploymentConfig: Record<string, any>;
 	state: S;
 	$: {
@@ -391,6 +407,7 @@ export type ProviderAllocateCtx<S, P extends CloudProvider = CloudProvider> = {
 };
 export type ProviderAllocateWithPulumiCtxCtx<S, P extends CloudProvider = CloudProvider> = {
 	name: string;
+	appComponentType: string;
 	deploymentConfig: Record<string, any>;
 	state: S;
 	$: {
@@ -404,6 +421,7 @@ export type ProviderAllocateWithPulumiCtxCtx<S, P extends CloudProvider = CloudP
 };
 export type ProviderDeallocateCtx<S, P extends CloudProvider = CloudProvider> = {
 	name: string;
+	appComponentType: string;
 	deploymentConfig: Record<string, any>;
 	state: S;
 	$: {
@@ -476,18 +494,24 @@ export type DeclaredConnectionInterfaces = Map<string, {
 	schema: z.ZodTypeAny;
 	data: any;
 }>;
-export declare class InfraComponent<CShape extends z.ZodRawShape, DSchema extends z.ZodTypeAny, OShape extends z.ZodRawShape = EmptyOutputShape, ConnTypes extends Record<string, {
+export declare class InfraComponent<CShape extends z.ZodRawShape, ACTypes extends Record<string, z.ZodTypeAny>, OShape extends z.ZodRawShape = EmptyOutputShape, ConnTypes extends Record<string, {
 	description: string;
 }> = Record<string, {
 	description: string;
 }>> {
-	opts: InfraComponentOpts<CShape, DSchema, OShape, ConnTypes>;
+	opts: InfraComponentOpts<CShape, ACTypes, OShape, ConnTypes>;
 	providers: ProviderRegistry;
 	validationSchema: z.ZodTypeAny;
-	validationDeploymentInputSchema: z.ZodTypeAny;
+	/**
+	 * Validation schemas for each app component type, transformed to accept Pulumi Outputs.
+	 * Keyed by app component type name.
+	 */
+	validationAppComponentTypes: Record<string, z.ZodTypeAny>;
 	private declaredConnectionInterfaces;
-	constructor(opts: InfraComponentOpts<CShape, DSchema, OShape, ConnTypes>);
-	implement<P extends CloudProvider, SShape extends z.ZodRawShape = EmptyStateShape>(provider: P, fns: ProviderFnsDef<InferZodType<CShape>, z.infer<DSchema>, InferOutputType<OShape>, SShape, keyof ConnTypes & string, P>): this;
+	constructor(opts: InfraComponentOpts<CShape, ACTypes, OShape, ConnTypes>);
+	implement<P extends CloudProvider, SShape extends z.ZodRawShape = EmptyStateShape>(provider: P, fns: ProviderFnsDef<InferZodType<CShape>, {
+		[K in keyof ACTypes]: z.infer<ACTypes[K]>;
+	}, InferOutputType<OShape>, SShape, keyof ConnTypes & string, P>): this;
 	/**
 	 * Get the schema for a specific connection interface.
 	 * Used by the orchestrator at runtime.

package/dist/index.js

@@ -1 +1 @@
-import{z as B}from"zod";import*as $ from"@pulumi/pulumi";var Z;((Q)=>{Q.aws="aws";Q.gcloud="gcloud";Q.azure="azure";Q.linode="linode";Q.hetzner="hetzner";Q.cloudflare="cloudflare"})(Z||={});var X;((H)=>{H.oci_spec_image="oci_spec_image";H.file="file"})(X||={});var _=new Map;function q(j){return j.replace(/([a-z])([A-Z])/g,"$1-$2").replace(/[_\s]+/g,"-").toLowerCase().replace(/-+/g,"-").replace(/^-|-$/g,"")}function E(j){let F=q(j);if(F.length===0)throw new Error("Connection interface name cannot be empty");let H=_.get(F);if(H!==void 0&&H!==j)throw new Error(`Connection interface name collision: '${j}' resolves to '${F}' which is already registered by '${H}'`);return _.set(F,j),F}function G(j,F,H){return{name:E(j),schema:F,resultSchema:H}}function I(j,F){return j.schema.merge(F)}var R=G("public-http",B.object({})),P="@anonymous",g=B.object({});function J(j){if(j instanceof B.ZodObject){let F=j.shape,H={};for(let M in F)H[M]=J(F[M]);return B.object(H)}if(j instanceof B.ZodOptional)return J(j.unwrap()).optional();if(j instanceof B.ZodNullable)return J(j.unwrap()).nullable();if(j instanceof B.ZodDefault)return J(j._def.innerType).default(j._def.defaultValue);if(j instanceof B.ZodArray)return B.array(J(j.element));if(j instanceof B.ZodDiscriminatedUnion){let F=j._def.options.map((H)=>J(H));return B.discriminatedUnion(j._def.discriminator,F)}if(j instanceof B.ZodRecord){let F=j._def.keyType,H=j._def.valueType,M=F?J(F):B.string(),W=H?J(H):B.any();return B.record(M,W)}return B.union([j,B.custom((F)=>$.Output.isInstance(F))])}var K=B.object({metadata:B.object({stateful:B.boolean(),proxiable:B.boolean()}),connectionTypes:B.record(B.string(),B.object({description:B.string().min(5)})),acceptedArtifactTypes:B.array(B.nativeEnum(X)).optional(),configSchema:B.custom(),deploymentInputSchema:B.custom(),outputSchema:B.custom()});function D(j){return j}var Y=B.object({});class L{opts;providers;validationSchema;validationDeploymentInputSchema;declaredConnectionInterfaces=new Map;constructor(j){this.opts=K.parse(j),this.providers={},this.validationSchema=J(j.configSchema),this.validationDeploymentInputSchema=J(j.deploymentInputSchema)}implement(j,F){if(F.allocateComponent&&F.allocateWithPulumiCtx)throw new Error(`Provider '${j}' cannot define both 'allocateComponent' and 'allocateWithPulumiCtx'. These are mutually exclusive allocation strategies.`);if(F.upsertArtifacts&&(!this.opts.acceptedArtifactTypes||this.opts.acceptedArtifactTypes.length===0))throw new Error(`Provider '${j}' defines 'upsertArtifacts' but the component is missing 'acceptedArtifactTypes'. Declare which artifact types this component supports (e.g. [DeploymentArtifactType.oci_spec_image]).`);return this.providers[j]={...F,stateSchema:F.stateSchema??Y,initialState:F.initialState},this}getConnectionSchema(j){return j.schema}createDeclareConnectionInterfacesFn(){return(j)=>{this.declaredConnectionInterfaces=new Map;for(let F of j){let H=F.interface.schema,M=J(H),W=M.safeParse(F.data);if(!W.success)throw new Error(`Invalid data for connection interface '${F.interface.name}': ${W.error.message}`);this.declaredConnectionInterfaces.set(F.interface.name,{schema:M,data:F.data})}}}getDeclaredInterfaces(){return this.declaredConnectionInterfaces}}var U=B.object({name:B.string().min(1),interface:B.custom(),configSchema:B.custom(),stateSchema:B.custom().optional(),provision:B.function()});class V{name;interface;configSchema;stateSchema;validationSchema;provisionFn;initialState;constructor(j){U.parse(j),this.name=j.name,this.interface=j.interface,this.configSchema=j.configSchema,this.stateSchema=j.stateSchema??Y,this.validationSchema=J(j.configSchema),this.provisionFn=j.provision,this.initialState=j.initialState}getProvision(){return this.provisionFn}}var b=B.object({name:B.string().min(1),acceptedArtifactTypes:B.array(B.nativeEnum(X)).min(1),configSchema:B.custom(),stateSchema:B.custom().optional(),provision:B.function(),publish:B.function()});class N{name;acceptedArtifactTypes;configSchema;stateSchema;validationSchema;initialState;provisionFn;publishFn;constructor(j){b.parse(j),this.name=j.name,this.acceptedArtifactTypes=j.acceptedArtifactTypes,this.configSchema=j.configSchema,this.stateSchema=j.stateSchema??Y,this.validationSchema=J(j.configSchema),this.initialState=j.initialState,this.provisionFn=j.provision,this.publishFn=j.publish}getProvision(){return this.provisionFn}getPublish(){return this.publishFn}}export{q as toCanonicalInterfaceName,I as extendSchema,G as defineConnectionInterface,D as connectionHandler,V as URLRegister,R as PublicHTTPCI,L as InfraComponent,X as DeploymentArtifactType,Z as CloudProvider,N as ArtifactRegistry,P as ANONYMOUS_CONNECTION_TYPE};
+import{z as B}from"zod";import*as K from"@pulumi/pulumi";var F;((X)=>{X.aws="aws";X.gcloud="gcloud";X.azure="azure";X.linode="linode";X.hetzner="hetzner";X.cloudflare="cloudflare"})(F||={});var $;((J)=>{J.oci_spec_image="oci_spec_image";J.file="file"})($||={});var G=new Map;function M(j){return j.replace(/([a-z])([A-Z])/g,"$1-$2").replace(/[_\s]+/g,"-").toLowerCase().replace(/-+/g,"-").replace(/^-|-$/g,"")}function V(j){let H=M(j);if(H.length===0)throw new Error("Connection interface name cannot be empty");let J=G.get(H);if(J!==void 0&&J!==j)throw new Error(`Connection interface name collision: '${j}' resolves to '${H}' which is already registered by '${J}'`);return G.set(H,j),H}function k(j,H,J){return{name:V(j),schema:H,resultSchema:J}}function R(j,H){return j.schema.merge(H)}var g="@anonymous",D=B.object({});function Q(j){if(j instanceof B.ZodObject){let H=j.shape,J={};for(let W in H)J[W]=Q(H[W]);return B.object(J)}if(j instanceof B.ZodOptional)return Q(j.unwrap()).optional();if(j instanceof B.ZodNullable)return Q(j.unwrap()).nullable();if(j instanceof B.ZodDefault)return Q(j._def.innerType).default(j._def.defaultValue);if(j instanceof B.ZodArray)return B.array(Q(j.element));if(j instanceof B.ZodDiscriminatedUnion){let H=j._def.options.map((J)=>Q(J));return B.discriminatedUnion(j._def.discriminator,H)}if(j instanceof B.ZodRecord){let H=j._def.keyType,J=j._def.valueType,W=H?Q(H):B.string(),Z=J?Q(J):B.any();return B.record(W,Z)}return B.union([j,B.custom((H)=>K.Output.isInstance(H))])}var Y="default";function C(j){return{[Y]:j}}var b=B.object({metadata:B.object({stateful:B.boolean(),proxiable:B.boolean()}),connectionTypes:B.record(B.string(),B.object({description:B.string().min(5)})),acceptedArtifactTypes:B.array(B.nativeEnum($)).optional(),configSchema:B.custom(),appComponentTypes:B.record(B.string(),B.custom()),outputSchema:B.custom()});function P(j){return j}var q=B.object({});class L{opts;providers;validationSchema;validationAppComponentTypes;declaredConnectionInterfaces=new Map;constructor(j){this.opts=b.parse(j),this.providers={},this.validationSchema=Q(j.configSchema),this.validationAppComponentTypes=Object.fromEntries(Object.entries(j.appComponentTypes).map(([H,J])=>[H,Q(J)]))}implement(j,H){if(H.allocateComponent&&H.allocateWithPulumiCtx)throw new Error(`Provider '${j}' cannot define both 'allocateComponent' and 'allocateWithPulumiCtx'. These are mutually exclusive allocation strategies.`);if(H.upsertArtifacts&&(!this.opts.acceptedArtifactTypes||this.opts.acceptedArtifactTypes.length===0))throw new Error(`Provider '${j}' defines 'upsertArtifacts' but the component is missing 'acceptedArtifactTypes'. Declare which artifact types this component supports (e.g. [DeploymentArtifactType.oci_spec_image]).`);return this.providers[j]={...H,stateSchema:H.stateSchema??q,initialState:H.initialState},this}getConnectionSchema(j){return j.schema}createDeclareConnectionInterfacesFn(){return(j)=>{this.declaredConnectionInterfaces=new Map;for(let H of j){let J=H.interface.schema,W=Q(J),Z=W.safeParse(H.data);if(!Z.success)throw new Error(`Invalid data for connection interface '${H.interface.name}': ${Z.error.message}`);this.declaredConnectionInterfaces.set(H.interface.name,{schema:W,data:H.data})}}}getDeclaredInterfaces(){return this.declaredConnectionInterfaces}}var U=B.object({name:B.string().min(1),interface:B.custom(),configSchema:B.custom(),stateSchema:B.custom().optional(),provision:B.function()});class w{name;interface;configSchema;stateSchema;validationSchema;provisionFn;initialState;constructor(j){U.parse(j),this.name=j.name,this.interface=j.interface,this.configSchema=j.configSchema,this.stateSchema=j.stateSchema??q,this.validationSchema=Q(j.configSchema),this.provisionFn=j.provision,this.initialState=j.initialState}getProvision(){return this.provisionFn}}var _=B.object({name:B.string().min(1),acceptedArtifactTypes:B.array(B.nativeEnum($)).min(1),configSchema:B.custom(),stateSchema:B.custom().optional(),provision:B.function(),publish:B.function()});class x{name;acceptedArtifactTypes;configSchema;stateSchema;validationSchema;initialState;provisionFn;publishFn;constructor(j){_.parse(j),this.name=j.name,this.acceptedArtifactTypes=j.acceptedArtifactTypes,this.configSchema=j.configSchema,this.stateSchema=j.stateSchema??q,this.validationSchema=Q(j.configSchema),this.initialState=j.initialState,this.provisionFn=j.provision,this.publishFn=j.publish}getProvision(){return this.provisionFn}getPublish(){return this.publishFn}}export{M as toCanonicalInterfaceName,R as extendSchema,k as defineConnectionInterface,C as defaultAppComponentType,P as connectionHandler,w as URLRegister,L as InfraComponent,$ as DeploymentArtifactType,Y as DEFAULT_APP_COMPONENT_TYPE,F as CloudProvider,x as ArtifactRegistry,g as ANONYMOUS_CONNECTION_TYPE};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdlcworks/components",
-  "version": "0.0.38",
+  "version": "0.0.39",
   "module": "dist/index.js",
   "files": [
     "dist"