@ace-sdk/core 2.7.1 → 2.9.0

package/dist/types/pattern.js.map

@@ -1 +1 @@
-{"version":3,"file":"pattern.js","sourceRoot":"","sources":["../../src/types/pattern.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA+QH,MAAM,CAAC,MAAM,oBAAoB,GAAkD;IACjF,KAAK,EAAE;QACL,SAAS,EAAE,IAAI;QACf,YAAY,EAAE,GAAG;QACjB,SAAS,EAAE,EAAE;KACd;IACD,MAAM,EAAE;QACN,SAAS,EAAE,IAAI;QACf,YAAY,EAAE,GAAG;QACjB,SAAS,EAAE,EAAE;KACd;IACD,IAAI,EAAE;QACJ,SAAS,EAAE,CAAC,CAAC,EAAG,YAAY;QAC5B,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,GAAG;KACf;CACF,CAAC;AAqGF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAwC;IACvE,QAAQ,EAAE,IAAI;IACd,SAAS,EAAE,IAAI;IACf,YAAY,EAAE,IAAI;IAClB,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;CACX,CAAC"}
+{"version":3,"file":"pattern.js","sourceRoot":"","sources":["../../src/types/pattern.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA+QH,MAAM,CAAC,MAAM,oBAAoB,GAAkD;IACjF,KAAK,EAAE;QACL,SAAS,EAAE,IAAI;QACf,YAAY,EAAE,GAAG;QACjB,SAAS,EAAE,EAAE;KACd;IACD,MAAM,EAAE;QACN,SAAS,EAAE,IAAI;QACf,YAAY,EAAE,GAAG;QACjB,SAAS,EAAE,EAAE;KACd;IACD,IAAI,EAAE;QACJ,SAAS,EAAE,CAAC,CAAC,EAAG,YAAY;QAC5B,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,GAAG;KACf;CACF,CAAC;AA+HF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAwC;IACvE,QAAQ,EAAE,IAAI;IACd,SAAS,EAAE,IAAI;IACf,YAAY,EAAE,IAAI;IAClB,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;CACX,CAAC"}

package/dist/types/subscription.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Subscription Types for ACE SDK
+ *
+ * Types for handling subscription status, usage metrics,
+ * and billing-related error responses from the ACE server.
+ *
+ * @package @ace-sdk/core
+ * @since v2.8.0
+ */
+/**
+ * A single usage metric with current usage and limit
+ */
+export interface UsageMetric {
+    used: number;
+    limit: number;
+}
+/**
+ * Complete usage information parsed from X-ACE-* headers
+ */
+export interface UsageInfo {
+    /** Full plan string, e.g., "individual/free", "team/pro" */
+    plan: string;
+    /** Subscription type: individual or team */
+    subscriptionType: SubscriptionType;
+    /** Plan tier within the subscription type */
+    planTier: PlanTier;
+    /** Account status */
+    status: SubscriptionStatus;
+    /** Per-project pattern limit */
+    patterns: UsageMetric;
+    /** Org-wide pattern limit */
+    patternsTotal: UsageMetric;
+    /** Number of projects */
+    projects: UsageMetric;
+    /** Custom domains (add-on feature) */
+    domains: UsageMetric;
+    /** Playbook templates */
+    templates: UsageMetric;
+    /** API calls (resets on billing cycle) */
+    apiCalls: UsageMetric;
+    /** Traces per day (resets daily at midnight UTC) */
+    tracesToday: UsageMetric;
+    /** Feature availability based on plan */
+    features: {
+        teams: boolean;
+        sharing: boolean;
+        apiAccess: boolean;
+        prioritySupport: boolean;
+    };
+    /** Team info (only present for team subscriptions) */
+    team?: {
+        orgId: string;
+        orgName: string;
+        seatsUsed: number;
+        seatsLimit: number;
+    };
+    /**
+     * Subscription last updated timestamp for cache invalidation
+     * From X-ACE-Subscription-Updated-At header
+     * @since v2.8.0
+     */
+    subscriptionUpdatedAt?: string;
+}
+/**
+ * Available plan tiers
+ */
+export type PlanTier = 'free' | 'basic' | 'pro';
+/**
+ * Subscription types
+ */
+export type SubscriptionType = 'individual' | 'team';
+/**
+ * Subscription status values
+ */
+export type SubscriptionStatus = 'active' | 'trialing' | 'read_only' | 'blocked';
+/**
+ * 429 - Quota exceeded error response
+ */
+export interface QuotaErrorResponse {
+    error: 'quota_exceeded';
+    code: string;
+    message: string;
+    resource: string;
+    current: number;
+    limit: number;
+    upgrade_url: string;
+}
+/**
+ * 403 - Feature not available error response
+ */
+export interface FeatureErrorResponse {
+    error: 'feature_not_available';
+    code: string;
+    feature: string;
+    required_plan: string;
+    upgrade_url: string;
+}
+/**
+ * 402 - Payment required error response (read-only mode)
+ */
+export interface PaymentRequiredResponse {
+    error: 'payment_required';
+    code: string;
+    message: string;
+    days_until_block: number;
+    upgrade_url: string;
+}
+/**
+ * 403 - Account blocked error response
+ */
+export interface AccountBlockedResponse {
+    error: 'account_blocked';
+    code: string;
+    message: string;
+    upgrade_url: string;
+}
+/**
+ * 403 - Insufficient permissions error response
+ */
+export interface PermissionsErrorResponse {
+    error: 'insufficient_permissions';
+    code: string;
+    message: string;
+    required_role: string;
+}
+/**
+ * Union type for all subscription-related error responses
+ */
+export type SubscriptionErrorResponse = QuotaErrorResponse | FeatureErrorResponse | PaymentRequiredResponse | AccountBlockedResponse | PermissionsErrorResponse;
+/**
+ * Check if error response is quota exceeded
+ */
+export declare function isQuotaError(data: unknown): data is QuotaErrorResponse;
+/**
+ * Check if error response is feature not available
+ */
+export declare function isFeatureError(data: unknown): data is FeatureErrorResponse;
+/**
+ * Check if error response is payment required
+ */
+export declare function isPaymentRequiredError(data: unknown): data is PaymentRequiredResponse;
+/**
+ * Check if error response is account blocked
+ */
+export declare function isAccountBlockedError(data: unknown): data is AccountBlockedResponse;
+/**
+ * Check if error response is insufficient permissions
+ */
+export declare function isPermissionsError(data: unknown): data is PermissionsErrorResponse;
+/**
+ * Parse plan string into type and tier
+ * @param plan - Plan string like "individual/free" or "team/pro"
+ */
+export declare function parsePlan(plan: string): {
+    type: SubscriptionType;
+    tier: PlanTier;
+};
+/**
+ * Calculate usage percentage
+ */
+export declare function getUsagePercentage(metric: UsageMetric): number;
+/**
+ * Check if a metric is near limit (>80%)
+ */
+export declare function isNearLimit(metric: UsageMetric, threshold?: number): boolean;
+/**
+ * Check if a metric has exceeded its limit
+ */
+export declare function isOverLimit(metric: UsageMetric): boolean;
+/**
+ * Get feature availability based on plan
+ */
+export declare function getFeatures(type: SubscriptionType, tier: PlanTier): UsageInfo['features'];
+//# sourceMappingURL=subscription.d.ts.map

package/dist/types/subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../src/types/subscription.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IAEb,4CAA4C;IAC5C,gBAAgB,EAAE,gBAAgB,CAAC;IAEnC,6CAA6C;IAC7C,QAAQ,EAAE,QAAQ,CAAC;IAEnB,qBAAqB;IACrB,MAAM,EAAE,kBAAkB,CAAC;IAE3B,gCAAgC;IAChC,QAAQ,EAAE,WAAW,CAAC;IAEtB,6BAA6B;IAC7B,aAAa,EAAE,WAAW,CAAC;IAE3B,yBAAyB;IACzB,QAAQ,EAAE,WAAW,CAAC;IAEtB,sCAAsC;IACtC,OAAO,EAAE,WAAW,CAAC;IAErB,yBAAyB;IACzB,SAAS,EAAE,WAAW,CAAC;IAEvB,0CAA0C;IAC1C,QAAQ,EAAE,WAAW,CAAC;IAEtB,oDAAoD;IACpD,WAAW,EAAE,WAAW,CAAC;IAEzB,yCAAyC;IACzC,QAAQ,EAAE;QACR,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,OAAO,CAAC;QACnB,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;IAEF,sDAAsD;IACtD,IAAI,CAAC,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAMD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,MAAM,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAMjF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,gBAAgB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,uBAAuB,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,iBAAiB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,0BAA0B,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,yBAAyB,GACjC,kBAAkB,GAClB,oBAAoB,GACpB,uBAAuB,GACvB,sBAAsB,GACtB,wBAAwB,CAAC;AAM7B;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,kBAAkB,CAEtE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,oBAAoB,CAE1E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,uBAAuB,CAErF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,sBAAsB,CAEnF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,wBAAwB,CAElF;AAMD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAWlF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAG9D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,SAAK,GAAG,OAAO,CAExE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,CAOzF"}

package/dist/types/subscription.js

@@ -0,0 +1,88 @@
+/**
+ * Subscription Types for ACE SDK
+ *
+ * Types for handling subscription status, usage metrics,
+ * and billing-related error responses from the ACE server.
+ *
+ * @package @ace-sdk/core
+ * @since v2.8.0
+ */
+// =============================================================================
+// Type Guards
+// =============================================================================
+/**
+ * Check if error response is quota exceeded
+ */
+export function isQuotaError(data) {
+    return typeof data === 'object' && data !== null && data.error === 'quota_exceeded';
+}
+/**
+ * Check if error response is feature not available
+ */
+export function isFeatureError(data) {
+    return typeof data === 'object' && data !== null && data.error === 'feature_not_available';
+}
+/**
+ * Check if error response is payment required
+ */
+export function isPaymentRequiredError(data) {
+    return typeof data === 'object' && data !== null && data.error === 'payment_required';
+}
+/**
+ * Check if error response is account blocked
+ */
+export function isAccountBlockedError(data) {
+    return typeof data === 'object' && data !== null && data.error === 'account_blocked';
+}
+/**
+ * Check if error response is insufficient permissions
+ */
+export function isPermissionsError(data) {
+    return typeof data === 'object' && data !== null && data.error === 'insufficient_permissions';
+}
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Parse plan string into type and tier
+ * @param plan - Plan string like "individual/free" or "team/pro"
+ */
+export function parsePlan(plan) {
+    const [type, tier] = plan.split('/');
+    const subscriptionType = type === 'team' ? 'team' : 'individual';
+    const planTier = tier === 'pro' ? 'pro' :
+        tier === 'basic' ? 'basic' : 'free';
+    return { type: subscriptionType, tier: planTier };
+}
+/**
+ * Calculate usage percentage
+ */
+export function getUsagePercentage(metric) {
+    if (metric.limit <= 0)
+        return 0;
+    return Math.min(100, Math.round((metric.used / metric.limit) * 100));
+}
+/**
+ * Check if a metric is near limit (>80%)
+ */
+export function isNearLimit(metric, threshold = 80) {
+    return getUsagePercentage(metric) >= threshold;
+}
+/**
+ * Check if a metric has exceeded its limit
+ */
+export function isOverLimit(metric) {
+    return metric.limit > 0 && metric.used >= metric.limit;
+}
+/**
+ * Get feature availability based on plan
+ */
+export function getFeatures(type, tier) {
+    return {
+        teams: type === 'team',
+        sharing: type === 'team' ? tier !== 'free' : tier === 'pro',
+        apiAccess: tier !== 'free',
+        prioritySupport: tier === 'pro'
+    };
+}
+//# sourceMappingURL=subscription.js.map

package/dist/types/subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.js","sourceRoot":"","sources":["../../src/types/subscription.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmKH,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAa;IACxC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAK,IAAY,CAAC,KAAK,KAAK,gBAAgB,CAAC;AAC/F,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAK,IAAY,CAAC,KAAK,KAAK,uBAAuB,CAAC;AACtG,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAa;IAClD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAK,IAAY,CAAC,KAAK,KAAK,kBAAkB,CAAC;AACjG,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAa;IACjD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAK,IAAY,CAAC,KAAK,KAAK,iBAAiB,CAAC;AAChG,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAK,IAAY,CAAC,KAAK,KAAK,0BAA0B,CAAC;AACzG,CAAC;AAED,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqB,CAAC;IAEzD,MAAM,gBAAgB,GACpB,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC;IAE1C,MAAM,QAAQ,GACZ,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IAEtC,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAmB;IACpD,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAmB,EAAE,SAAS,GAAG,EAAE;IAC7D,OAAO,kBAAkB,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAmB;IAC7C,OAAO,MAAM,CAAC,KAAK,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAsB,EAAE,IAAc;IAChE,OAAO;QACL,KAAK,EAAE,IAAI,KAAK,MAAM;QACtB,OAAO,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK;QAC3D,SAAS,EAAE,IAAI,KAAK,MAAM;QAC1B,eAAe,EAAE,IAAI,KAAK,KAAK;KAChC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ace-sdk/core",
-  "version": "2.7.1",
+  "version": "2.9.0",
   "description": "ACE Core - Shared library for ACE pattern learning (HTTP client, caching, config, types)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",