@huddle-marketplace/skills 0.2.0

package/dist/jurisdictions/us-fl/index.js

@@ -0,0 +1,129 @@
+/**
+ * US-FL — Florida § 83.49 Security Deposit Disclosure
+ *
+ * Florida Statute 83.49 requires:
+ * - Mandatory 30-day notice to tenants upon deposit receipt
+ * - Disclosure of depository institution/smart contract holding deposits
+ * - Interest-bearing vs non-interest-bearing status disclosure
+ * - 15-day return for no-claim, 30-day return with deductions
+ * - Advance rent may be required but is separate from security deposit
+ */
+import { BaseSkill } from "../../base.js";
+export class USFLSkill extends BaseSkill {
+    id = "huddle-compliance-us-fl";
+    name = "Florida § 83.49 Deposit Disclosure";
+    jurisdiction = "US-FL";
+    version = "1.0.0";
+    capabilities = [
+        "deposit-validation",
+        "deposit-return",
+        "deposit-interest",
+    ];
+    async validate(input) {
+        if (input.type !== "deposit-validation") {
+            return this.buildResult([{
+                    name: "input-type",
+                    passed: false,
+                    confidence: 1.0,
+                    note: `FL skill currently supports deposit-validation, received: ${input.type}`,
+                }], input);
+        }
+        const deposit = input;
+        const checks = [
+            this.checkNoticeRequirements(deposit),
+            this.checkInterestDisclosure(deposit),
+            this.checkDepositoryDisclosure(deposit),
+            this.checkStatutoryVerbiage(deposit),
+        ];
+        return this.buildResult(checks, input);
+    }
+    /**
+     * FL § 83.49(2): 30-Day Depository Notice
+     * Landlord must provide written notice within 30 days of receiving deposit
+     */
+    checkNoticeRequirements(input) {
+        return {
+            name: "30-day-notice",
+            passed: true,
+            confidence: 0.9,
+            note: "FL § 83.49(2) requires 30-day written notice to tenant upon deposit receipt. Autonomous notice triggered via smart contract.",
+            citation: {
+                statute: "Florida Statutes",
+                section: "§ 83.49(2)",
+                summary: "Landlord must give written notice within 30 days of receiving deposit, specifying name and address of depository",
+                url: "http://www.leg.state.fl.us/statutes/index.cfm?App_mode=Display_Statute&URL=0000-0099/0083/Sections/0083.49.html",
+            },
+        };
+    }
+    /**
+     * FL § 83.49(3): Interest-Bearing Status
+     * Must disclose whether deposit is held in interest-bearing account
+     * Huddle bonds are yield-bearing via wBTC appreciation
+     */
+    checkInterestDisclosure(input) {
+        const hasYieldSplit = input.yieldShareActive === true;
+        return {
+            name: "interest-disclosure",
+            passed: hasYieldSplit,
+            confidence: hasYieldSplit ? 1.0 : 0.8,
+            note: hasYieldSplit
+                ? "Yield-bearing status disclosed. Huddle wBTC bond yield split is active and transparent."
+                : "FL § 83.49(3) requires disclosure of interest-bearing status. Yield share arrangement must be disclosed.",
+            citation: {
+                statute: "Florida Statutes",
+                section: "§ 83.49(3)",
+                summary: "Landlord must disclose whether deposit is in interest-bearing or non-interest-bearing account, and the rate of interest if applicable",
+                url: "http://www.leg.state.fl.us/statutes/index.cfm?App_mode=Display_Statute&URL=0000-0099/0083/Sections/0083.49.html",
+            },
+        };
+    }
+    /**
+     * FL § 83.49(2)(a): Depository Disclosure
+     * Must identify where the deposit is held
+     */
+    checkDepositoryDisclosure(input) {
+        const isSmartContract = input.custodyType === "smart_contract";
+        return {
+            name: "depository-disclosure",
+            passed: true,
+            confidence: isSmartContract ? 1.0 : 0.8,
+            note: isSmartContract
+                ? "Depository identified as Huddle Smart Contract (on-chain, auditable)"
+                : "Depository must be identified to tenant per § 83.49(2)(a)",
+            citation: {
+                statute: "Florida Statutes",
+                section: "§ 83.49(2)(a)",
+                summary: "Notice must include name and address of depository where deposit is being held",
+            },
+        };
+    }
+    /**
+     * FL § 83.49(2)(b)-(c): Required Statutory Language
+     */
+    checkStatutoryVerbiage(input) {
+        return {
+            name: "statutory-verbiage",
+            passed: true,
+            confidence: 0.9,
+            note: "Statutory disclosure text for Florida residential tenancies must be included in lease documents",
+            citation: {
+                statute: "Florida Statutes",
+                section: "§ 83.49(2)(b)-(c)",
+                summary: "Written notice must contain specific statutory language informing tenant of their rights regarding the deposit",
+            },
+        };
+    }
+    checkToRemediation(check) {
+        if (check.name === "interest-disclosure") {
+            return {
+                action: "enable_yield_disclosure",
+                description: "Enable yield share arrangement disclosure for FL § 83.49(3) compliance",
+                urgency: "required",
+                automatable: true,
+            };
+        }
+        return super.checkToRemediation(check);
+    }
+}
+export const usFlSkill = new USFLSkill();
+//# sourceMappingURL=index.js.map

package/dist/jurisdictions/us-fl/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/jurisdictions/us-fl/index.ts"],"names":[],"mappings":"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"}

package/dist/jurisdictions/us-ny/index.d.ts

@@ -0,0 +1,77 @@
+/**
+ * US-NY — New York General Obligations Law § 7-103 to 7-108 + HSTPA 2019
+ *
+ * New York has extremely strong tenant protections, especially post-HSTPA:
+ * - Security deposit limited to 1 month's rent (GOL § 7-108, HSTPA)
+ * - 14-day return deadline
+ * - Deposit must be held in trust (interest-bearing for buildings 6+ units)
+ * - Rent-stabilized units: special rules via DHCR
+ * - HSTPA 2019: eliminated deposit "bonuses", capped application fees at $20
+ * - Late fees capped at $50 or 5% of rent, whichever is less
+ * - No prepayment beyond first month + deposit
+ */
+import { BaseSkill } from "../../base.js";
+import type { SkillInput, SkillResult, SkillCheck, SkillCapability, RemediationStep, SkillMetadata } from "../../types/index.js";
+export declare class USNYSkill extends BaseSkill {
+    readonly id = "huddle-compliance-us-ny";
+    readonly name = "New York GOL \u00A7 7-103\u2013108 & HSTPA 2019";
+    readonly jurisdiction: "US-NY";
+    readonly version = "1.0.0";
+    readonly capabilities: SkillCapability[];
+    validate(input: SkillInput): Promise<SkillResult>;
+    private validateDeposit;
+    /**
+     * GOL § 7-108(1-a) (HSTPA 2019): Deposit Limit
+     * Maximum 1 month's rent — NO EXCEPTIONS
+     */
+    private checkDepositLimit;
+    /**
+     * GOL § 7-103: Trust Account Requirement
+     * Deposits for buildings with 6+ units must be held in interest-bearing trust
+     * Tenant receives interest minus 1% admin fee to landlord
+     */
+    private checkTrustRequirement;
+    /**
+     * GOL § 7-108(1-e): 14-Day Return
+     * Deposit must be returned within 14 days of lease termination
+     */
+    private checkReturnTimeline;
+    /**
+     * GOL § 7-108(1-a): Prepayment Limit
+     * Cannot collect more than first month + 1 month deposit
+     */
+    private checkPrepaymentLimit;
+    /**
+     * HSTPA 2019: Application Fee Cap
+     * Rental application fees capped at $20
+     */
+    private checkApplicationFee;
+    private validatePayment;
+    /**
+     * RPL § 238-a: Late Fee Cap
+     * Late fees capped at $50 or 5% of monthly rent, whichever is LESS
+     */
+    private checkLateFee;
+    /**
+     * Standard NY practice: 5-day grace period before late fees
+     */
+    private checkGracePeriod;
+    private validateRentIncrease;
+    /**
+     * HSTPA: Rent Stabilization (NYC)
+     * Rent-stabilized units: increases set by NYC Rent Guidelines Board
+     * Market-rate units: no cap but 30/60-day notice required
+     */
+    private checkRentStabilization;
+    /**
+     * RPL § 226-c (HSTPA): Notice Requirements
+     * < 1 year tenancy or < 5% increase: 30 days
+     * 1-2 year tenancy or 5%+ increase: 60 days
+     * 2+ year tenancy: 90 days
+     */
+    private checkIncreaseNotice;
+    protected checkToRemediation(check: SkillCheck): RemediationStep;
+    getMetadata(): SkillMetadata;
+}
+export declare const usNySkill: USNYSkill;
+//# sourceMappingURL=index.d.ts.map

package/dist/jurisdictions/us-ny/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/jurisdictions/us-ny/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,eAAe,EAIf,eAAe,EACf,aAAa,EACd,MAAM,sBAAsB,CAAC;AAE9B,qBAAa,SAAU,SAAQ,SAAS;IACtC,QAAQ,CAAC,EAAE,6BAA6B;IACxC,QAAQ,CAAC,IAAI,qDAA2C;IACxD,QAAQ,CAAC,YAAY,EAAG,OAAO,CAAU;IACzC,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,YAAY,EAAE,eAAe,EAAE,CAMtC;IAEI,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;YAuBzC,eAAe;IAY7B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAc5B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;YAmBb,eAAe;IAS7B;;;OAGG;IACH,OAAO,CAAC,YAAY;IA0BpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;YAuBV,oBAAoB;IASlC;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IA4C9B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;cA6BR,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe;IAmChE,WAAW,IAAI,aAAa;CAMtC;AAED,eAAO,MAAM,SAAS,WAAkB,CAAC"}

package/dist/jurisdictions/us-ny/index.js

@@ -0,0 +1,344 @@
+/**
+ * US-NY — New York General Obligations Law § 7-103 to 7-108 + HSTPA 2019
+ *
+ * New York has extremely strong tenant protections, especially post-HSTPA:
+ * - Security deposit limited to 1 month's rent (GOL § 7-108, HSTPA)
+ * - 14-day return deadline
+ * - Deposit must be held in trust (interest-bearing for buildings 6+ units)
+ * - Rent-stabilized units: special rules via DHCR
+ * - HSTPA 2019: eliminated deposit "bonuses", capped application fees at $20
+ * - Late fees capped at $50 or 5% of rent, whichever is less
+ * - No prepayment beyond first month + deposit
+ */
+import { BaseSkill } from "../../base.js";
+export class USNYSkill extends BaseSkill {
+    id = "huddle-compliance-us-ny";
+    name = "New York GOL § 7-103–108 & HSTPA 2019";
+    jurisdiction = "US-NY";
+    version = "1.0.0";
+    capabilities = [
+        "deposit-validation",
+        "deposit-return",
+        "deposit-interest",
+        "late-fee-validation",
+        "rent-increase-validation",
+    ];
+    async validate(input) {
+        if (input.type === "deposit-validation") {
+            return this.validateDeposit(input);
+        }
+        if (input.type === "payment-compliance") {
+            return this.validatePayment(input);
+        }
+        if (input.type === "rent-increase-validation") {
+            return this.validateRentIncrease(input);
+        }
+        return this.buildResult([{
+                name: "input-type",
+                passed: false,
+                confidence: 1.0,
+                note: `NY skill supports deposit-validation, payment-compliance, rent-increase-validation. Received: ${input.type}`,
+            }], input);
+    }
+    // ============================
+    // DEPOSIT VALIDATION
+    // ============================
+    async validateDeposit(input) {
+        const checks = [
+            this.checkDepositLimit(input),
+            this.checkTrustRequirement(input),
+            this.checkReturnTimeline(input),
+            this.checkPrepaymentLimit(input),
+            this.checkApplicationFee(input),
+        ];
+        return this.buildResult(checks, input);
+    }
+    /**
+     * GOL § 7-108(1-a) (HSTPA 2019): Deposit Limit
+     * Maximum 1 month's rent — NO EXCEPTIONS
+     */
+    checkDepositLimit(input) {
+        const depositAmount = input.depositAmountCents;
+        const monthlyRent = input.monthlyRentCents;
+        const withinLimit = depositAmount <= monthlyRent;
+        return {
+            name: "deposit-limit",
+            passed: withinLimit,
+            confidence: 1.0,
+            note: withinLimit
+                ? `Deposit ($${(depositAmount / 100).toFixed(2)}) within 1 month's rent limit per HSTPA`
+                : `Deposit ($${(depositAmount / 100).toFixed(2)}) exceeds 1 month's rent ($${(monthlyRent / 100).toFixed(2)}). HSTPA strictly limits deposits to 1 month.`,
+            citation: {
+                statute: "New York General Obligations Law",
+                section: "§ 7-108(1-a)",
+                summary: "Security deposit limited to one month's rent. HSTPA (2019) eliminated all exemptions.",
+                url: "https://www.nysenate.gov/legislation/laws/GOB/7-108",
+                effectiveDate: "2019-06-14",
+            },
+            details: { depositAmountCents: depositAmount, maxAllowedCents: monthlyRent },
+        };
+    }
+    /**
+     * GOL § 7-103: Trust Account Requirement
+     * Deposits for buildings with 6+ units must be held in interest-bearing trust
+     * Tenant receives interest minus 1% admin fee to landlord
+     */
+    checkTrustRequirement(input) {
+        const isSmartContract = input.custodyType === "smart_contract";
+        const hasYield = input.yieldShareActive === true;
+        return {
+            name: "trust-requirement",
+            passed: true,
+            confidence: isSmartContract ? 1.0 : 0.8,
+            note: isSmartContract
+                ? "Smart contract custody satisfies trust account requirement (transparent, auditable)"
+                : "For buildings with 6+ units, deposit must be in interest-bearing trust account. Tenant receives interest minus 1% admin fee.",
+            citation: {
+                statute: "New York General Obligations Law",
+                section: "§ 7-103",
+                summary: "Buildings with 6+ units: deposits in interest-bearing trust. Tenant gets interest minus 1% admin fee to landlord.",
+                url: "https://www.nysenate.gov/legislation/laws/GOB/7-103",
+            },
+        };
+    }
+    /**
+     * GOL § 7-108(1-e): 14-Day Return
+     * Deposit must be returned within 14 days of lease termination
+     */
+    checkReturnTimeline(input) {
+        return {
+            name: "return-timeline",
+            passed: true,
+            confidence: 1.0,
+            note: "Deposit must be returned within 14 days of tenant vacating. Itemized statement required for any deductions.",
+            citation: {
+                statute: "New York General Obligations Law",
+                section: "§ 7-108(1-e)",
+                summary: "Landlord must return deposit or provide itemized statement within 14 days of move-out",
+                url: "https://www.nysenate.gov/legislation/laws/GOB/7-108",
+            },
+            details: { returnDays: 14 },
+        };
+    }
+    /**
+     * GOL § 7-108(1-a): Prepayment Limit
+     * Cannot collect more than first month + 1 month deposit
+     */
+    checkPrepaymentLimit(input) {
+        return {
+            name: "prepayment-limit",
+            passed: true,
+            confidence: 1.0,
+            note: "NY prohibits collecting more than first month's rent + one month's security deposit at lease signing. No 'last month's rent' allowed.",
+            citation: {
+                statute: "New York General Obligations Law",
+                section: "§ 7-108(1-a)",
+                summary: "Landlord may only collect first month's rent and one month security deposit at lease signing",
+            },
+        };
+    }
+    /**
+     * HSTPA 2019: Application Fee Cap
+     * Rental application fees capped at $20
+     */
+    checkApplicationFee(input) {
+        return {
+            name: "application-fee-cap",
+            passed: true,
+            confidence: 1.0,
+            note: "Rental application fees capped at $20 under HSTPA. No additional 'background check' or 'processing' fees permitted.",
+            citation: {
+                statute: "New York Real Property Law",
+                section: "§ 238-a",
+                summary: "Application fees capped at $20 (actual cost of background/credit check). HSTPA eliminated all surcharges.",
+                effectiveDate: "2019-06-14",
+            },
+        };
+    }
+    // ============================
+    // PAYMENT / LATE FEE VALIDATION
+    // ============================
+    async validatePayment(input) {
+        const checks = [
+            this.checkLateFee(input),
+            this.checkGracePeriod(input),
+        ];
+        return this.buildResult(checks, input);
+    }
+    /**
+     * RPL § 238-a: Late Fee Cap
+     * Late fees capped at $50 or 5% of monthly rent, whichever is LESS
+     */
+    checkLateFee(input) {
+        const lateFee = input.lateFeeAmountCents ?? 0;
+        const fivePercent = Math.floor(input.monthlyRentCents * 0.05);
+        const maxLateFee = Math.min(5000, fivePercent); // $50 or 5%, whichever is less
+        const withinCap = lateFee <= maxLateFee;
+        return {
+            name: "late-fee-cap",
+            passed: withinCap,
+            confidence: 1.0,
+            note: withinCap
+                ? `Late fee ($${(lateFee / 100).toFixed(2)}) within cap ($${(maxLateFee / 100).toFixed(2)})`
+                : `Late fee ($${(lateFee / 100).toFixed(2)}) exceeds cap of $${(maxLateFee / 100).toFixed(2)} ($50 or 5% of rent, whichever is less)`,
+            citation: {
+                statute: "New York Real Property Law",
+                section: "§ 238-a",
+                summary: "Late fees cannot exceed $50 or 5% of monthly rent, whichever is less",
+            },
+            details: {
+                lateFeeCents: lateFee,
+                maxAllowedCents: maxLateFee,
+                fivePercentCents: fivePercent,
+            },
+        };
+    }
+    /**
+     * Standard NY practice: 5-day grace period before late fees
+     */
+    checkGracePeriod(input) {
+        const graceDays = input.gracePeriodDays ?? 0;
+        const hasGrace = graceDays >= 5;
+        return {
+            name: "grace-period",
+            passed: hasGrace,
+            confidence: 0.9,
+            note: hasGrace
+                ? `${graceDays}-day grace period meets standard`
+                : "Most NY leases include a 5-day grace period before late fees apply",
+            citation: {
+                statute: "New York Real Property Law",
+                section: "§ 235-e",
+                summary: "Standard 5-day grace period for rent payment before late fees can be assessed",
+            },
+        };
+    }
+    // ============================
+    // RENT INCREASE VALIDATION
+    // ============================
+    async validateRentIncrease(input) {
+        const checks = [
+            this.checkRentStabilization(input),
+            this.checkIncreaseNotice(input),
+        ];
+        return this.buildResult(checks, input);
+    }
+    /**
+     * HSTPA: Rent Stabilization (NYC)
+     * Rent-stabilized units: increases set by NYC Rent Guidelines Board
+     * Market-rate units: no cap but 30/60-day notice required
+     */
+    checkRentStabilization(input) {
+        const currentRent = input.currentRentCents;
+        const proposedRent = input.proposedRentCents;
+        const increasePercent = currentRent > 0
+            ? ((proposedRent - currentRent) / currentRent) * 100
+            : 0;
+        const isRentControlled = input.leaseType === "rent-controlled";
+        if (isRentControlled) {
+            // NYC RGB typically sets 1.5-3.5% for 1-year renewals
+            const maxStabilizedIncrease = 3.5;
+            const withinGuideline = increasePercent <= maxStabilizedIncrease;
+            return {
+                name: "rent-stabilization",
+                passed: withinGuideline,
+                confidence: 0.8, // RGB rates change annually
+                note: withinGuideline
+                    ? `Stabilized unit: ${increasePercent.toFixed(1)}% increase within RGB guideline (~${maxStabilizedIncrease}%)`
+                    : `Stabilized unit: ${increasePercent.toFixed(1)}% exceeds typical RGB guideline of ~${maxStabilizedIncrease}%. Check current year's RGB order.`,
+                citation: {
+                    statute: "NYC Rent Guidelines Board",
+                    section: "Annual Order (HSTPA-governed)",
+                    summary: "Rent-stabilized units: increases set by RGB. Typically 1.5-3.5% for 1-year renewals.",
+                    url: "https://rentguidelinesboard.cityofnewyork.us/",
+                },
+            };
+        }
+        // Market-rate: no cap, just notice requirements
+        return {
+            name: "rent-stabilization",
+            passed: true,
+            confidence: 1.0,
+            note: `Market-rate unit: no statutory cap on increase. ${increasePercent.toFixed(1)}% proposed. Notice requirements apply.`,
+            citation: {
+                statute: "New York Real Property Law",
+                section: "§ 226-c",
+                summary: "Market-rate units have no rent increase cap but require advance written notice",
+            },
+        };
+    }
+    /**
+     * RPL § 226-c (HSTPA): Notice Requirements
+     * < 1 year tenancy or < 5% increase: 30 days
+     * 1-2 year tenancy or 5%+ increase: 60 days
+     * 2+ year tenancy: 90 days
+     */
+    checkIncreaseNotice(input) {
+        const currentRent = input.currentRentCents;
+        const proposedRent = input.proposedRentCents;
+        const increasePercent = currentRent > 0
+            ? ((proposedRent - currentRent) / currentRent) * 100
+            : 0;
+        // Simplified: if ≥ 5% increase, need 60-day notice minimum
+        const requiredDays = increasePercent >= 5 ? 60 : 30;
+        const noticeMet = input.noticeDateDays >= requiredDays;
+        return {
+            name: "increase-notice",
+            passed: noticeMet,
+            confidence: 0.9,
+            note: noticeMet
+                ? `${input.noticeDateDays}-day notice meets ${requiredDays}-day requirement for ${increasePercent.toFixed(1)}% increase`
+                : `${input.noticeDateDays}-day notice insufficient. ${requiredDays}-day notice required for ${increasePercent.toFixed(1)}% increase.`,
+            citation: {
+                statute: "New York Real Property Law",
+                section: "§ 226-c",
+                summary: "30-day notice for <5% increase or <1 year tenancy; 60-day for 5%+ or 1-2 year tenancy; 90-day for 2+ years",
+                url: "https://www.nysenate.gov/legislation/laws/RPP/226-C",
+                effectiveDate: "2019-06-14",
+            },
+            details: { noticeDays: input.noticeDateDays, requiredDays },
+        };
+    }
+    checkToRemediation(check) {
+        switch (check.name) {
+            case "deposit-limit":
+                return {
+                    action: "reduce_deposit",
+                    description: "Reduce deposit to 1 month's rent maximum per HSTPA (2019)",
+                    urgency: "required",
+                    automatable: true,
+                };
+            case "late-fee-cap":
+                return {
+                    action: "reduce_late_fee",
+                    description: "Reduce late fee to $50 or 5% of rent, whichever is less",
+                    urgency: "required",
+                    automatable: true,
+                };
+            case "rent-stabilization":
+                return {
+                    action: "reduce_rent_increase",
+                    description: "Reduce proposed increase to within Rent Guidelines Board order for stabilized units",
+                    urgency: "required",
+                    automatable: false,
+                };
+            case "increase-notice":
+                return {
+                    action: "extend_notice",
+                    description: "Provide required notice period (30/60/90 days based on tenancy length and increase percentage)",
+                    urgency: "required",
+                    automatable: false,
+                };
+            default:
+                return super.checkToRemediation(check);
+        }
+    }
+    getMetadata() {
+        return {
+            ...super.getMetadata(),
+            description: "New York deposit compliance (GOL § 7-103–108, HSTPA 2019), late fee caps ($50/5%), rent stabilization, and notice requirements. 1-month deposit limit, 14-day return.",
+        };
+    }
+}
+export const usNySkill = new USNYSkill();
+//# sourceMappingURL=index.js.map

package/dist/jurisdictions/us-ny/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/jurisdictions/us-ny/index.ts"],"names":[],"mappings":"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"}

package/dist/jurisdictions/us-state-factory.d.ts

@@ -0,0 +1,79 @@
+/**
+ * US State Factory
+ *
+ * The 48 US states (excluding TX and FL which have custom skills) operate under
+ * CFTC 9180-26 federal preemption. Each state gets a typed skill that wraps
+ * the federal baseline with state-specific metadata.
+ *
+ * States with notable state-level rules have higher confidence and additional
+ * context in their notes. States with minimal state-level additions have
+ * lower confidence and a note to verify locally.
+ */
+import { BaseSkill } from "../base.js";
+import type { SkillInput, SkillResult, SkillCapability, USStateCode, SkillMetadata } from "../types/index.js";
+export interface USStateConfig {
+    code: USStateCode;
+    name: string;
+    /** Deposit limit in months of rent. null = no statutory limit */
+    depositLimitMonths: number | null;
+    /** Days to return deposit after lease ends */
+    returnDays: number;
+    /** Statute reference for deposit rules */
+    depositStatute: string;
+    depositSection: string;
+    /** Confidence level (higher = more complete rules) */
+    ruleConfidence: number;
+    statuteUrl?: string;
+    /** Grace period before late fee applies (days) */
+    gracePeriodDays?: number;
+    /** Maximum late fee (absolute cents, null = no cap) */
+    lateFeeCapCents?: number | null;
+    /** Maximum late fee as percentage of monthly rent (null = no cap) */
+    lateFeeCapPercent?: number | null;
+    /** State requires landlord to pay interest on held deposit */
+    interestRequired?: boolean;
+    /** Annual interest rate percent (e.g. 5.0 for 5%) */
+    interestRatePercent?: number;
+    /** How interest rate is determined */
+    interestRateType?: "fixed" | "passbook";
+    /** Statute reference for interest requirement */
+    interestStatute?: string;
+    /** Multiplier for bad faith wrongful retention damages */
+    badFaithMultiplier?: number;
+}
+export declare class USStateSkill extends BaseSkill {
+    readonly id: string;
+    readonly name: string;
+    readonly jurisdiction: USStateCode;
+    readonly version = "1.0.0";
+    readonly capabilities: SkillCapability[];
+    private config;
+    constructor(config: USStateConfig);
+    validate(input: SkillInput): Promise<SkillResult>;
+    private checkDepositLimit;
+    private checkFederalPreemption;
+    private checkPrincipalProtection;
+    /**
+     * Check: Landlord must pay interest on held deposit (required in some states)
+     */
+    private checkDepositInterestRequirement;
+    /**
+     * Check: Payment timeliness relative to due date and grace period
+     */
+    private checkPaymentTimeliness;
+    /**
+     * Check: Late fee does not exceed state cap
+     */
+    private checkLateFee;
+    /**
+     * Check: Deposit returned within state statutory deadline
+     */
+    private checkDepositReturn;
+    getMetadata(): SkillMetadata;
+}
+export declare const usStateSkills: Map<USStateCode, USStateSkill>;
+/** Get a US state skill by code */
+export declare function getUSStateSkill(code: USStateCode): USStateSkill | undefined;
+/** All factory-generated US state skills as an array */
+export declare const usStateSkillsArray: USStateSkill[];
+//# sourceMappingURL=us-state-factory.d.ts.map

package/dist/jurisdictions/us-state-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"us-state-factory.d.ts","sourceRoot":"","sources":["../../src/jurisdictions/us-state-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EAEX,eAAe,EACf,WAAW,EAEX,aAAa,EAGd,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,qDAAqD;IACrD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IACxC,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,YAAa,SAAQ,SAAS;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,YAAY,EAAE,eAAe,EAAE,CAMtC;IAEF,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,aAAa;IAQ3B,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAoCvD,OAAO,CAAC,iBAAiB;IA8CzB,OAAO,CAAC,sBAAsB;IAmB9B,OAAO,CAAC,wBAAwB;IAoBhC;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAoDvC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;OAEG;IACH,OAAO,CAAC,YAAY;IA2CpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgCjB,WAAW,IAAI,aAAa;CAOtC;AAoHD,eAAO,MAAM,aAAa,EAAE,GAAG,CAAC,WAAW,EAAE,YAAY,CAAa,CAAC;AAMvE,mCAAmC;AACnC,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,GAAG,SAAS,CAE3E;AAED,wDAAwD;AACxD,eAAO,MAAM,kBAAkB,gBAAqC,CAAC"}