@kici-dev/sdk 0.0.0 → 0.1.1

package/dist/triggers/job-complete.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Job complete trigger helper - creates triggers for job completion events.
+ * Returns a frozen JobCompleteTriggerConfig directly.
+ */
+import type { JobCompleteConfigInput, JobCompleteTriggerConfig } from './types.js';
+/**
+ * Create a job completion trigger configuration.
+ *
+ * @example
+ * // Match any job completion
+ * jobComplete()
+ *
+ * // Match specific workflow + job
+ * jobComplete({ workflow: 'CI', job: 'build' })
+ *
+ * // Match successful completions only
+ * jobComplete({ workflow: 'CI', job: 'build', status: ['success'] })
+ *
+ * // Cross-repo source filter
+ * jobComplete({ workflow: 'CI', job: 'build', source: 'org/repo' })
+ */
+export declare function jobComplete(config?: JobCompleteConfigInput): JobCompleteTriggerConfig;
+//# sourceMappingURL=job-complete.d.ts.map

package/dist/triggers/job-complete.js

@@ -0,0 +1,33 @@
+import "../chunk-gOLHoazu.js";
+//#region src/triggers/job-complete.ts
+/**
+* Create a job completion trigger configuration.
+*
+* @example
+* // Match any job completion
+* jobComplete()
+*
+* // Match specific workflow + job
+* jobComplete({ workflow: 'CI', job: 'build' })
+*
+* // Match successful completions only
+* jobComplete({ workflow: 'CI', job: 'build', status: ['success'] })
+*
+* // Cross-repo source filter
+* jobComplete({ workflow: 'CI', job: 'build', source: 'org/repo' })
+*/
+function jobComplete(config) {
+	const result = {
+		_tag: "JobCompleteTrigger",
+		...config?.workflow !== void 0 && { workflow: config.workflow },
+		...config?.job !== void 0 && { job: config.job },
+		...config?.status !== void 0 && { status: Object.freeze([...config.status]) },
+		...config?.source !== void 0 && { source: config.source },
+		...config?.description !== void 0 && { description: config.description }
+	};
+	return Object.freeze(result);
+}
+//#endregion
+export { jobComplete };
+
+//# sourceMappingURL=job-complete.js.map

package/dist/triggers/kici-event.d.ts

@@ -0,0 +1,23 @@
+/**
+ * KiCI event trigger helper - creates triggers for custom named events.
+ * Returns a frozen KiciEventTriggerConfig directly.
+ */
+import type { KiciEventConfigInput, KiciEventTriggerConfig } from './types.js';
+/**
+ * Create a KiCI custom event trigger configuration.
+ *
+ * @example
+ * // Match a specific event by name
+ * kiciEvent({ name: 'deploy-complete' })
+ *
+ * // With JSONPath payload matching
+ * kiciEvent({ name: 'deploy-complete', match: { '$.env': 'prod' } })
+ *
+ * // With negative filter
+ * kiciEvent({ name: 'deploy-complete', not: { '$.env': 'staging' } })
+ *
+ * // Cross-repo source filter
+ * kiciEvent({ name: 'deploy-complete', source: 'org/infra-repo' })
+ */
+export declare function kiciEvent(config: KiciEventConfigInput): KiciEventTriggerConfig;
+//# sourceMappingURL=kici-event.d.ts.map

package/dist/triggers/kici-event.js

@@ -0,0 +1,34 @@
+import "../chunk-gOLHoazu.js";
+//#region src/triggers/kici-event.ts
+/**
+* Create a KiCI custom event trigger configuration.
+*
+* @example
+* // Match a specific event by name
+* kiciEvent({ name: 'deploy-complete' })
+*
+* // With JSONPath payload matching
+* kiciEvent({ name: 'deploy-complete', match: { '$.env': 'prod' } })
+*
+* // With negative filter
+* kiciEvent({ name: 'deploy-complete', not: { '$.env': 'staging' } })
+*
+* // Cross-repo source filter
+* kiciEvent({ name: 'deploy-complete', source: 'org/infra-repo' })
+*/
+function kiciEvent(config) {
+	if (!config.name || config.name.trim() === "") throw new Error("kiciEvent() requires a non-empty name");
+	const result = {
+		_tag: "KiciEventTrigger",
+		name: config.name,
+		...config.match !== void 0 && { match: Object.freeze({ ...config.match }) },
+		...config.source !== void 0 && { source: config.source },
+		...config.not !== void 0 && { not: Object.freeze({ ...config.not }) },
+		...config.description !== void 0 && { description: config.description }
+	};
+	return Object.freeze(result);
+}
+//#endregion
+export { kiciEvent };
+
+//# sourceMappingURL=kici-event.js.map

package/dist/triggers/lifecycle.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Lifecycle trigger helper - creates triggers for cross-workflow lifecycle events.
+ * Returns a frozen LifecycleTriggerConfig directly.
+ */
+import type { LifecycleConfigInput, LifecycleTriggerConfig } from './types.js';
+/**
+ * Create a lifecycle trigger configuration.
+ *
+ * @example
+ * // Trigger on any workflow completion
+ * lifecycle({ events: ['workflow_complete'] })
+ *
+ * // Trigger on job failures from a specific source
+ * lifecycle({ events: ['job_failed'], sources: ['org/deploy-repo'] })
+ *
+ * // Trigger when workflow registrations are updated
+ * lifecycle({ events: ['registration_updated'] })
+ */
+export declare function lifecycle(config: LifecycleConfigInput): LifecycleTriggerConfig;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/triggers/lifecycle.js

@@ -0,0 +1,29 @@
+import "../chunk-gOLHoazu.js";
+//#region src/triggers/lifecycle.ts
+/**
+* Create a lifecycle trigger configuration.
+*
+* @example
+* // Trigger on any workflow completion
+* lifecycle({ events: ['workflow_complete'] })
+*
+* // Trigger on job failures from a specific source
+* lifecycle({ events: ['job_failed'], sources: ['org/deploy-repo'] })
+*
+* // Trigger when workflow registrations are updated
+* lifecycle({ events: ['registration_updated'] })
+*/
+function lifecycle(config) {
+	if (!config.events || config.events.length === 0) throw new Error("lifecycle() requires a non-empty events array");
+	const result = {
+		_tag: "LifecycleTrigger",
+		events: Object.freeze([...config.events]),
+		...config.sources !== void 0 && { sources: Object.freeze([...config.sources]) },
+		...config.description !== void 0 && { description: config.description }
+	};
+	return Object.freeze(result);
+}
+//#endregion
+export { lifecycle };
+
+//# sourceMappingURL=lifecycle.js.map

package/dist/triggers/pr.d.ts

@@ -0,0 +1,27 @@
+/**
+ * PR trigger helper - creates triggers for pull request events.
+ * Returns a frozen PrTriggerConfig directly (no builder pattern).
+ */
+import { type PrConfigInput, type PrTriggerConfig } from './types.js';
+/**
+ * Create a PR trigger configuration.
+ * Returns a frozen (immutable) PrTriggerConfig object directly.
+ *
+ * @example
+ * // No-arg: default events, no branch/path filters
+ * pr()
+ *
+ * // Config style
+ * pr({ target: 'main', paths: ['src/**'] })
+ *
+ * // Full config
+ * pr({
+ *   events: ['opened', 'synchronize'],
+ *   target: ['main', /^release-\d+$/],
+ *   source: 'feature/*',
+ *   paths: ['src/**', '!**\/*.test.ts'],
+ *   description: 'PRs targeting main with source changes',
+ * })
+ */
+export declare function pr(config?: PrConfigInput): PrTriggerConfig;
+//# sourceMappingURL=pr.d.ts.map

package/dist/triggers/pr.js

@@ -0,0 +1,48 @@
+import "../chunk-gOLHoazu.js";
+import { DEFAULT_PR_EVENTS, asArray, toBranchPattern } from "./types.js";
+//#region src/triggers/pr.ts
+/**
+* PR trigger helper - creates triggers for pull request events.
+* Returns a frozen PrTriggerConfig directly (no builder pattern).
+*/
+/**
+* Create a PR trigger configuration.
+* Returns a frozen (immutable) PrTriggerConfig object directly.
+*
+* @example
+* // No-arg: default events, no branch/path filters
+* pr()
+*
+* // Config style
+* pr({ target: 'main', paths: ['src/**'] })
+*
+* // Full config
+* pr({
+*   events: ['opened', 'synchronize'],
+*   target: ['main', /^release-\d+$/],
+*   source: 'feature/*',
+*   paths: ['src/**', '!**\/*.test.ts'],
+*   description: 'PRs targeting main with source changes',
+* })
+*/
+function pr(config) {
+	const events = config?.events ?? [...DEFAULT_PR_EVENTS];
+	const targetBranches = config?.target ? asArray(config.target).map(toBranchPattern) : [];
+	const sourceBranches = config?.source ? asArray(config.source).map(toBranchPattern) : [];
+	const paths = config?.paths ?? [];
+	const repos = config?.repos ? asArray(config.repos).map(toBranchPattern) : [];
+	const result = {
+		_tag: "PrTrigger",
+		events: Object.freeze([...events]),
+		targetBranches: Object.freeze([...targetBranches]),
+		sourceBranches: Object.freeze([...sourceBranches]),
+		paths: Object.freeze([...paths]),
+		repos: Object.freeze([...repos]),
+		...config?.description !== void 0 && { description: config.description }
+	};
+	return Object.freeze(result);
+}
+//#endregion
+export { pr };
+
+//# sourceMappingURL=pr.js.map

package/dist/triggers/push.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Push trigger helper - creates triggers for push events.
+ * Returns a frozen PushTriggerConfig directly (no builder pattern).
+ */
+import { type PushConfigInput, type PushTriggerConfig } from './types.js';
+/**
+ * Create a push trigger configuration.
+ * Returns a frozen (immutable) PushTriggerConfig object directly.
+ *
+ * @example
+ * // No-arg: matches any push
+ * push()
+ *
+ * // Config style
+ * push({ branches: ['main', 'develop'], paths: ['src/**'] })
+ *
+ * // With tags
+ * push({ tags: ['v*'] })
+ *
+ * // Full config
+ * push({
+ *   branches: 'main',
+ *   tags: ['v*', /^release-\d+$/],
+ *   paths: ['src/**', '!**\/*.test.ts'],
+ *   description: 'Pushes to main or version tags',
+ * })
+ */
+export declare function push(config?: PushConfigInput): PushTriggerConfig;
+//# sourceMappingURL=push.d.ts.map

package/dist/triggers/push.js

@@ -0,0 +1,48 @@
+import "../chunk-gOLHoazu.js";
+import { asArray, toBranchPattern } from "./types.js";
+//#region src/triggers/push.ts
+/**
+* Push trigger helper - creates triggers for push events.
+* Returns a frozen PushTriggerConfig directly (no builder pattern).
+*/
+/**
+* Create a push trigger configuration.
+* Returns a frozen (immutable) PushTriggerConfig object directly.
+*
+* @example
+* // No-arg: matches any push
+* push()
+*
+* // Config style
+* push({ branches: ['main', 'develop'], paths: ['src/**'] })
+*
+* // With tags
+* push({ tags: ['v*'] })
+*
+* // Full config
+* push({
+*   branches: 'main',
+*   tags: ['v*', /^release-\d+$/],
+*   paths: ['src/**', '!**\/*.test.ts'],
+*   description: 'Pushes to main or version tags',
+* })
+*/
+function push(config) {
+	const branches = config?.branches ? asArray(config.branches).map(toBranchPattern) : [];
+	const tags = config?.tags ? asArray(config.tags).map(toBranchPattern) : [];
+	const paths = config?.paths ?? [];
+	const repos = config?.repos ? asArray(config.repos).map(toBranchPattern) : [];
+	const result = {
+		_tag: "PushTrigger",
+		branches: Object.freeze([...branches]),
+		tags: Object.freeze([...tags]),
+		paths: Object.freeze([...paths]),
+		repos: Object.freeze([...repos]),
+		...config?.description !== void 0 && { description: config.description }
+	};
+	return Object.freeze(result);
+}
+//#endregion
+export { push };
+
+//# sourceMappingURL=push.js.map

package/dist/triggers/release.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Release trigger helper - creates triggers for release events.
+ * Returns a frozen ReleaseTriggerConfig directly.
+ */
+import type { ReleaseConfigInput, ReleaseTriggerConfig } from './types.js';
+/**
+ * Create a release trigger configuration.
+ *
+ * @example
+ * // Match any release event
+ * release()
+ *
+ * // Match specific actions
+ * release({ actions: ['published'] })
+ */
+export declare function release(config?: ReleaseConfigInput): ReleaseTriggerConfig;
+//# sourceMappingURL=release.d.ts.map

package/dist/triggers/release.js

@@ -0,0 +1,27 @@
+import "../chunk-gOLHoazu.js";
+import { asArray, toBranchPattern } from "./types.js";
+//#region src/triggers/release.ts
+/**
+* Create a release trigger configuration.
+*
+* @example
+* // Match any release event
+* release()
+*
+* // Match specific actions
+* release({ actions: ['published'] })
+*/
+function release(config) {
+	const repos = config?.repos ? asArray(config.repos).map(toBranchPattern) : [];
+	const result = {
+		_tag: "ReleaseTrigger",
+		actions: Object.freeze(config?.actions ? [...config.actions] : []),
+		repos: Object.freeze([...repos]),
+		...config?.description !== void 0 && { description: config.description }
+	};
+	return Object.freeze(result);
+}
+//#endregion
+export { release };
+
+//# sourceMappingURL=release.js.map

package/dist/triggers/review-comment.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Review comment trigger helper - creates triggers for PR review comment events.
+ * Returns a frozen ReviewCommentTriggerConfig directly.
+ */
+import type { ReviewCommentConfigInput, ReviewCommentTriggerConfig } from './types.js';
+/**
+ * Create a pull request review comment trigger configuration.
+ *
+ * @example
+ * // Match any review comment event
+ * reviewComment()
+ *
+ * // Match specific actions
+ * reviewComment({ actions: ['created', 'edited'] })
+ */
+export declare function reviewComment(config?: ReviewCommentConfigInput): ReviewCommentTriggerConfig;
+//# sourceMappingURL=review-comment.d.ts.map

package/dist/triggers/review-comment.js

@@ -0,0 +1,27 @@
+import "../chunk-gOLHoazu.js";
+import { asArray, toBranchPattern } from "./types.js";
+//#region src/triggers/review-comment.ts
+/**
+* Create a pull request review comment trigger configuration.
+*
+* @example
+* // Match any review comment event
+* reviewComment()
+*
+* // Match specific actions
+* reviewComment({ actions: ['created', 'edited'] })
+*/
+function reviewComment(config) {
+	const repos = config?.repos ? asArray(config.repos).map(toBranchPattern) : [];
+	const result = {
+		_tag: "ReviewCommentTrigger",
+		actions: Object.freeze(config?.actions ? [...config.actions] : []),
+		repos: Object.freeze([...repos]),
+		...config?.description !== void 0 && { description: config.description }
+	};
+	return Object.freeze(result);
+}
+//#endregion
+export { reviewComment };
+
+//# sourceMappingURL=review-comment.js.map

package/dist/triggers/review.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Review trigger helper - creates triggers for pull request review events.
+ * Returns a frozen ReviewTriggerConfig directly.
+ */
+import type { ReviewConfigInput, ReviewTriggerConfig } from './types.js';
+/**
+ * Create a pull request review trigger configuration.
+ *
+ * @example
+ * // Match any review event
+ * review()
+ *
+ * // Match specific actions and states
+ * review({ actions: ['submitted'], states: ['approved'] })
+ */
+export declare function review(config?: ReviewConfigInput): ReviewTriggerConfig;
+//# sourceMappingURL=review.d.ts.map

package/dist/triggers/review.js

@@ -0,0 +1,28 @@
+import "../chunk-gOLHoazu.js";
+import { asArray, toBranchPattern } from "./types.js";
+//#region src/triggers/review.ts
+/**
+* Create a pull request review trigger configuration.
+*
+* @example
+* // Match any review event
+* review()
+*
+* // Match specific actions and states
+* review({ actions: ['submitted'], states: ['approved'] })
+*/
+function review(config) {
+	const repos = config?.repos ? asArray(config.repos).map(toBranchPattern) : [];
+	const result = {
+		_tag: "ReviewTrigger",
+		actions: Object.freeze(config?.actions ? [...config.actions] : []),
+		states: Object.freeze(config?.states ? [...config.states] : []),
+		repos: Object.freeze([...repos]),
+		...config?.description !== void 0 && { description: config.description }
+	};
+	return Object.freeze(result);
+}
+//#endregion
+export { review };
+
+//# sourceMappingURL=review.js.map

package/dist/triggers/schedule.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Schedule trigger helper - creates triggers for cron-based workflow execution.
+ * Returns a frozen ScheduleTriggerConfig directly.
+ */
+import type { ScheduleConfigInput, ScheduleTriggerConfig } from './types.js';
+/**
+ * Create a schedule trigger configuration.
+ *
+ * @example
+ * // Run every hour
+ * schedule({ cron: '0 * * * *' })
+ *
+ * // Run daily at midnight UTC
+ * schedule({ cron: '0 0 * * *' })
+ *
+ * // Run weekly on Monday at 9am in a specific timezone
+ * schedule({ cron: '0 9 * * 1', timezone: 'America/New_York' })
+ */
+export declare function schedule(config: ScheduleConfigInput): ScheduleTriggerConfig;
+//# sourceMappingURL=schedule.d.ts.map

package/dist/triggers/schedule.js

@@ -0,0 +1,29 @@
+import "../chunk-gOLHoazu.js";
+//#region src/triggers/schedule.ts
+/**
+* Create a schedule trigger configuration.
+*
+* @example
+* // Run every hour
+* schedule({ cron: '0 * * * *' })
+*
+* // Run daily at midnight UTC
+* schedule({ cron: '0 0 * * *' })
+*
+* // Run weekly on Monday at 9am in a specific timezone
+* schedule({ cron: '0 9 * * 1', timezone: 'America/New_York' })
+*/
+function schedule(config) {
+	if (!config.cron || config.cron.trim() === "") throw new Error("schedule() requires a non-empty cron expression");
+	const result = {
+		_tag: "ScheduleTrigger",
+		cron: config.cron,
+		timezone: config.timezone ?? "UTC",
+		...config.description !== void 0 && { description: config.description }
+	};
+	return Object.freeze(result);
+}
+//#endregion
+export { schedule };
+
+//# sourceMappingURL=schedule.js.map

package/dist/triggers/star.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Star trigger helper - creates triggers for star events.
+ * Returns a frozen StarTriggerConfig directly.
+ */
+import type { StarConfigInput, StarTriggerConfig } from './types.js';
+/**
+ * Create a star trigger configuration.
+ *
+ * @example
+ * // Match any star event
+ * star()
+ *
+ * // Match specific actions
+ * star({ actions: ['created'] })
+ */
+export declare function star(config?: StarConfigInput): StarTriggerConfig;
+//# sourceMappingURL=star.d.ts.map

package/dist/triggers/star.js

@@ -0,0 +1,27 @@
+import "../chunk-gOLHoazu.js";
+import { asArray, toBranchPattern } from "./types.js";
+//#region src/triggers/star.ts
+/**
+* Create a star trigger configuration.
+*
+* @example
+* // Match any star event
+* star()
+*
+* // Match specific actions
+* star({ actions: ['created'] })
+*/
+function star(config) {
+	const repos = config?.repos ? asArray(config.repos).map(toBranchPattern) : [];
+	const result = {
+		_tag: "StarTrigger",
+		actions: Object.freeze(config?.actions ? [...config.actions] : []),
+		repos: Object.freeze([...repos]),
+		...config?.description !== void 0 && { description: config.description }
+	};
+	return Object.freeze(result);
+}
+//#endregion
+export { star };
+
+//# sourceMappingURL=star.js.map

package/dist/triggers/status.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Status trigger helper - creates triggers for commit status events.
+ * Returns a frozen StatusTriggerConfig directly.
+ */
+import type { StatusConfigInput, StatusTriggerConfig } from './types.js';
+/**
+ * Create a commit status trigger configuration.
+ *
+ * @example
+ * // Match any status event
+ * status()
+ *
+ * // Match specific contexts and states
+ * status({ contexts: ['ci/*'], states: ['success'] })
+ */
+export declare function status(config?: StatusConfigInput): StatusTriggerConfig;
+//# sourceMappingURL=status.d.ts.map

package/dist/triggers/status.js

@@ -0,0 +1,28 @@
+import "../chunk-gOLHoazu.js";
+import { asArray, toBranchPattern } from "./types.js";
+//#region src/triggers/status.ts
+/**
+* Create a commit status trigger configuration.
+*
+* @example
+* // Match any status event
+* status()
+*
+* // Match specific contexts and states
+* status({ contexts: ['ci/*'], states: ['success'] })
+*/
+function status(config) {
+	const repos = config?.repos ? asArray(config.repos).map(toBranchPattern) : [];
+	const result = {
+		_tag: "StatusTrigger",
+		contexts: Object.freeze(config?.contexts ? [...config.contexts] : []),
+		states: Object.freeze(config?.states ? [...config.states] : []),
+		repos: Object.freeze([...repos]),
+		...config?.description !== void 0 && { description: config.description }
+	};
+	return Object.freeze(result);
+}
+//#endregion
+export { status };
+
+//# sourceMappingURL=status.js.map

package/dist/triggers/tag.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Tag trigger helper - creates triggers for tag push events.
+ * Returns a frozen TagTriggerConfig directly.
+ */
+import type { TagConfigInput, TagTriggerConfig } from './types.js';
+/**
+ * Create a tag trigger configuration.
+ *
+ * @example
+ * // Match any tag
+ * tag()
+ *
+ * // Match specific patterns
+ * tag({ patterns: ['v*'] })
+ *
+ * // With regex
+ * tag({ patterns: [/^v\d+\.\d+\.\d+$/] })
+ */
+export declare function tag(config?: TagConfigInput): TagTriggerConfig;
+//# sourceMappingURL=tag.d.ts.map

package/dist/triggers/tag.js

@@ -0,0 +1,31 @@
+import "../chunk-gOLHoazu.js";
+import { asArray, toBranchPattern } from "./types.js";
+//#region src/triggers/tag.ts
+/**
+* Create a tag trigger configuration.
+*
+* @example
+* // Match any tag
+* tag()
+*
+* // Match specific patterns
+* tag({ patterns: ['v*'] })
+*
+* // With regex
+* tag({ patterns: [/^v\d+\.\d+\.\d+$/] })
+*/
+function tag(config) {
+	const patterns = config?.patterns ? asArray(config.patterns).map(toBranchPattern) : [];
+	const repos = config?.repos ? asArray(config.repos).map(toBranchPattern) : [];
+	const result = {
+		_tag: "TagTrigger",
+		patterns: Object.freeze([...patterns]),
+		repos: Object.freeze([...repos]),
+		...config?.description !== void 0 && { description: config.description }
+	};
+	return Object.freeze(result);
+}
+//#endregion
+export { tag };
+
+//# sourceMappingURL=tag.js.map